Cmars Telegraf

Learn about configurations >

• apt_repository | string

  Default: deb http://ppa.launchpad.net/telegraf-devs/ppa/ubuntu trusty main

  An apt sources.list line for a repository containing the telegraf package

• apt_repository_key | string

  Default: C94406F5

  GPG key for apt_repository

• collection_jitter | string

  Default: 0s

  Collection jitter is used to jitter the collection by a random amount. Each plugin will sleep for a random time within jitter before collecting. This can be used to avoid many plugins querying things like sysfs at the same time, which can have a measurable effect on the system.

• debug | boolean

  Run telegraf in debug mode

• extra_options | string

  YAML with extra options for out|inputs managed by relations or in the default config. example: inputs: cpu: percpu: false fielddrop: ["time_*"] disk: mount_points: ["/"] ignore_fs: ["tmpfs", "devtmpfs"] elasticsearch: local: false cluster_health: true postgresql: databases: ["foo", "bar"] tagpass: db: ["template", "postgres"] outputs: influxdb: precision: ms

• extra_plugins | string

  Extra plugins, manually configured. This is expected to be a string and will be saved "as is" in /etc/telegraf/telegraf.d/extra_plugins.conf

• flush_interval | string

  Default: 10s

  Default data flushing interval for all outputs. You should not set this below interval. Maximum flush_interval will be flush_interval + flush_jitter

• flush_jitter | string

  Default: 0s

  Jitter the flush interval by a random amount. This is primarily to avoid large write spikes for users running a large number of telegraf instances. ie, a jitter of 5s and interval 10s means flushes will happen every 10-15s

• hostname | string

  Default: UNIT_NAME

  Override default hostname, if empty use os.Hostname() Supports using UNIT_NAME as the value, and the charm will use a sanitized unit name, e.g: service_name-0

• inputs_config | string

  [inputs.xxx] sections as a string, this override default input plugins.

• interval | string

  Default: 10s

  Default data collection interval for all plugins

• metric_buffer_limit | int

  Default: 10000

  Telegraf will cache metric_buffer_limit metrics for each output, and will flush this buffer on a successful write.

• outputs_config | string

  [outputs.xxx] sections as a string

• package_name | string

  Default: telegraf

  Filename of telegraf deb package. If this matches the name of a file in the files charm directory the package will be installed from there, otherwise it will try to install it from the repository provided by apt_repository.

• prometheus_output_port | string

  If set prometheus output plugin will be configured to listen on the provided port. If set to string "default" the charm will use default port (9103)

• quiet | boolean

  Run telegraf in quiet mode

• round_interval | boolean

  Default: True

  Rounds collection interval to 'interval' ie, if interval="10s" then always collect on :00, :10, :20, etc.

• tags | string

  Comma separated list of global tags. ie, 'dc=us-east-1,rack=1a' will tag all metrics with dc=us-east-1 and rack=1a