文档文档

Telegraf

  • Telegraf v1.3.0+

Kapacitor 输入插件

此插件从配置的 InfluxData Kapacitor 实例收集指标。

首次引入: Telegraf v1.3.0 标签: applications 操作系统支持: all

全局配置选项

插件支持其他全局和插件配置设置，用于修改指标、标签和字段，创建别名以及配置插件顺序等任务。更多详情请参阅 CONFIGURATION.md。

配置

# Read Kapacitor-formatted JSON metrics from one or more HTTP endpoints
[[inputs.kapacitor]]
  ## Multiple URLs from which to read Kapacitor-formatted JSON
  ## Default is "https://:9092/kapacitor/v1/debug/vars".
  urls = [
    "https://:9092/kapacitor/v1/debug/vars"
  ]

  ## Time limit for http requests
  timeout = "5s"

  ## 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
  # insecure_skip_verify = false

Metrics

测量和字段

  • kapacitor
    • num_enabled_tasks_
    • num_subscriptions_
    • num_tasks_
  • kapacitor_alert
    • notification_dropped_
    • primary-handle-count_
    • secondary-handle-count kapacitor_cluster_
    • dropped_member_events_
    • dropped_user_events_
    • query_handler_errors_
  • kapacitor_edges
    • collected_
    • emitted_
  • kapacitor_ingress
    • points_received_
  • kapacitor_load
    • errors_
  • kapacitor_memstats
    • alloc_bytes_
    • buck_hash_sys_bytes_
    • frees_
    • gc_sys_bytes_
    • gc_cpu_fraction_
    • heap_alloc_bytes_
    • heap_idle_bytes_
    • heap_in_use_bytes_
    • heap_objects_
    • heap_released_bytes_
    • heap_sys_bytes_
    • last_gc_ns_
    • lookups_
    • mallocs_
    • mcache_in_use_bytes_
    • mcache_sys_bytes_
    • mspan_in_use_bytes_
    • mspan_sys_bytes_
    • next_gc_ns_
    • num_gc_
    • other_sys_bytes_
    • pause_total_ns_
    • stack_in_use_bytes_
    • stack_sys_bytes_
    • sys_bytes_
    • total_alloc_bytes_
  • kapacitor_nodes
    • alerts_inhibited_
    • alerts_triggered_
    • avg_exec_time_ns_
    • crits_triggered_
    • errors_
    • infos_triggered_
    • oks_triggered_
    • points_written_
    • warns_triggered_
    • write_errors_
  • kapacitor_topics
    • collected_

kapacitor

kapacitor 测量存储与 Kapacitor 任务 和 订阅 相关的信息的字段。

num_enabled_tasks

已启用 Kapacitor 任务的数量。

num_subscriptions

Kapacitor/InfluxDB 订阅的数量。

num_tasks

Kapacitor 任务的总数。

kapacitor_alert

kapacitor_alert 测量存储与 Kapacitor 警报 相关的信息的字段。

notification-dropped

由于从另一个 Kapacitor 节点传来太晚而丢弃的内部通知数量。如果此计数正在增加，则表示 Kapacitor Enterprise 节点无法以足够快的速度进行通信来处理警报量。

primary-handle-count

此节点作为主节点处理警报的次数。此计数在正常情况下应会增加。

secondary-handle-count

此节点作为辅助节点处理警报的次数。此计数器的增加表示主节点未能及时处理警报。

kapacitor_cluster

kapacitor_cluster 测量反映了 Kapacitor 节点相互通信 的能力。具体来说，这些指标跟踪 Kapacitor 节点之间的 gossip 通信。

dropped_member_events

已丢弃的 gossip 成员事件数量。

dropped_user_events

已丢弃的 gossip 用户事件数量。

query_handler_errors

事件处理程序产生的错误数量。

kapacitor_edges

kapacitor_edges 测量存储与 Kapacitor TICKscripts 中 边 相关的信息的字段。

collected

TICKscript 边收集的消息数量。

emitted

TICKscript 边发出的消息数量。

kapacitor_ingress

kapacitor_ingress 测量存储与进入 Kapacitor 的数据相关的信息的字段。

points_received

Kapacitor 接收到的数据点数量。

kapacitor_load

kapacitor_load 测量存储与 Kapacitor 加载目录服务 相关的信息的字段。

errors

从加载目录服务报告的错误数量。

kapacitor_memstats

kapacitor_memstats 测量存储与 Kapacitor 内存使用情况相关的字段。

alloc_bytes

Kapacitor 分配但仍在使用中的内存字节数。

buck_hash_sys_bytes

用于分析存储桶哈希表的内存字节数。

frees

已释放的堆对象数量。

gc_sys_bytes

用于垃圾回收系统元数据的内存字节数。

gc_cpu_fraction

自 Kapacitor 启动以来，垃圾回收所占用的 Kapacitor 可用 CPU 时间的比例。

heap_alloc_bytes

垃圾回收尚未释放的、可访问和不可访问的堆对象数量。

heap_idle_bytes

等待使用的堆字节数。

heap_in_use_bytes

正在使用的堆字节数。

heap_objects

已分配对象的数量。

heap_released_bytes

已释放给操作系统的堆字节数。

heap_sys_bytes

从 system 获取的堆字节数。

last_gc_ns

上次垃圾回收的纳秒时间戳。

lookups

指针查找的总次数。

mallocs

mallocs 的总数。

mcache_in_use_bytes

mcache 结构使用的字节数。

mcache_sys_bytes

从 system 获取的 mcache 结构使用的字节数。

mspan_in_use_bytes

mspan 结构使用的字节数。

mspan_sys_bytes

从 system 获取的 mspan 结构使用的字节数。

next_gc_ns

下次垃圾回收的纳秒时间戳。

num_gc

已完成的垃圾回收周期数。

other_sys_bytes

用于其他系统分配的内存字节数。

pause_total_ns

自 Kapacitor 启动以来，在垃圾回收“stop-the-world”暂停期间花费的总纳秒数。

stack_in_use_bytes

堆栈分配器使用的字节数。

stack_sys_bytes

为堆栈分配器从 system 获取的字节数。

sys_bytes

从 system 获取的内存字节数。

total_alloc_bytes

已分配的总字节数，即使已释放。

kapacitor_nodes

kapacitor_nodes 测量存储与 TICKscript 节点 中发生的事件相关的字段。

alerts_inhibited

TICKscripts 抑制的总警报数量。

alerts_triggered

TICKscripts 触发的总警报数量。

avg_exec_time_ns

TICKscripts 的平均执行时间（纳秒）。

crits_triggered

TICKscripts 触发的严重（crit）警报数量。

errors (from TICKscripts)

TICKscripts 引起的错误数量。

infos_triggered

TICKscripts 触发的信息（info）警报数量。

oks_triggered

TICKscripts 触发的正常（ok）警报数量。

points_written

写入 InfluxDB 或 Kapacitor 的数据点数量。

warns_triggered

TICKscripts 触发的警告（warn）警报数量。

working_cardinality

处理过的唯一序列总数。

write_errors

写入 InfluxDB 或其他写入端点时发生的错误数量。

kapacitor_topics

kapacitor_topics 测量存储与 Kapacitor 主题 相关的信息的字段。

collected (kapacitor_topics)

Kapacitor 主题收集的事件数量。

注意: Kapacitor 变量 host、cluster_id 和 server_id 由于可能的高基数，目前未记录。

示例输出

kapacitor_memstats,host=hostname.local,kap_version=1.1.0~rc2,url=https://: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
kapacitor,host=hostname.local,kap_version=1.1.0~rc2,url=https://: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

此页面是否有帮助？

感谢您的反馈！

© 2025 InfluxData, Inc.

您在哪里运行 InfluxDB？

选择您的 **InfluxDB Cloud 区域和集群** 或您的 **InfluxDB OSS URL**，我们将为您定制代码示例。识别您的 InfluxDB Cloud 集群。

  • InfluxDB Cloud
  • InfluxDB OSS 或 Enterprise
AWS

  • 美国西部（俄勒冈州）

GCP
Azure
默认
自定义

有关更多信息，请参阅 InfluxDB Cloud 区域 或 InfluxDB OSS URL。

感谢您的反馈！

让我们知道我们可以做得更好

谢谢！

不用了，谢谢

InfluxDB 3.8 新特性

InfluxDB 3.8 和 InfluxDB 3 Explorer 1.6 的主要增强功能。

查看博客文章

InfluxDB 3.8 现已适用于 Core 和 Enterprise 版本，同时发布了 InfluxDB 3 Explorer UI 的 1.6 版本。本次发布着重于操作成熟度，以及如何更轻松地部署、管理和可靠地运行 InfluxDB。

更多信息，请查看

InfluxDB Docker 的 latest 标签将指向 InfluxDB 3 Core

在 **2026 年 2 月 3 日**，InfluxDB Docker 镜像的 latest 标签将指向 InfluxDB 3 Core。为避免意外升级，请在您的 Docker 部署中使用特定的版本标签。

如果使用 Docker 来安装和运行 InfluxDB，latest 标签将指向 InfluxDB 3 Core。为避免意外升级，请在您的 Docker 部署中使用特定的版本标签。例如，如果使用 Docker 运行 InfluxDB v2，请将 latest 版本标签替换为 Docker pull 命令中的特定版本标签 — 例如

docker pull influxdb:2