Configuration

Configuration

If you've installed diamond via a package, a example configuration file is /etc/diamond/diamond.cfg.example. Please copy this to /etc/diamond/diamond.cfg and configure at will. By default, diamond will push to a graphite server host "graphite". You should probably change this to point to your own graphite server.

Other configuration should not be necessary.

By default diamond publishes metrics using the following form:

systems.<hostname>.<metrics>.<metric>

You can override the "systems" portion of the metric path by changing the "path_prefix" setting in the configuration file.

Collectors that require extra configuration settings will have a configuration file with defaults located in the collectors_path/collector/collector.conf file. To change the settings, please copy this file to collectors_config_path and change. This way, if future changes to the module change or add settings, your overrides will be preserved.

Settings

Every collector has some default options

• enabled - True or False - Run this collector?
• path_prefix - Base path to put all metrics
• path - Path on the tree to place the metrics
• interval - Default Poll Interval (seconds)
• splay - Default splay time (seconds)
• method - Threading model to use, Sequential or Threaded
• byte_unit - List of units to convert bit/byte numeric types to. Defaults to bytes
• hostname - Hardcode an hostname rather then finding one
• hostname_method - Change the method to find the hostname. Valid options are
  • fqdn_short = Default. Similar to hostname -s
  • fqdn_rev = hostname in reverse (com.example.www)
  • uname_short = Similar to uname -n, but only the first part
  • uname_rev = uname -r in reverse (com.example.www)