CloudMon Tags

CloudMon checks and interprets resource tags that are present in VMs deployed within the region being monitored. Depending on the key/value defined by the tag CloudMon can take an specific monitoring action.

More info on resource tags: AWS and CloudStack

CloudMon also provides a blacklist functionality to define with tags are allowed or not. See blacklisted in Configuration.

CloudMon tags are of two types: Default Tags and Custom Tags

Default Tags

Default tags are of 5 types and each tag will represent a different action.

monitoring

  • monitoring tags will indicate if the VM will be monitored by CloudMon (CloudMon will create a corresponding zabbix host to the VM) or not.
  • Accepts value 0 (not active) or 1 (active).
  • Value 0 is interpreted the same way as non existent tag.
  • Removal of one of those tags will delete its corresponding zabbix host.

templates

  • CloudMon will associate zabbix templates to the zabbix host that represents the monitored VM based on the information found at the templates tags.
  • Works only in conjunction with an active monitoring tag.
  • Accepts template names (one or serveral separated by comma) as values.
  • Removal of one of those tags will desassociate the defined templates from the zabbix host.

hostgroups

  • CloudMon will associate zabbix hostgroups to the zabbix host that represents the monitored VM based on the information found at the hostgroups tags.
  • Works only in conjunction with an active monitoring tag.
  • Accepts hostgroup names (one or serveral separated by comma) as values.
  • Removal of one of those tags will desassociate the defined hostgroups from the zabbix host.

macros

  • CloudMon will create zabbix macros in the zabbix host that represents the monitored VM based on the information found at the macros tags.
  • Works only in conjunction with an active monitoring tag.
  • Accepts pairs of key:value, (one or serveral separated by comma) as values.
  • Example of usage: {$MACRO_1}:55, {$MACRO2}:https://cloudmon.readthedocs.io, '{$MACRO3}:hey, a comma'
  • Removal of one of those tags will remove the defined macros from the zabbix host.

zabbix_api

  • CloudMon will do Zabbix API calls defined by this tag.
  • Works only in conjunction with an active monitoring tag.
  • Accepts multiple calls separated by semicolons.
  • Example of usage: host.update({'hostid':'5', 'status':'0'}); host.update({'hostid':'6', 'status':'0'})
  • The API call will be performed instantly by the cloudmon user defined in cloudmon.conf. Removal of one of those tags doesn't do any actions
  • Like the other tags, it's possible to predefine which calls are allowed or not to users with a blacklist. See blacklisted in Configuration.

More details of default tags at cloudstack_tags in Configuration.

Custom Tags

  • Custom tags are user created/defined tags and are defined in the cloudmon configuration files. See custom_tags in Configuration.
  • A custom tag can perform several default tags actions at once as defined in its configuration. For example, with only one custom tag association is possible to create a zabbix host, associate it to predefined hostgroups and templates and create predefined macros.