2017-04-27 18:47:22 +00:00
# Kapacitor Plugin
2020-04-03 01:24:10 +00:00
The Kapacitor plugin collects metrics from the given Kapacitor instances.
2017-04-27 18:47:22 +00:00
### Configuration:
```toml
[[inputs.kapacitor]]
## Multiple URLs from which to read Kapacitor-formatted JSON
## Default is "http://localhost:9092/kapacitor/v1/debug/vars".
urls = [
"http://localhost:9092/kapacitor/v1/debug/vars"
]
## Time limit for http requests
timeout = "5s"
2018-03-23 18:53:18 +00:00
2018-05-04 23:33:23 +00:00
## Optional TLS Config
# tls_ca = "/etc/telegraf/ca.pem"
# tls_cert = "/etc/telegraf/cert.pem"
# tls_key = "/etc/telegraf/key.pem"
## Use TLS but skip chain & host verification
2018-03-23 18:53:18 +00:00
# insecure_skip_verify = false
2017-04-27 18:47:22 +00:00
```
2020-04-03 01:24:10 +00:00
### Measurements and fields
2017-04-27 18:47:22 +00:00
2019-10-24 23:45:59 +00:00
- [kapacitor ](#kapacitor )
- [num_enabled_tasks ](#num_enabled_tasks ) _(integer)_
- [num_subscriptions ](#num_subscriptions ) _(integer)_
- [num_tasks ](#num_tasks ) _(integer)_
2020-04-03 01:24:10 +00:00
- [kapacitor_alert ](#kapacitor_alert )
- [notification_dropped ](#notification_dropped ) _(integer)_
- [primary-handle-count ](#primary-handle-count ) _(integer)_
- [secondary-handle-count ](#secondary-handle-count ) _(integer)_
2020-05-26 19:18:24 +00:00
- (Kapacitor Enterprise only) [kapacitor_cluster ](#kapacitor_cluster ) _(integer)_
2020-04-03 01:24:10 +00:00
- [dropped_member_events ](#dropped_member_events ) _(integer)_
- [dropped_user_events ](#dropped_user_events ) _(integer)_
- [query_handler_errors ](#query_handler_errors ) _(integer)_
2019-10-24 23:45:59 +00:00
- [kapacitor_edges ](#kapacitor_edges )
- [collected ](#collected ) _(integer)_
- [emitted ](#emitted ) _(integer)_
- [kapacitor_ingress ](#kapacitor_ingress )
- [points_received ](#points_received ) _(integer)_
- [kapacitor_load ](#kapacitor_load )
- [errors ](#errors ) _(integer)_
- [kapacitor_memstats ](#kapacitor_memstats )
- [alloc_bytes ](#alloc_bytes ) _(integer)_
- [buck_hash_sys_bytes ](#buck_hash_sys_bytes ) _(integer)_
- [frees ](#frees ) _(integer)_
- [gc_sys_bytes ](#gc_sys_bytes ) _(integer)_
2020-05-26 19:18:24 +00:00
- [gc_cpu_fraction ](#gc_cpu_fraction ) _(float)_
2019-10-24 23:45:59 +00:00
- [heap_alloc_bytes ](#heap_alloc_bytes ) _(integer)_
- [heap_idle_bytes ](#heap_idle_bytes ) _(integer)_
- [heap_in_use_bytes ](#heap_in_use_bytes ) _(integer)_
- [heap_objects ](#heap_objects ) _(integer)_
- [heap_released_bytes ](#heap_released_bytes ) _(integer)_
- [heap_sys_bytes ](#heap_sys_bytes ) _(integer)_
- [last_gc_ns ](#last_gc_ns ) _(integer)_
- [lookups ](#lookups ) _(integer)_
- [mallocs ](#mallocs ) _(integer)_
- [mcache_in_use_bytes ](#mcache_in_use_bytes ) _(integer)_
- [mcache_sys_bytes ](#mcache_sys_bytes ) _(integer)_
- [mspan_in_use_bytes ](#mspan_in_use_bytes ) _(integer)_
- [mspan_sys_bytes ](#mspan_sys_bytes ) _(integer)_
- [next_gc_ns ](#next_gc_ns ) _(integer)_
- [num_gc ](#num_gc ) _(integer)_
- [other_sys_bytes ](#other_sys_bytes ) _(integer)_
- [pause_total_ns ](#pause_total_ns ) _(integer)_
- [stack_in_use_bytes ](#stack_in_use_bytes ) _(integer)_
- [stack_sys_bytes ](#stack_sys_bytes ) _(integer)_
- [sys_bytes ](#sys_bytes ) _(integer)_
- [total_alloc_bytes ](#total_alloc_bytes ) _(integer)_
- [kapacitor_nodes ](#kapacitor_nodes )
- [alerts_inhibited ](#alerts_inhibited ) _(integer)_
- [alerts_triggered ](#alerts_triggered ) _(integer)_
- [avg_exec_time_ns ](#avg_exec_time_ns ) _(integer)_
- [crits_triggered ](#crits_triggered ) _(integer)_
- [errors ](#errors ) _(integer)_
- [infos_triggered ](#infos_triggered ) _(integer)_
- [oks_triggered ](#oks_triggered ) _(integer)_
- [points_written ](#points_written ) _(integer)_
- [warns_triggered ](#warns_triggered ) _(integer)_
- [write_errors ](#write_errors ) _(integer)_
- [kapacitor_topics ](#kapacitor_topics )
- [collected ](#collected ) _(integer)_
---
### kapacitor
The `kapacitor` measurement stores fields with information related to
[Kapacitor tasks ](https://docs.influxdata.com/kapacitor/latest/introduction/getting-started/#kapacitor-tasks )
and [subscriptions ](https://docs.influxdata.com/kapacitor/latest/administration/subscription-management/ ).
#### num_enabled_tasks
The number of enabled Kapacitor tasks.
#### num_subscriptions
The number of Kapacitor/InfluxDB subscriptions.
#### num_tasks
The total number of Kapacitor tasks.
---
2020-04-03 01:24:10 +00:00
### kapacitor_alert
The `kapacitor_alert` measurement stores fields with information related to
[Kapacitor alerts ](https://docs.influxdata.com/kapacitor/v1.5/working/alerts/ ).
#### notification-dropped
2020-05-26 19:18:24 +00:00
The number of internal notifications dropped because they arrive too late from another Kapacitor node.
If this count is increasing, Kapacitor Enterprise nodes aren't able to communicate fast enough
2020-04-03 01:24:10 +00:00
to keep up with the volume of alerts.
#### primary-handle-count
The number of times this node handled an alert as the primary. This count should increase under normal conditions.
#### secondary-handle-count
The number of times this node handled an alert as the secondary. An increase in this counter indicates that the primary is failing to handle alerts in a timely manner.
---
### kapacitor_cluster
The `kapacitor_cluster` measurement reflects the ability of [Kapacitor nodes to communicate ](https://docs.influxdata.com/enterprise_kapacitor/v1.5/administration/configuration/#cluster-communications ) with one another. Specifically, these metrics track the gossip communication between the Kapacitor nodes.
#### dropped_member_events
The number of gossip member events that were dropped.
#### dropped_user_events
The number of gossip user events that were dropped.
---
2019-10-24 23:45:59 +00:00
### kapacitor_edges
The `kapacitor_edges` measurement stores fields with information related to
[edges ](https://docs.influxdata.com/kapacitor/latest/tick/introduction/#pipelines )
in Kapacitor TICKscripts.
#### collected
The number of messages collected by TICKscript edges.
#### emitted
The number of messages emitted by TICKscript edges.
---
### kapacitor_ingress
The `kapacitor_ingress` measurement stores fields with information related to data
coming into Kapacitor.
#### points_received
The number of points received by Kapacitor.
---
### kapacitor_load
The `kapacitor_load` measurement stores fields with information related to the
[Kapacitor Load Directory service ](https://docs.influxdata.com/kapacitor/latest/guides/load_directory/ ).
#### errors
The number of errors reported from the load directory service.
---
### kapacitor_memstats
The `kapacitor_memstats` measurement stores fields related to Kapacitor memory usage.
#### alloc_bytes
The number of bytes of memory allocated by Kapacitor that are still in use.
#### buck_hash_sys_bytes
The number of bytes of memory used by the profiling bucket hash table.
#### frees
The number of heap objects freed.
#### gc_sys_bytes
The number of bytes of memory used for garbage collection system metadata.
2020-04-28 21:41:44 +00:00
#### gc_cpu_fraction
2019-10-24 23:45:59 +00:00
The fraction of Kapacitor's available CPU time used by garbage collection since
Kapacitor started.
#### heap_alloc_bytes
The number of reachable and unreachable heap objects garbage collection has
not freed.
#### heap_idle_bytes
The number of heap bytes waiting to be used.
#### heap_in_use_bytes
The number of heap bytes in use.
#### heap_objects
The number of allocated objects.
#### heap_released_bytes
The number of heap bytes released to the operating system.
#### heap_sys_bytes
2020-05-26 19:18:24 +00:00
The number of heap bytes obtained from `system` .
2019-10-24 23:45:59 +00:00
#### last_gc_ns
The nanosecond epoch time of the last garbage collection.
#### lookups
The total number of pointer lookups.
#### mallocs
The total number of mallocs.
#### mcache_in_use_bytes
The number of bytes in use by mcache structures.
#### mcache_sys_bytes
The number of bytes used for mcache structures obtained from `system` .
#### mspan_in_use_bytes
The number of bytes in use by mspan structures.
#### mspan_sys_bytes
The number of bytes used for mspan structures obtained from `system` .
#### next_gc_ns
The nanosecond epoch time of the next garbage collection.
#### num_gc
The number of completed garbage collection cycles.
#### other_sys_bytes
The number of bytes used for other system allocations.
#### pause_total_ns
The total number of nanoseconds spent in garbage collection "stop-the-world"
pauses since Kapacitor started.
#### stack_in_use_bytes
The number of bytes in use by the stack allocator.
#### stack_sys_bytes
The number of bytes obtained from `system` for stack allocator.
#### sys_bytes
The number of bytes of memory obtained from `system` .
#### total_alloc_bytes
The total number of bytes allocated, even if freed.
---
### kapacitor_nodes
The `kapacitor_nodes` measurement stores fields related to events that occur in
[TICKscript nodes ](https://docs.influxdata.com/kapacitor/latest/nodes/ ).
#### alerts_inhibited
The total number of alerts inhibited by TICKscripts.
#### alerts_triggered
The total number of alerts triggered by TICKscripts.
#### avg_exec_time_ns
The average execution time of TICKscripts in nanoseconds.
#### crits_triggered
The number of critical (`crit`) alerts triggered by TICKscripts.
#### errors
The number of errors caused caused by TICKscripts.
#### infos_triggered
The number of info (`info`) alerts triggered by TICKscripts.
#### oks_triggered
The number of ok (`ok`) alerts triggered by TICKscripts.
#### points_written
The number of points written to InfluxDB or back to Kapacitor.
#### warns_triggered
The number of warning (`warn`) alerts triggered by TICKscripts.
#### working_cardinality
The total number of unique series processed.
#### write_errors
The number of errors that occurred when writing to InfluxDB or other write endpoints.
---
### kapacitor_topics
The `kapacitor_topics` measurement stores fields related to
Kapacitor topics](https://docs.influxdata.com/kapacitor/latest/working/using_alert_topics/).
#### collected
2020-05-26 19:18:24 +00:00
The number of events collected by Kapacitor topics.
2019-10-24 23:45:59 +00:00
---
2017-04-27 18:47:22 +00:00
*Note:* The Kapacitor variables `host` , `cluster_id` , and `server_id`
are currently not recorded due to the potential high cardinality of
these values.
2019-10-24 23:45:59 +00:00
## Example Output
2017-04-27 18:47:22 +00:00
```
2017-05-12 22:22:29 +00:00
$ telegraf --config /etc/telegraf.conf --input-filter kapacitor --test
2017-04-27 18:47:22 +00:00
* Plugin: inputs.kapacitor, Collection 1
2020-04-28 21:41:44 +00:00
> kapacitor_memstats,host=hostname.local,kap_version=1.1.0~rc2,url=http://localhost:9092/kapacitor/v1/debug/vars alloc_bytes=6974808i,buck_hash_sys_bytes=1452609i,frees=207281i,gc_sys_bytes=802816i,gc_cpu_fraction=0.00004693548939673313,heap_alloc_bytes=6974808i,heap_idle_bytes=6742016i,heap_in_use_bytes=9183232i,heap_objects=23216i,heap_released_bytes=0i,heap_sys_bytes=15925248i,last_gc_ns=1478791460012676997i,lookups=88i,mallocs=230497i,mcache_in_use_bytes=9600i,mcache_sys_bytes=16384i,mspan_in_use_bytes=98560i,mspan_sys_bytes=131072i,next_gc_ns=11467528i,num_gc=8i,other_sys_bytes=2236087i,pause_total_ns=2994110i,stack_in_use_bytes=1900544i,stack_sys_bytes=1900544i,sys_bytes=22464760i,total_alloc_bytes=35023600i 1478791462000000000
2017-04-27 18:47:22 +00:00
> kapacitor,host=hostname.local,kap_version=1.1.0~rc2,url=http://localhost:9092/kapacitor/v1/debug/vars num_enabled_tasks=5i,num_subscriptions=5i,num_tasks=5i 1478791462000000000
> kapacitor_edges,child=stream0,host=hostname.local,parent=stream,task=deadman-test,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_ingress,database=_internal,host=hostname.local,measurement=shard,retention_policy=monitor,task_master=main points_received=120 1478791462000000000
> kapacitor_ingress,database=_internal,host=hostname.local,measurement=subscriber,retention_policy=monitor,task_master=main points_received=60 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=http_out,node=http_out3,task=sys-stats,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_edges,child=window6,host=hostname.local,parent=derivative5,task=deadman-test,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=from,node=from1,task=sys-stats,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=stream,node=stream0,task=test,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=window,node=window6,task=deadman-test,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_ingress,database=_internal,host=hostname.local,measurement=cq,retention_policy=monitor,task_master=main points_received=10 1478791462000000000
> kapacitor_edges,child=http_out3,host=hostname.local,parent=window2,task=sys-stats,type=batch collected=0,emitted=0 1478791462000000000
> kapacitor_edges,child=mean4,host=hostname.local,parent=log3,task=deadman-test,type=batch collected=0,emitted=0 1478791462000000000
> kapacitor_ingress,database=_kapacitor,host=hostname.local,measurement=nodes,retention_policy=autogen,task_master=main points_received=207 1478791462000000000
> kapacitor_edges,child=stream0,host=hostname.local,parent=stream,task=sys-stats,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_edges,child=log6,host=hostname.local,parent=sum5,task=derivative-test,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_edges,child=from1,host=hostname.local,parent=stream0,task=sys-stats,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=alert,node=alert2,task=test,type=stream alerts_triggered=0,avg_exec_time_ns=0i,crits_triggered=0,infos_triggered=0,oks_triggered=0,warns_triggered=0 1478791462000000000
> kapacitor_edges,child=log3,host=hostname.local,parent=derivative2,task=derivative-test,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_ingress,database=_kapacitor,host=hostname.local,measurement=runtime,retention_policy=autogen,task_master=main points_received=9 1478791462000000000
> kapacitor_ingress,database=_internal,host=hostname.local,measurement=tsm1_filestore,retention_policy=monitor,task_master=main points_received=120 1478791462000000000
> kapacitor_edges,child=derivative2,host=hostname.local,parent=from1,task=derivative-test,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=stream,node=stream0,task=derivative-test,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_ingress,database=_internal,host=hostname.local,measurement=queryExecutor,retention_policy=monitor,task_master=main points_received=10 1478791462000000000
> kapacitor_ingress,database=_internal,host=hostname.local,measurement=tsm1_wal,retention_policy=monitor,task_master=main points_received=120 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=log,node=log6,task=derivative-test,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_edges,child=stream,host=hostname.local,parent=stats,task=task_master:main,type=stream collected=598,emitted=598 1478791462000000000
> kapacitor_ingress,database=_internal,host=hostname.local,measurement=write,retention_policy=monitor,task_master=main points_received=10 1478791462000000000
> kapacitor_edges,child=stream0,host=hostname.local,parent=stream,task=derivative-test,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=log,node=log3,task=deadman-test,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=from,node=from1,task=deadman-test,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_ingress,database=_kapacitor,host=hostname.local,measurement=ingress,retention_policy=autogen,task_master=main points_received=148 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=eval,node=eval4,task=derivative-test,type=stream avg_exec_time_ns=0i,eval_errors=0 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=derivative,node=derivative2,task=derivative-test,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_ingress,database=_internal,host=hostname.local,measurement=runtime,retention_policy=monitor,task_master=main points_received=10 1478791462000000000
> kapacitor_ingress,database=_internal,host=hostname.local,measurement=httpd,retention_policy=monitor,task_master=main points_received=10 1478791462000000000
> kapacitor_edges,child=sum5,host=hostname.local,parent=eval4,task=derivative-test,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_ingress,database=_kapacitor,host=hostname.local,measurement=kapacitor,retention_policy=autogen,task_master=main points_received=9 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=from,node=from1,task=test,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_ingress,database=_internal,host=hostname.local,measurement=tsm1_engine,retention_policy=monitor,task_master=main points_received=120 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=window,node=window2,task=deadman-test,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=stream,node=stream0,task=deadman-test,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_edges,child=influxdb_out4,host=hostname.local,parent=http_out3,task=sys-stats,type=batch collected=0,emitted=0 1478791462000000000
> kapacitor_edges,child=window2,host=hostname.local,parent=from1,task=deadman-test,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=from,node=from1,task=derivative-test,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_edges,child=from1,host=hostname.local,parent=stream0,task=deadman-test,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_ingress,database=_internal,host=hostname.local,measurement=database,retention_policy=monitor,task_master=main points_received=40 1478791462000000000
> kapacitor_edges,child=stream,host=hostname.local,parent=write_points,task=task_master:main,type=stream collected=750,emitted=750 1478791462000000000
> kapacitor_edges,child=log7,host=hostname.local,parent=window6,task=deadman-test,type=batch collected=0,emitted=0 1478791462000000000
> kapacitor_edges,child=window2,host=hostname.local,parent=from1,task=sys-stats,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=log,node=log7,task=deadman-test,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_ingress,database=_kapacitor,host=hostname.local,measurement=edges,retention_policy=autogen,task_master=main points_received=225 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=derivative,node=derivative5,task=deadman-test,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_edges,child=from1,host=hostname.local,parent=stream0,task=test,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_edges,child=alert2,host=hostname.local,parent=from1,task=test,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=log,node=log3,task=derivative-test,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=influxdb_out,node=influxdb_out4,task=sys-stats,type=stream avg_exec_time_ns=0i,points_written=0,write_errors=0 1478791462000000000
> kapacitor_edges,child=stream0,host=hostname.local,parent=stream,task=test,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_edges,child=log3,host=hostname.local,parent=window2,task=deadman-test,type=batch collected=0,emitted=0 1478791462000000000
> kapacitor_edges,child=derivative5,host=hostname.local,parent=mean4,task=deadman-test,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=stream,node=stream0,task=sys-stats,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=window,node=window2,task=sys-stats,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=mean,node=mean4,task=deadman-test,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_edges,child=from1,host=hostname.local,parent=stream0,task=derivative-test,type=stream collected=0,emitted=0 1478791462000000000
> kapacitor_ingress,database=_internal,host=hostname.local,measurement=tsm1_cache,retention_policy=monitor,task_master=main points_received=120 1478791462000000000
> kapacitor_nodes,host=hostname.local,kind=sum,node=sum5,task=derivative-test,type=stream avg_exec_time_ns=0i 1478791462000000000
> kapacitor_edges,child=eval4,host=hostname.local,parent=log3,task=derivative-test,type=stream collected=0,emitted=0 1478791462000000000
```
