Skip to content

CGraphz Naming Schema

Poil edited this page Jun 3, 2013 · 10 revisions

CGraphz Naming Schema

PluginCategory and TypeCategory

CGraphz use the collectd Naming Schema to generate graphs but also add two optional custom parts : PluginCategory and TypeCategory With these parts the Naming Schema is now :

  • host
  • plugin
  • plugin category (custom optional)
  • plugin instance (optional)
  • type
  • type category (custom optional)
  • type instance (optional)

You can enable or disable in the configuration file (config/config.php) these parts by editing a regular expression

Example (Default for Type Category) :

$CONFIG['plugin_tcategory']='/^(GenericJMX|elasticsearch|P2000)$/';

Example2 (Default for Plugin Category) :

$CONFIG['plugin_pcategory']='/^(GenericJMX|varnish|curl_json|curl|curl_xml|P2000|tcpconns)$/';

CGraphz by default group RRD by Plugin-PluginInstance/Type (Plugin-PluginInstance/Type-TypeCategory for plugin where TypeCategory is setted)

Like that if you have rrds of the same plugin, pluginInstance and type but you don't want to have all of them in a same graph, you can split it by using typeCategory (or pluginCategory but less recommanded)

I used it for custom plugins (ex: ElasticSearch P2000), for GenericJMX, curl and also for tcpconns

Exemple of usage of pluginCategory (see curl_json) : http://web.quakelive.fr/CGraphz/index.php?module=dashboard&component=view&f_id_config_project=1&f_id_config_environment=0&f_id_config_server=6

Libvirt

I like to have my libvirt guest in the same page as my hypervisor, so I'm using this configuration.

<Plugin libvirt>
        Connection "qemu:///system"
        RefreshInterval 60
        HostnameFormat hostname:name
</Plugin>

Exemple of usage of libvirt hypervisor:guest : http://web.quakelive.fr/CGraphz/index.php?module=dashboard&component=view&f_id_config_project=1&f_id_config_environment=0&f_id_config_server=5