This KairosDB plugin takes metrics sent from Telegraf in the InfluxDB Line Protocol format and writes them to KairosDB. The plugin will accept gzipped and non-gzipped data from Telegraf or any other application that writes data to InfluxDB.
Here is a sample configuration for this plugin.
kairosdb.service.telegraf-plugin=org.kairosdb.influxdb.TelegrafModule
kairosdb.service_folder.telegraf-plugin=lib/telegraf
kairosdb.plugin.telegraf.prefix=telegraph.
kairosdb.plugin.telegraf.dropMetrics=^swap.used.*$,^kernel.interrupts$
kairosdb.plugin.telegraf.dropTags=^usage_irq$,^usage_idle$
These optional properties provide ways to manipulate or restrict the data written to KairosDB.
Property | Description |
---|---|
kairosdb.plugin.telegraf.prefix | Prefix prepended to each metric name. |
kairosdb.plugin.telegraf.dropMetrics | This is a comma delimited list of regular expressions. Metric names that match any of the regular expressions are ignored and not added to KairosDB. |
kairosdb.plugin.telegraf.dropTags | This is a comma delimited list of regular expressions. Tag names that match any of the expressions are not included in metrics written to KairosDB. |
The optional prefix property adds the prefix string to the beginning of each metric name.
The plugin writes these metrics to KairosDB:
Metric Name | Tags | Description |
---|---|---|
kairosdb.telegraf.ingest_count | status, host | This is the number of metrics ingested from Telegraf. Status is either "success" or "failed". Host is the name of the KairosDB host that reported the metric. |
kairosdb.telegraf.exception_count | exception, host | This is a count of exceptions when ingesting. The exception tag is the exception name. Host is the name of the KairosDB host that reported the metric. |
kairosdb.telegraf.metrics-dropped.count | host | This is a count of the number of metrics (measurement + field name) dropped (ignored). Host is the name of the KairosDB host that reported the metric. |
kairosdb.telegraf.tags-dropped.count | host | This is a count of the number of tags dropped (ignored). Host is the name of the KairosDB host that reported the metric. |