插件目录
Telegraf 是一个插件驱动的代理,用于收集、处理、聚合和写入指标。它支持四类插件:输入、输出、聚合器和处理器。除了内置插件外,您还可以运行与 Telegraf Execd 处理器插件集成的外部插件。
插件类型
插件类别
操作系统
状态
跳转到
输入插件
Telegraf 输入插件与 InfluxData 时序平台一起使用,用于从系统、服务或第三方 API 收集指标。
AMQP 消费者
AMQP 消费者输入插件提供了一个消费者,用于 AMQP 0-9-1,该协议的一个突出实现是 RabbitMQ。
ActiveMQ
ActiveMQ 输入插件使用 ActiveMQ 控制台 API 收集队列、主题和订阅者指标。
Aerospike
已弃用,推荐使用 Prometheus 插件 和 Aerospike Prometheus Exporter。
Aerospike 输入插件查询 Aerospike 服务器并获取节点统计信息和所有配置的命名空间的统计信息。
阿里云监控服务 (Aliyun)
此插件从阿里云 CMS 拉取指标统计信息。
Amazon CloudWatch 统计数据
Amazon CloudWatch 统计数据输入插件从 Amazon CloudWatch 拉取指标统计信息。
Amazon ECS
Amazon ECS 输入插件(兼容 AWS Fargate)使用 Amazon ECS v2 元数据和统计 API 端点来收集任务中正在运行的容器的统计信息。Telegraf 容器和 Telegraf 正在检查的工作负载必须在同一任务中运行。这类似于 Docker 输入插件(并重用其部分代码),但针对 AWS 元数据和统计格式进行了一些 ECS 特定的修改。
Apache Aurora
Aurora 输入插件从 Apache Aurora 调度器收集指标。有关监控建议,请参阅监控您的 Aurora 集群。
Apache HTTP 服务器
Apache HTTP 服务器输入插件使用 Apache HTTP 服务器的 mod_status
模块收集服务器性能信息。
通常,mod_status
模块配置为在 Apache 服务器的 /server-status?auto
位置公开一个页面。必须启用 ExtendedStatus 选项才能收集所有可用字段。有关如何配置服务器的更多信息,请参阅模块文档。
Apache Kafka 消费者
Apache Kafka 消费者输入插件轮询指定的 Kafka 主题并将消息添加到 InfluxDB。消息应采用行协议格式。Consumer Group 用于与 Kafka 集群通信,因此 Telegraf 的多个实例可以并行地从同一主题读取数据。
Apache Mesos
Apache Mesos 输入插件从 Mesos 收集指标。有关更多信息,请查看 Mesos 可观察性指标 页面。
Apache Solr
Apache Solr 输入插件使用 MBean 请求处理程序收集统计信息。
Apache Tomcat
Apache Tomcat 输入插件从 Apache Tomcat 管理器状态页 (http://<host>/manager/status/all?XML=true
) 收集可用统计信息。使用 XML=true
返回 XML 数据。有关这些统计信息的详细信息,请参阅 Apache Tomcat 文档。
Apache Zipkin
Apache Zipkin 输入插件实现了 Zipkin HTTP 服务器,用于收集微服务架构中排查延迟问题所需的跟踪和定时数据。
此插件为实验性插件。其数据模式可能会根据其主要用例和 OpenTracing 标准的演变而发生变化。
Apache Zookeeper
Apache Zookeeper 输入插件收集从 mntr
命令 Zookeeper Admin 输出的变量。
Apcupsd
Apcupsd 输入插件通过其 NIS 网络协议从 apcupsd 守护进程读取数据。
Arista LANZ 消费者
Arista LANZ 消费者输入插件提供了一个消费者,用于 Arista Networks 的延迟分析器 (LANZ)。指标通过 TCP 从交换机管理 IP 的 50001 端口上的数据流中读取。数据采用 Protobuffers 格式。有关更多信息,请参阅 Arista LANZ。
AWS CloudWatch 指标流
CloudWatch 指标流插件是一个服务输入插件,它侦听通过 HTTP 发送的指标,并对来自 AWS 的指标流执行所需的处理。
Azure Monitor
Azure Monitor 插件从 Azure Monitor API 收集指标。
Azure 存储队列
Azure 存储队列插件收集 Azure 存储队列的大小。
Bcache
Bcache 输入插件从 stats_total 目录和 dirty_data 文件获取 bcache 统计信息。
Beat
Beat 输入插件从给定的 Elastic Beat 实例收集指标。
Beanstalkd
Beanstalkd 输入插件收集服务器统计信息以及 tube 统计信息(分别由 stats 和 stats-tube 命令报告)。
BIND 9 域名服务器统计信息
插件解码 BIND 9 域名服务器提供的 JSON 或 XML 统计信息。
Bond
Bond 输入插件收集网络 bond 接口状态、bond 从接口状态以及 bond 从接口的故障计数。该插件从 /proc/net/bonding/*
文件收集这些指标。
Ceph 存储
Ceph 存储输入插件从 Ceph 存储集群中的 MON 和 OSD 节点收集性能指标。
CGroup
CGroup 输入插件捕获每个 cgroup 的特定统计信息。
Chrony
Chrony 输入插件获取标准 chrony 指标,需要 chronyc 可执行文件。
Cisco GNMI 遥测
inputs.cisco_telemetry_gnmi
插件在 Telegraf 1.15.0 中重命名为inputs.gmni
,以更好地反映其对 gNMI 设备的通用支持。请参阅 gNMI 插件。
Cisco GNMI 遥测输入插件使用类似于 GNMI 规范的遥测数据。这种基于 GRPC 的协议可以利用 TLS 进行身份验证和加密。此插件已开发用于支持 Cisco IOS XR (64 位) 版本 6.5.1 及更高版本生成的 GNMI 遥测数据。
Cisco 模型驱动遥测 (MDT)
Cisco 模型驱动遥测 (MDT) 是一个输入插件,用于使用来自 Cisco IOS XR、IOS XE 和 NX-OS 平台的遥测数据。它支持 TCP 和 GRPC 拨号传输。基于 GRPC 的传输可以利用 TLS 进行身份验证和加密。遥测数据预计将采用 GPB-KV (自描述 gpb) 编码。
ClickHouse
ClickHouse 输入插件从 ClickHouse 服务器收集统计信息,ClickHouse 服务器是一个开源的面向列的数据库管理系统,可让您实时生成分析数据报告。
Conntrack
Conntrack 输入插件从 Netfilter 的 conntrack-tools 收集统计信息。
conntrack-tools 提供了一种机制,用于跟踪网络连接的各个方面,因为它们由 netfilter 处理。在运行时,conntrack 在 /proc/sys/net
中公开了许多连接统计信息。根据您的内核版本,这些文件可以在 /proc/sys/net/ipv4/netfilter
或 /proc/sys/net/netfilter
中找到,并将以 ip_
或 nf_
为前缀。此插件读取其配置中指定的文件,并将每个文件作为字段发布,并将前缀标准化为 ip_
。
Consul
Consul 输入插件将收集有关 Consul 中注册的所有运行状况检查的统计信息。它使用 Consul API 查询数据。它不会报告遥测数据,但如果需要,Consul 已经可以使用 StatsD 协议报告这些统计信息。
Couchbase
Couchbase 输入插件从 Couchbase 读取每个节点和每个桶的指标。
CouchDB
CouchDB 输入插件使用 _stats
端点收集 CouchDB 的指标。
CPU
CPU 输入插件收集有关 CPU 使用率的指标。
CS:GO
CSGO 输入插件从 Counter-Strike: Global Offensive 服务器收集指标。
ctrlX Data Layer
从 ctrlX CORE 设备上运行的通信中间件收集数据
磁盘
磁盘输入插件收集有关按挂载点的磁盘使用情况的指标。
DiskIO
DiskIO 输入插件收集有关按设备的磁盘 IO 的指标。
目录监控
目录监控输入插件监控单个目录并接收放置在该目录中的每个文件。该插件以可配置的时间间隔收集目录中的所有文件,并解析尚未拾取的文件。
DMCache
DMCache 输入插件为 dm-cache 提供基于 dmsetup 的统计信息的本机集合。
Docker
Docker 输入插件使用 Docker Engine API 收集正在运行的 Docker 容器的指标。Docker 插件使用 Official Docker Client 从 Engine API 库文档中收集统计信息。
Docker 日志
Docker 日志输入插件使用 Docker Engine API 从正在运行的 Docker 容器收集日志。该插件使用 Official Docker Client 从 Engine API 收集日志。
此插件仅适用于使用 local 或
json-file
或journald
日志记录驱动程序的容器。
Dovecot
Dovecot 输入插件使用 dovecot Stats 协议收集有关配置域的指标。有关更多信息,请参阅 Dovecot 文档。
Elasticsearch 查询
此 elasticsearch 查询插件查询端点以从存储在 Elasticsearch 集群中的数据获取指标。
Ethtool
Ethtool 插件收集以太网设备统计信息。网络设备和驱动程序决定收集哪些字段。
事件中心消费者
事件中心消费者输入插件提供了一个消费者,用于 Azure 事件中心和 Azure IoT 中心。
Exec
Exec 输入插件将支持的 Telegraf 输入数据格式(行协议、JSON、Graphite、Value、Nagios、Collectd 和 Dropwizard)解析为指标。每个 Telegraf 指标都包含测量名称、标签、字段和时间戳。
Execd
Execd 输入插件将外部程序作为守护进程运行。程序必须在其标准输出上以接受的 Telegraf 输入数据格式 输出指标。配置 signal
以在每个收集间隔向正在运行的守护进程发送信号。程序在标准错误上的输出将镜像到 Telegraf 日志。
Fibaro
Fibaro 输入插件对 Fibaro 控制器 API 进行 HTTP 调用,以收集连接设备的数值。这些值对于开关可以是真 (1
) 或假 (0
),对于调光器可以是百分比,温度等。
文件
文件输入插件每隔一段时间更新文件列表,并使用选定的输入数据格式解析内容。
文件将始终完整读取。如果您希望 tail 或跟踪文件,请使用 Tail 输入插件。
要从以支持的 输入数据格式 之一格式化的多个文件中解析指标,请使用 Multifile 输入插件。
文件计数
Filecount 输入插件报告目录中符合特定条件的文件数量和总大小。
文件状态
Filestat 输入插件收集有关文件存在性、大小和其他统计信息的指标。
Fireboard
Fireboard 输入插件从 Fireboard 温度计收集实时温度数据。要使用此输入插件,请注册使用 Fireboard REST API。
Fluentd
Fluentd 输入插件从 in_monitor 插件提供的插件端点收集 Fluentd 服务器指标。此插件理解 /api/plugin.json
资源提供的数据(不包括 /api/config.json
)。
GitHub
从 GitHub 托管的存储库收集存储库信息。
gNMI
gNMI 插件基于 gNMI Subscribe
方法使用遥测数据。该插件支持 TLS 进行身份验证和加密。此输入插件与供应商无关,并且在任何支持 gNMI 规范的平台上都受支持。
对于 Cisco 设备:gNMI 插件经过优化,可支持 Cisco IOS XR (64 位) 版本 6.5.1、Cisco NX-OS 9.3 和 Cisco IOS XE 16.12 及更高版本生成的 gNMI 遥测数据。
Google Cloud PubSub
Google Cloud PubSub 输入插件从 Google Cloud PubSub 提取指标,并使用支持的 输入数据格式 之一创建指标。
Google Cloud PubSub Push
Google Cloud PubSub Push (cloud_pubsub_push
) 输入插件侦听来自 Google Cloud PubSub 的使用 HTTP POST 请求发送的消息。该插件仅期望消息采用 Google 的 Pub/Sub JSON 格式。该插件的目的是允许 Telegraf 充当 Google Pub/Sub ‘Push’ 服务的端点。Google 的 PubSub 服务仅通过 HTTPS/TLS 发送,因此此插件必须位于有效的代理之后,或者必须配置为使用 TLS。
Google Cloud Storage
Google Cloud Storage 输入插件通过迭代云存储桶上的文件来收集指标。
Graylog
Graylog 输入插件可以从远程 Graylog 服务 URL 收集数据。此插件当前支持两种类型的端点
- 多个 (例如,
http://[graylog-server-ip]:12900/system/metrics/multiple
) - 命名空间 (例如,
http://[graylog-server-ip]:12900/system/metrics/namespace/{namespace}
)
HAproxy
HAproxy 输入插件直接从任何正在运行的 HAproxy 实例收集指标。它可以通过使用 HAproxy 状态页生成的 CSV 或从管理套接字来实现。
Hashicorp Consul Agent
Hashicorp Consul agent 插件从集群的每个 Nomad agent 抓取指标。
Hashicorp Nomad
Nomad 插件从集群的每个 Nomad agent 抓取指标。
Hashicorp Vault
Vault 插件从集群的每个 Nomad agent 抓取指标。
Hddtemp
Hddtemp 输入插件从 hddtemp 守护进程读取数据。
HTTP 监听器
http_listener
输入插件已重命名为 influxdb_listener
。新名称更好地描述了该插件作为 InfluxDB 中继的预期用途。对于通过 HTTP 以任何格式传输指标的通用目的,请改用 http_listener_v2
。
HTTP 监听器 v2
HTTP 监听器 v2 输入插件侦听通过 HTTP 发送的指标。指标可以使用任何支持的 Telegraf 输入数据格式 发送。请注意,以前称为 http_listener
的插件已重命名为 influxdb_listener
。要将 Telegraf 用作 InfluxDB 的代理/中继,我们建议使用 influxdb_listener
。
HTTP 响应
HTTP 响应输入插件收集 HTTP 响应的指标。测量值和字段包括 response_time
、http_response_code
和 result_type
。测量的标签包括 server
和 method
。
Huge Pages
Huge Pages 输入插件收集 Huge pages 测量值。透明 Huge Pages (THP) 是一种 Linux 内存管理系统,它通过使用更大的内存页来减少具有大量内存的机器上 Translation Lookaside Buffer (TLB) 查找的开销。
Icinga 2
Icinga 2 输入插件使用 Icinga 2 API 收集正在运行的服务和主机的状态。
InfiniBand
InfiniBand 输入插件收集系统上所有 InfiniBand 设备和端口的统计信息。计数器存储在 /sys/class/infiniband/<dev>/port/<port>/counters/
中。
InfluxDB v1.x
InfluxDB v1.x 输入插件从公开的 InfluxDB v1.x /debug/vars
端点收集指标。使用 Telegraf 提取这些指标以创建“监视器的监视器”是一种最佳实践,并且可以减少与在生产部署中在 _internal
数据库本地捕获和存储这些指标相关的开销。在此处阅读有关此方法的更多信息。
InfluxDB v2
InfluxDB 2.x 使用 Prometheus Exposition Format 公开其指标 — 没有 InfluxDB v2 输入插件。
要在 localhost 上运行的 InfluxDB 2.x 实例上收集数据,Prometheus 输入插件的配置将是
[[inputs.prometheus]]
## An array of urls to scrape metrics from.
urls = ["https://127.0.0.1:8086/metrics"]
InfluxDB 监听器
InfluxDB 监听器输入插件侦听根据 InfluxDB HTTP API 发送的请求。该插件的目的是允许 Telegraf 充当 InfluxDB HTTP API 的 HTTP /write
端点的代理或路由器。
此插件以前称为
http_listener
。要通过 HTTP 发送通用指标,请改用 HTTP 监听器 v2 输入插件。此插件仅与 InfluxDB 1.x 兼容。
/write
端点支持 precision
查询参数,可以设置为 ns
、u
、ms
、s
、m
、h
。其他参数将被忽略并遵循输出插件配置。
当使用此插件链接 Telegraf 实例时,CREATE DATABASE 请求会收到 200 OK 响应,消息体为 {"results":[]}
,但它们不会被中继。最终将数据提交到 InfluxDB 的 Telegraf 实例的输出配置决定了目标数据库。
InfluxDB v2 监听器
InfluxDB v2 监听器输入插件侦听根据 InfluxDB HTTP API 发送的请求。该插件的目的是允许 Telegraf 充当 InfluxDB HTTP API 的 HTTP /api/v2/write
端点的代理或路由器。
/api/v2/write
端点支持 precision
查询参数,可以设置为 ns
、u
、ms
或 s
。其他参数将被忽略并遵循输出插件配置。
Intel Baseband
从提供无线基带硬件加速的专用和集成 Intel 设备收集指标
Intel DLB
Intel DLB 输入插件使用遥测 v2 接口从 DPDK 读取指标。
Intel PMT
Intel 平台监控技术插件公开了通过 Intel PMT 内核空间提供的 Intel PMT 指标。
Intel PMU
Intel PMU 输入插件公开了通过 Linux Perf 子系统提供的 Intel PMU(性能监控单元)指标。
Intel Powerstat
Intel Powerstat 输入插件收集 Intel Powerstat 的监控功能提供的信息。
Intel 数据平面开发套件 (DPDK)
DPDK 插件收集由使用数据平面开发套件构建的应用程序公开的指标,数据平面开发套件是一组广泛的开源库,旨在加速数据包处理工作负载。
Intel RDT
Intel RDT 输入插件收集 Intel 资源导向技术 (RDT) 的监控功能提供的信息。
互联网速度监控器
互联网速度监控器插件收集有关系统互联网速度的数据。
中断
中断输入插件收集有关 IRQ 的指标,包括中断(来自 /proc/interrupts)和软中断(来自 /proc/softirqs)。
IPMI 传感器
IPMI 传感器输入插件使用 ipmitool 实用程序查询本地计算机或远程主机传感器统计信息。
Ipset
Ipset 输入插件从 Linux ipset 收集数据包和字节计数器。它使用命令 ipset save 的输出。忽略不使用 counters 选项创建的 Ipsets。
IPtables
IPtables 输入插件从 Linux iptables 防火墙收集一组表和链中规则的数据包和字节计数器。
IPVS
IPVS 输入插件使用 Linux 内核 netlink 套接字接口来收集有关 IPVS 虚拟服务器和真实服务器的指标。
Jenkins
Jenkins 输入插件收集有关在 Jenkins 实例中运行的节点和作业的信息。
此插件不需要 Jenkins 上的插件,它利用 Jenkins API 来检索所需的所有信息。
Jolokia2 Proxy
Jolokia2 Proxy 输入插件通过与 Jolokia 代理 REST 端点交互,使用 Jolokia JSON-over-HTTP 协议,从一个或多个目标读取 JMX 指标。
JTI OpenConfig 遥测
JTI OpenConfig 遥测输入插件使用 Junos 遥测接口从列出的传感器读取瞻博网络 OpenConfig 遥测数据的实现。有关 OpenConfig 的更多详细信息,请参阅 openconfig.net,有关 Junos 遥测接口 (JTI) 的更多详细信息,请参阅 Junos 遥测接口 (JTI)。
Kapacitor
Kapacitor 输入插件将从给定的 Kapacitor 实例收集指标。
内核
内核输入插件从 /proc/stat
收集内核统计信息。
内核 VMStat
内核 VMStat 输入插件从 /proc/vmstat
收集内核统计信息。
Kibana
Kibana 输入插件查询 Kibana 状态 API 以获取 Kibana 的健康状态和一些有用的指标。
KNX
KNX 输入插件监听 KNX (Konnex) 家庭自动化总线上的消息。
Kubernetes
Kubernetes 输入插件是实验性的,对于中型到大型 Kubernetes 部署可能会导致高基数问题。
Kubernetes 输入插件使用 /stats/summary
端点与 kubelet API 通信,以收集有关单个主机上运行的 Pod 和容器的指标。假设此插件作为 Kubernetes 安装中的守护程序集的一部分运行。这意味着 Telegraf 在集群中的每个节点上运行。因此,您应该配置此插件以与其本地运行的 kubelet 通信。
Kubernetes 清单
Kubernetes 清单输入插件生成从以下 Kubernetes 资源状态派生的指标
- 守护程序集
- 部署
- 节点
- 持久卷
- 持久卷声明
- Pod(容器)
- 有状态集
LDAP
此插件从 LDAP 服务器的监控 (cn=Monitor) 后端收集指标。
Libvirt
Libvirt 插件使用虚拟化 libvirt API 从虚拟化客户机收集统计信息。
Linux CPU
Linux CPU 输入插件收集在基于 Linux 的系统上公开的 CPU 指标。
逻辑卷管理器
逻辑卷管理器收集有关 Linux 中物理卷、卷组和逻辑卷的信息。
Logparser
Logparser 输入插件流式传输并解析给定的日志文件。目前,它具有解析来自日志文件的“grok”模式的能力,该模式也支持正则表达式 (regex) 模式。
Logstash
Logstash 输入插件读取 Logstash 监控 API 公开的指标。该插件支持 Logstash 5 及更高版本。
Lustre2
Lustre Jobstats 允许使用值(例如作业的 ID)标记 RPC。这允许按作业统计。Lustre2 输入插件收集统计信息,并使用 jobid
标记数据。
Mailchimp
Mailchimp 输入插件从 /3.0/reports
MailChimp API 收集指标。
MarkLogic
MarkLogic 输入插件从一个或多个 MarkLogic 主机收集健康状态指标。
Mcrouter
Mcrouter 输入插件从 mcrouter 实例收集统计数据。Mcrouter 是一个 memcached 协议路由器,由 Facebook 开发和维护,用于扩展 memcached (https://memcached.org.cn/) 部署。它是 Facebook 和 Instagram 缓存基础设施的核心组件,mcrouter 在峰值时每秒处理近 50 亿个请求。
Mdstat
mdstat 插件通过读取 /proc/mdstat 收集有关主机上配置的任何 Linux MD RAID 阵列的统计信息。
Mem
Mem 输入插件收集系统内存指标。有关已用 RAM 和实际已用 RAM 之间差异的更完整解释,请参阅 Linux ate my ram。
Memcached
Memcached 输入插件从 Memcached 服务器收集统计数据。
Microsoft SQL Server
Microsoft SQL Server 输入插件为您的 Microsoft SQL Server 实例提供指标。它目前适用于 SQL Server 2008+ 版本。记录的指标是轻量级的,并使用 SQL Server 提供的动态管理视图。
Minecraft
Minecraft 输入插件使用 RCON 协议从 Minecraft 服务器上的记分板收集统计信息。
Mock
mock 输入插件根据不同算法的选择生成随机数据。
Modbus
Modbus 输入插件通过 Modbus TCP 或 Modbus RTU/ASCII 收集 discrete_inputs
、coils
、input_registers
和 holding_registers
。
MongoDB
MongoDB 输入插件收集 serverStatus
和更多公开的 MongoDB 统计信息,并创建一个包含值的单一度量。
Monit
Monit 输入插件收集 Monit 管理和监视的本地进程、远程主机、文件、文件系统、目录和网络接口的指标和状态信息。要使用此插件,请在 Monit 中启用 HTTPD TCP 端口。
MQTT Consumer
MQTT Consumer 输入插件从指定的 MQTT 主题读取并将消息添加到 InfluxDB。消息采用 Telegraf 输入数据格式。
Multifile
Multifile 输入插件允许 Telegraf 将来自多个文件的数据组合成单个指标,为每个文件创建一个字段或标签。这通常对于从 /sys
或 /proc
文件系统创建自定义指标很有用。
MySQL
MySQL 输入插件收集来自 MySQL、MariaDB 和 Percona 服务器的统计数据。
NATS Consumer
NATS Consumer 输入插件从指定的 NATS 主题读取并将消息添加到 InfluxDB。消息应采用 Telegraf 输入数据格式。订阅主题时使用队列组,以便 Telegraf 的多个实例可以并行从 NATS 集群读取。
NATS 服务器监控
NATS 服务器监控输入插件在使用 NATS 服务器监控服务器 时收集指标。
Neptune Apex
Neptune Apex 输入插件从 Apex status.xml
页面收集实时数据。Neptune Apex 控制器系列允许水族爱好者根据各种探头监控和控制他们的水箱。数据直接从 /cgi-bin/status.xml
中以 telegraf.conf
配置文件中指定的间隔获取。
Net
Net 输入插件收集有关网络接口使用情况的指标(仅限 Linux)。
Netflow
Netflow 输入插件从 Netflow v5、Netflow v9 和 IPFIX 收集器收集指标。
Netstat
Netstat 输入插件使用 lsof
收集 TCP 指标,例如已建立连接数、TIME_WAIT 连接数和套接字计数。
网络响应
网络响应输入插件测试 UDP 和 TCP 连接响应时间。它还可以检查响应文本。
NFS
NFS 输入插件从 NFS 客户端收集每个挂载统计信息 (/proc/self/mountstats
)。默认情况下,该插件仅收集有限数量的通用系统级指标。
NGINX
NGINX 输入插件读取 NGINX 基本状态信息 (ngx_http_stub_status_module
)。
NGINX VTS
NGINX VTS 输入插件使用外部虚拟主机流量状态模块收集 NGINX 状态 - https://github.com/vozlt/nginx-module-vts。这是一个 NGINX 模块,提供对虚拟主机状态信息的访问。它包含当前状态,例如服务器、上游、缓存。这类似于 NGINX Plus 的实时活动监控。有关模块配置详细信息,请参阅 NGINX VTS 模块文档。
NGINX Plus
NGINX Plus 输入插件适用于 NGINX Plus,即开源 Web 服务器 NGINX 的商业版本。要使用此插件,您需要许可证。有关更多信息,请参阅 开源 NGINX 和 NGINX Plus 之间有什么区别?。
NGINX Plus 的结构是基于 状态模块文档 的历史构建的。
NGINX Plus API
NGINX Plus API 输入插件收集 NGINX Plus 服务器的高级状态信息。
NGINX Stream STS
NGINX Plus API 输入插件使用外部虚拟主机流量状态收集 NGINX 状态。
NGINX Upstream Check
NGINX Upstream Check 输入插件读取 nginx_upstream_check 的状态输出。此模块可以定期使用配置的请求和间隔检查 NGINX 上游服务器,以确定服务器是否仍然可用。如果检查失败,则服务器将被标记为 down
,并且在检查通过且服务器再次被标记为 up
之前,将不会收到任何请求。
状态页面显示所有上游和服务器的当前状态,以及失败和成功检查的次数。此信息可以以 JSON 格式导出,并由此输入插件解析。
NSQ
NSQ 输入插件从 NSQD API 端点收集指标。
NSQ Consumer
NSQ Consumer 输入插件轮询指定的 NSQD 主题并将消息添加到 InfluxDB。此插件允许消息采用任何支持的 data_format 类型。
Nstat
Nstat 输入插件从 /proc/net/netstat
、/proc/net/snmp
和 /proc/net/snmp6
文件收集网络指标。
NTPq
NTPq 输入插件获取标准 NTP 查询指标,需要 ntpq 可执行文件。
NVIDIA SMI
NVIDIA SMI 输入插件使用对 NVIDIA 系统管理接口 (nvidia-smi
) 二进制文件的查询来拉取 GPU 统计信息,包括内存和 GPU 使用率、温度等。
OPC UA
OPC UA 插件使用 OPC 基金会的统一架构 (UA) 机器对机器通信协议(用于工业自动化)从客户端设备收集指标。
OPC UA Listener
OPC UA 插件从 OPC UA 设备的订阅收集指标。
OpenSearch Query
从 OpenSearch 查询端点收集指标。
OpenLDAP
OpenLDAP 输入插件从 OpenLDAP 的 cn=Monitor
后端收集指标。
OpenNTPD
OpenNTPD 输入插件使用 ntpctl
命令从 OpenNTPD 收集标准网络时间协议 (NTP) 查询指标。
OpenStack
OpenStack 输入插件收集 OpenStack 服务 的指标。
OpenTelemetry
通过 gRPC 从 OpenTelemetry 客户端和代理接收跟踪、指标和日志。
OpenWeatherMap
从 OpenWeatherMap 收集当前天气和预报数据。
P4 Runtime
通过 gRPC 从 P4 可编程管道收集指标。
PF
PF 输入插件从 FreeBSD/OpenBSD pf 防火墙收集信息。目前,它可以检索有关状态表的信息:表中的当前条目数,以及表中搜索、插入和删除的计数器。pf 插件通过调用 pfstat
命令检索此信息。
PgBouncer
PgBouncer 输入插件为您的 PgBouncer 负载均衡器提供指标。有关指标的信息,请参阅 PgBouncer 文档。
Phusion Passenger
Phusion Passenger 输入插件使用其命令行实用程序 passenger-status
获取 Phusion Passenger 统计信息。
PHP-FPM
PHP-FPM 输入插件使用 HTTP 状态页面或 fpm 套接字获取 phpfpm 统计信息。
Ping
Ping 输入插件测量 ping 命令的往返时间、响应时间和其它数据包统计信息。
Postfix
Postfix 输入插件报告有关 postfix 队列的指标。对于 active、hold、incoming、maildrop 和 deferred 队列 中的每个队列,它将报告队列长度(项目数)、大小(项目使用的字节数)和年龄(最旧项目的年龄,以秒为单位)。
PostgreSQL
PostgreSQL 输入插件为您的 PostgreSQL 数据库提供指标。它目前适用于 PostgreSQL 8.1+ 版本。它使用来自内置 pg_stat_database
和 pg_stat_bgwriter
视图的数据。记录的指标取决于您的 PostgreSQL 版本。
PostgreSQL Extensible
此 PostgreSQL Extensible 输入插件为您的 Postgres 数据库提供指标。它旨在解析 telegraf.conf
文件插件部分中的 SQL 查询。
PowerDNS
PowerDNS 输入插件使用 UNIX 套接字收集有关 PowerDNS 的指标。
PowerDNS Recursor
PowerDNS Recursor 输入插件使用 UNIX 套接字收集有关 PowerDNS Recursor 的指标。
Processes
Processes 输入插件收集有关进程总数的信息,并按状态(僵尸、睡眠、运行等)对它们进行分组。在 Linux 上,此插件需要访问 procfs
(/proc
);在其他操作系统上,它需要访问执行 ps
。
Procstat
Procstat 输入插件使用各个进程的 /proc
数据来监控系统资源使用情况。
可以通过 pid
文件、可执行文件名、命令行模式匹配、用户名、systemd 单元名称或 cgroup 名称/路径(按此优先级顺序)指定进程。当提供可执行文件名以获取 pid
时,此插件使用 pgrep
。Procstat 插件传输每个指定进程的 IO、内存、CPU、文件描述符相关测量值。可以设置前缀以隔离各个进程的特定测量值。
Procstat 输入插件将根据进程在配置中的指定方式标记进程。如果使用 pid 文件,则将生成“pidfile”标签。另一方面,如果使用可执行文件,则将生成“exe”标签。
Prometheus Format
Prometheus Format 输入插件从以 Prometheus 格式公开指标的 HTTP 服务器收集指标。
Proxmox
Proxmox 插件使用 Proxmox API 收集有关容器和 VM 的指标。
Puppet Agent
Puppet Agent 输入插件收集通常位于 /var/lib/puppet/state/
Puppet Agent Runs 中的 last_run_summary.yaml
文件输出的变量。有关更多信息,请参阅 Puppet 监控:如何监控 Puppet 运行的成功或失败
Radius
从 Radius 收集身份验证响应时间指标。
Raindrops Middleware
Raindrops Middleware 输入插件从指定的 Raindrops 中间件 URI 读取并将统计信息添加到 InfluxDB。
Redfish
Redfish 输入插件收集启用 DMTF 的 Redfish 的硬件服务器的指标和状态信息。
Redis
Redis 输入插件收集 INFO Redis 命令的结果。有两个单独的度量:redis
和 redis_keyspace
,后者用于收集与数据库相关的统计信息。
此外,该插件还计算命中/未命中率 (keyspace_hitrate
) 和自上次 RDB 保存以来的经过时间 (rdb_last_save_time_elapsed
)。
Redis sentinel
用于 Redis Sentinel 的插件,用于监控正在监控多个 Redis 服务器和副本的多个 Sentinel 实例。
RethinkDB
RethinkDB 输入插件适用于需要用户名、密码授权和 Handshake 协议 v1.0 的 RethinkDB 2.3.5+ 数据库。
Riak
Riak 输入插件从一个或多个 Riak 实例收集指标。
Riemann Listener
Riemann Listener 输入插件使用 Riemann-Protobuff 格式监听来自 Riemann 客户端的消息。
AMD ROCm 系统管理接口 (SMI)
AMD ROCm 系统管理接口插件从 AMD GPU 拉取统计信息,包括内存、使用率和温度。
Salesforce
Salesforce 输入插件收集有关您的 Salesforce 组织中的限制和剩余使用量的指标。它从 Salesforce REST API 的限制端点获取其数据。
Sensors
Sensors 输入插件使用来自 lm-sensor
包的 sensors 可执行文件收集传感器指标。
Siemens S7 Comm
此插件从 Siemens PLC(可编程逻辑控制器)收集信息。
Slab
此插件收集有关 Slab 缓存中每个条目消耗多少内存的详细信息。
SLURM
此插件通过利用 slurmrestd 守护程序提供的 SLURM REST API 收集诊断、作业、节点、分区和预留指标
S.M.A.R.T.
SMART 输入插件使用命令行实用程序 smartctl
获取用于 SMART(自我监控、分析和报告技术)存储设备的指标。SMART 是计算机硬盘驱动器 (HDD) 和固态驱动器 (SSD) 中包含的监控系统,其中包括大多数现代 ATA/SATA、SCSI/SAS 和 NVMe 磁盘。该插件检测并报告驱动器可靠性的各种指标,旨在实现对硬件故障的预测。请参阅 smartmontools。
smartctl
SMART 输入插件使用命令行实用程序 smartctl
获取用于 SMART(自我监控、分析和报告技术)存储设备的指标。此插件解析并使用来自 smartctl
的 JSON 输出。这仅在工具的较新版本中可用。
SNMP
SNMP 输入插件从 SNMP 代理收集指标。
SNMP Trap
SNMP Trap 插件接收 SNMP 通知(陷阱和信息请求)。通知通过 UDP 在可配置端口上接收。使用系统 MIB 文件将 OID 解析为字符串(就像 SNMP 输入插件 一样)。
Socket Listener
Socket Listener 输入插件监听来自流式传输(TCP、UNIX)或数据报(UDP、unixgram)协议的消息。消息应采用 Telegraf 输入数据格式。
Socketstat
Socketstat 输入插件从已建立的套接字连接收集指标。
SQL
SQL 插件从各种 SQL 数据库读取和摄取 SQL 数据到 InfluxDB 中。
StatsD
StatsD 输入插件是一种特殊类型的插件,它在 Telegraf 运行时运行后台 statsd
监听器服务。StatsD 消息的格式如原始 etsy statsd 实现中所述。
Supervisor
supervisor 输入插件使用 XML-RPC API 收集有关在 supervisor 下运行的进程的信息。
Suricata
Suricata 输入插件报告 Suricata IDS/IPS 引擎的内部性能计数器,例如捕获的流量、内存使用率、正常运行时间、流计数器等。它为 Suricata 日志输出提供一个套接字,以将 JSON 输出写入并处理传入数据以适应 Telegraf 的格式。
Synproxy
Synproxy 插件收集 synproxy 指标。Synproxy 是用于 SYN 攻击缓解的 Linux netfilter 模块。
System
System 输入插件收集有关系统负载、正常运行时间和已登录用户数的一般统计信息。它基本上等同于 UNIX uptime
命令。
Systemd Units
Systemd Units 插件在 Linux 上收集 systemd 单元状态指标。它依赖于 systemctl list-units --all --type=service
来收集有关服务状态的数据。
结果使用单元名称标记,并为 loaded、active 和 running 字段提供枚举字段,指示单元健康状况。
此插件也可以收集其他单元类型。有关可能的选项,请参阅 systemctl list-units --all --type help
。
此插件与 Windows Services 输入插件 相关,后者在 Windows 上实现相同目的。
Tacacs
Tacacs 插件收集成功的 tacacs 身份验证响应时间。
Tail
Tail 输入插件“tail”日志文件并解析每条日志消息。
Teamspeak 3
Teamspeak 3 输入插件使用 Teamspeak 服务器的 Teamspeak 3 ServerQuery 接口来收集一个或多个虚拟服务器的统计信息。
Telegraf v1.x
Telegraf v1.x 输入插件收集关于 Telegraf v1.x 代理自身的指标。请注意,某些指标是跨一种插件类型的所有实例的聚合。
Temp
Temp 输入插件从传感器收集温度数据。
Tengine Web 服务器
Tengine Web 服务器输入插件使用 Tengine Web Server 的 Reqstat 模块 收集状态指标。
Trig
Trig 输入插件插入正弦波和余弦波以用于演示目的。
Twemproxy
Twemproxy 输入插件从 Twemproxy 实例收集数据,处理 Twemproxy 服务器统计信息,处理池数据,并处理后端服务器 (Redis/Memcached) 统计信息。
UPSD
UPSD 输入插件使用其 NUT 网络协议从 upsd 守护程序读取一个或多个不间断电源的数据。
uWSGI
uWSGI 输入插件使用 uWSGI Stats Server 收集关于 uWSGI 的指标。
Varnish
Varnish 输入插件从 Varnish HTTP Cache 收集统计信息。
VMware vSphere
VMware vSphere 输入插件使用 vSphere API 从多个 vCenter 服务器(集群、主机、虚拟机和数据存储)收集指标。有关可用性能指标的更多信息,请参阅 通用 vSphere 性能指标
Webhooks
Webhooks 输入插件启动一个 HTTPS 服务器并注册多个 webhook 侦听器。
可用的 webhooks
添加新的 webhooks
如果您需要不支持的 webhook,请考虑添加新的 webhook
Windows 性能计数器
Windows 性能计数器输入插件读取 Windows 操作系统上的性能计数器。仅限 Windows。
Windows 事件日志
Windows 事件日志输入插件报告 Windows 事件日志记录。仅限 Windows Vista 及更高版本。
Windows 服务
Windows 服务输入插件报告 Windows 服务信息。仅限 Windows。
Windows Management Instrumentation
查询 Windows Management Instrumentation (WMI) 类。
无线
无线输入插件通过读取 /proc/net/wireless
文件来收集有关无线链路质量的指标。此插件目前仅支持 Linux。
Wireguard
Wireguard 输入插件使用 wgctrl
库收集本地 Wireguard 服务器上的统计信息。报告 Wireguard 接口设备及其对等方的仪表指标。
X.509 证书
X.509 证书输入插件提供有关使用本地文件或网络连接访问的 X.509 证书的信息。
XtremIO
Xtremio 插件从 Dell EMC XtremIO 存储阵列收集指标。
ZFS
支持:FreeBSD、Linux
ZFS 输入插件提供来自您的 ZFS 文件系统的指标。它支持 Linux 和 FreeBSD 上的 ZFS。它从 Linux 上的 /proc/spl/kstat/zfs
以及 FreeBSD 上的 sysctl
和 zpool
获取 ZFS 统计信息。
输出插件
Telegraf 处理器插件将指标写入各种目标。
Amazon CloudWatch
Amazon CloudWatch 输出插件将指标发送到 Amazon CloudWatch。
Amazon CloudWatch 日志
此输出插件将日志发送到 Amazon CloudWatch。
Amazon Kinesis
Amazon Kinesis 输出插件是一个实验性插件,仍处于开发的早期阶段。它会将所有点批量处理到一个 PUT
请求到 Kinesis。这应该可以大幅减少 API 请求的数量。
AWS Timestream
Timestream 输出插件将指标写入 Amazon Timestream 服务。
Amon
Amon 输出插件将指标写入 Amon 服务器。有关 Amon Agent 的详细信息,请参阅 监控代理,并且需要 apikey
和 amoninstance
URL。
如果发送的点值无法转换为 float64 值,则会跳过该指标。
指标通过将点名称中的任何 _
字符转换为 .
来分组。
AMQP
AMQP 输出插件写入 AMQP 0-9-1 交换机,这是高级消息队列协议 (AMQP) 协议的一个重要实现,即 RabbitMQ。
指标使用在配置文件中定义为 RoutingTag
的 tag
作为路由键写入主题交换机。
Apache Kafka
Apache Kafka 输出插件写入充当 Kafka 生产者的 Kafka Broker。
Azure 数据资源管理器
Azure 数据资源管理器输出插件将指标写入 Azure 数据资源管理器。
BigQuery
BigQuery 输出插件写入 Google Cloud 的 BigQuery。
CrateDB
CrateDB 输出插件使用其 PostgreSQL 协议 写入 CrateDB,这是一个用于机器数据和 IoT 的实时 SQL 数据库。
Clarify
将数据写入 Clarify
Datadog
Datadog 输出插件写入 Datadog Metrics API,并且需要一个 apikey
,可以从帐户的 此处 获取。
Discard
Discard 输出插件只是丢弃发送给它的所有指标。它仅用于测试目的。
Elasticsearch
Elasticsearch 输出插件使用 Elastic 通过 HTTP 写入 Elasticsearch。它支持从 5.x 到 7.x 的 Elasticsearch 版本。
Exec
Exec 输出插件通过 stdin
将 Telegraf 指标发送到外部应用程序。
Execd
Execd 输出插件将外部程序作为守护程序运行。
文件
File 输出插件将 Telegraf 指标写入文件。
Google Cloud PubSub
Google PubSub 输出插件将指标发布到 Google Cloud PubSub 主题,作为支持的 输出数据格式 之一。
Graylog
Graylog 输出插件使用 gelf
格式写入 Graylog 实例。
GroundWork
GroundWork 输出插件写入 GroundWork Monitor 实例。
HTTP
HTTP 输出插件以 HTTP 消息形式发送指标,使用输出数据格式之一进行编码。对于支持批处理的 data_formats
,指标以批处理格式发送。
Health
health 插件提供 HTTP 健康检查资源,该资源可以配置为根据指标的值返回失败状态代码。当插件健康时,它将返回 200 响应;当不健康时,它将返回 503 响应。默认状态是健康,必须有一个或多个检查失败,资源才会进入失败状态。
InfluxDB v1.x
InfluxDB v1.x 输出插件使用 HTTP 或 UDP 写入 InfluxDB。
InfluxDB v2
InfluxDB v2 输出插件将指标写入 InfluxDB 2.x OSS 或 Cloud。
Instrumental
Instrumental 输出插件写入 Instrumental Collector API,并且需要项目特定的 API 令牌。
Instrumental 接受非常接近 Graphite 格式的统计信息,唯一的区别是统计信息的类型(gauge、increment)是第一个标记,与指标本身之间用空格分隔。只有当指标通过 [[inputs.statsd]]
以计数器形式传入时,才使用 increment 类型。
IoTDB
此输出插件将 Telegraf 指标保存到 Apache IoTDB 后端,支持会话连接和数据插入。
Librato
Librato 输出插件写入 Librato Metrics API,并且需要 api_user
和 api_token
,可以从帐户的 此处 获取。
Logz.io
Logz.io 输出插件通过 HTTPs 将指标发送到 Logz.io。
Microsoft Azure Application Insights
Microsoft Azure Application Insights 输出插件将 Telegraf 指标写入 Application Insights (Microsoft Azure)。
Microsoft Azure Monitor
Azure Monitor 自定义指标服务目前处于预览阶段,并非在所有 Azure 区域都可用。
Microsoft Azure Monitor 输出插件将自定义指标发送到 Microsoft Azure Monitor。Azure Monitor 的指标分辨率为一分钟。为了在 Telegraf 中处理此问题,Azure Monitor 输出插件会自动将指标聚合到一分钟的存储桶中,然后在每个刷新间隔将其发送到 Azure Monitor。
有关将 Telegraf 与 Microsoft Azure Monitor 一起使用的 Microsoft 博客文章,请参阅 使用 InfluxData Telegraf Agent 收集 Linux VM 的自定义指标。
来自每个输入插件的指标将写入单独的 Azure Monitor 命名空间,默认情况下以 Telegraf/
为前缀。每个指标的字段名称都将作为 Azure Monitor 指标名称写入。所有字段值都将作为汇总集写入,其中包括 min
、max
、sum
和 count
。标签作为每个 Azure Monitor 指标的维度写入。
MongoDB
MongoDB 输出插件写入 MongoDB,并在集合尚不存在时自动创建集合作为时间序列集合。
NATS 输出
NATS 输出输出插件写入(列表中的)指定的 NATS 实例。
Nebius Cloud Monitoring
将聚合指标发送到 Nebius.Cloud Monitoring
New Relic
New Relic 输出插件使用 Metric API 写入 New Relic insights。
NSQ
NSQ 输出插件写入指定的 NSQD 实例,通常是生产者本地的实例。它需要服务器名称和主题名称。
OpenSearch
OpenSearch 插件通过 HTTP 将指标写入 OpenSearch 实例。
OpenTelemetry
OpenTelemetry 插件通过 gRPC 将指标发送到 OpenTelemetry 服务器和代理。
OpenTSDB
OpenTSDB 输出插件使用 telnet 或 HTTP 模式写入 OpenTSDB 实例。
自 OpenTSDB 2.0 以来,推荐使用 HTTP API 写入指标。要使用 HTTP 模式,请在配置中将 useHttp
设置为 true。您还可以通过在配置中设置 batchSize
来控制每个 HTTP 请求中发送的指标数量。有关详细信息,请参阅 OpenTSDB 文档。
Parquet
此插件将指标写入 parquet 文件。默认情况下,它按名称对指标进行分组,然后将每个组写入单独的文件。如果指标架构不匹配,则会丢弃指标。
Postgre SQL
Postgre SQL 输出插件将指标写入 PostgreSQL(或兼容数据库)。
Prometheus 客户端
Prometheus 客户端输出插件启动一个 Prometheus 客户端,它在 /metrics
(默认)上公开所有指标,以供 Prometheus 服务器轮询。
Redis 时间序列
Redis 时间序列输出插件将指标写入 RedisTimeSeries 服务器。
远程文件
此插件使用 rclone 库将 telegraf 指标写入远程位置的文件。支持 Amazon S3 或 SFTP 等多个后端。
Stackdriver
Stackdriver 输出插件写入 Google Cloud Stackdriver API,并且需要使用服务帐户或用户凭据通过 Google Cloud 进行 Google Cloud 身份验证。有关定价的详细信息,请参阅 Stackdriver 文档。
需要 project
来指定 Stackdriver 指标将交付到哪里。
指标按 namespace
变量和指标键分组,例如 custom.googleapis.com/telegraf/system/load5
。
Stomp (ActiveMQ)
Stomp (ActiveMQ) 输出插件写入 ActiveMQ Broker 以用于 STOMP。
SQL
SQL 输出插件将 Telegraf 指标数据保存到 SQL 数据库。
Sumo Logic
此插件使用以下支持的数据格式之一,以 HTTP 消息形式将指标发送到 Sumo Logic HTTP Source
graphite
- 用于 Content-Typeapplication/vnd.sumologic.graphite
carbon2
- 用于 Content-Typeapplication/vnd.sumologic.carbon2
prometheus
- 用于 Content-Typeapplication/vnd.sumologic.prometheus
Syslog
syslog 输出插件发送通过 UDP 或 TCP 或 TLS 传输的 syslog 消息,无论是否带有八位字节计数框架。Syslog 消息根据 RFC 5424 格式化。
Warp10
Warp10 输出插件将指标写入 SenX Warp 10。
Wavefront
Wavefront 输出插件以 Wavefront 数据格式通过 TCP 写入 Wavefront 代理。
Websocket
Websocket 输出插件可以写入 WebSocket 端点。
Yandex Cloud Monitoring
Yandex Cloud Monitoring 输出插件将自定义指标发送到 Yandex Cloud Monitoring。
Zabbix
此插件通过陷阱将指标发送到 Zabbix。它已使用 3.0、4.0 和 6.0 版本进行测试。只要 Zabbix 不更改协议,它就应该适用于较新版本。
聚合器插件
Telegraf 聚合器插件创建聚合指标(例如,均值、最小值、最大值、分位数等)
BasicStats
BasicStats 聚合器插件为一组值提供 count
、max
、min
、mean
、s2
(方差)和 stdev
,每 period 秒发出聚合。
Derivative
derivative 聚合器插件估计聚合指标的所有字段的导数。
Final
final 聚合器发出连续序列的最后一个指标。连续序列定义为在 series_timeout 定义的时间段内接收更新的序列。连续序列可能长于 period 定义的时间间隔。这对于获取产生离散时间序列的数据源(如 procstat、cgroup、kubernetes 等)的最终值非常有用。
Histogram
Histogram 聚合器插件创建包含范围内字段值计数的直方图。
添加到存储桶的值也会添加到分布中较大的存储桶中。这将创建一个 累积直方图。
与其他 Telegraf 聚合器插件一样,指标每 period 秒发出一次。但是,存储桶计数在周期之间不会重置,并且在 Telegraf 运行时将是非严格递增的。
Merge
Merge 聚合器插件将指标合并在一起,并生成每行具有多个字段的行协议。这优化了内存和网络传输效率。当字段在具有相同度量、标签集和时间戳的行协议的多行上拆分时,请使用此插件。
MinMax
MinMax 聚合器插件聚合它看到的每个字段的 min
和 max
值,每 period 秒发出聚合。
Quantile
quantile 聚合器插件聚合它看到的每个指标的每个数字字段的指定分位数,并每指定 period
发出分位数。
ValueCounter
ValueCounter 聚合器插件计算字段中值的出现次数,并在 ‘period’ 秒的规则间隔发出计数。此插件专门对字段进行操作,并且不影响标签。
要计数特定字段,请使用字段配置指令配置它们。如果未指定任何字段,则插件不会计数任何字段。结果在字段中发出,格式为 originalfieldname_fieldvalue = count
。
ValueCounter 仅适用于 int
、bool
或 string
类型的字段。浮点字段将被删除,以防止创建过多字段。
处理器插件
Telegraf 输出插件转换、装饰和过滤指标。
Converter
Converter 处理器插件用于更改标签或字段值的类型。除了更改字段类型外,它还可以在字段和标签之间进行转换。无法转换的值将被删除。
Clone
Clone 处理器插件创建每个指标的副本,以保留原始指标并允许在复制的指标中进行修改。
Date
Date 处理器插件将指标时间戳添加为人类可读的标签。
Dedup
Dedup 处理器插件过滤字段值与先前值完全重复的指标。
Defaults
Defaults 处理器插件允许您确保某些字段始终以指标上指定的默认值存在。
Enum
Enum 处理器插件允许配置指标字段的值映射。其主要用例是将诸如 red
、amber
和 green
之类的状态代码重写为诸如 0
、1
、2
之类的数值。该插件支持字段值的字符串和布尔类型。可以为每个字段配置具有单独值映射的多个字段。可以配置默认映射值以用于未包含在 value_mappings 中的所有值。处理器支持显式配置目标字段。默认情况下,源字段将被覆盖。
Execd
execd
处理器插件将外部程序作为单独的进程执行。它将指标管道输送到进程的 STDIN,并从其 STDOUT 读取处理后的指标。
Filepath
filepath
处理器插件将 path/filepath 中的某些 Go 函数映射到标签和字段值。
Filter
filter
处理器允许为指标指定一组规则,并能够保留或删除这些指标。
Lookup
读取特定文件并将注释表应用于指标。
网络接口名称
网络接口名称处理器插件使用 SNMP 查找网络接口名称。
Noise
noise 处理器插件用于向数值字段值添加噪声。这有助于用户通过匿名化敏感数据来添加一些噪声,并进一步防止链接攻击。
Override
Override 处理器插件允许覆盖输入插件和聚合器插件支持的所有修改
name_override
name_prefix
name_suffix
- tags
所有通过此处理器的指标都将进行相应的修改。使用标准度量过滤选项选择要修改的指标。
name_override
、name_prefix
、name_suffix
的值以及具有冲突键的已存在标签将被覆盖。将创建缺少的标签。
此插件的用例包括确保遵守某些标签或命名约定,而与输入插件配置无关,例如,通过 taginclude
。
Parser
Parser 处理器插件解析包含指定数据格式的已定义字段,并根据字段的内容创建新的指标。
Pivot
Pivot 处理器插件将单值指标旋转为多字段指标。此转换通常会产生更易于与数学运算符和比较一起使用的数据。它还将数据展平为更紧凑的表示形式,以用于某些输出数据格式的写入操作。
要执行反向操作,请使用 Unpivot 处理器。
端口名称查找
端口名称查找处理器插件将包含众所周知的端口号的标签转换为注册的服务名称。
Printer
Printer 处理器插件只是打印通过它的每个指标。
Regex
Regex 处理器插件使用正则表达式 (regex) 模式转换标签和字段值。如果存在 result_key
参数,它可以从现有标签和字段生成新的标签和字段。
Rename
Rename 处理器插件重命名 InfluxDB 度量、字段和标签。
Reverse DNS
Reverse DNS 处理器插件对其中包含 IP 的标签(或字段)执行反向 DNS 查找。
S2 Geo
S2 Geo 处理器插件添加带有指定 单元级别 的 S2 单元 ID 令牌的标签。标签在 Flux experimental/geo
函数中使用。使用 WGS-84 坐标(十进制度)指定 lat
和 lon
字段值。
Scale
处理器将值从指定范围缩放到另一个范围
SNMP 查找
处理器使用 SNMP 查找额外的标签
Split
将一个指标拆分为一个或多个具有指定字段/标签的指标
Starlark
Starlark 处理器插件为每个匹配的指标调用一个 Starlark 函数,从而允许自定义程序化指标处理。
Strings
Strings 处理器插件将某些 Go 字符串函数映射到 InfluxDB 度量、标签和字段值。值可以就地修改或存储在另一个键中。
已实现的函数包括
lowercase
uppercase
trim
trim_left
trim_right
trim_prefix
trim_suffix
请注意,在此实现中,它们会按照上述出现的顺序进行处理。您可以指定要在每个部分中处理的 measurement
、tag
或 field
,并且可以选择性地指定 dest
,如果您希望将结果存储在新的标签或字段中。您可以使用单个字符串处理器对数据指定许多转换。
标签限制
Tag Limit 处理器插件为任何给定的指标仅保留一定数量的标签,并在数据源附加的标签数量超过限制时选择要保留的标签。
当处理对每个指标的标签或标签数量施加硬性限制的输出系统(例如 Stackdriver),或者在高基数级别在计算上或经济上成本高昂时,这可能很有用。
模板
Template 处理器插件将 Go 模板应用于指标以生成新标签。主要用于为动态路由到多个输出插件或特定于输出的路由选项创建标签。该模板可以使用 template_metric.go 中的接口访问每个指标的 measurement 名称、标签、字段和时间戳。
时间戳
基于指标字段中的值生成指标时间戳。
TopK
TopK 处理器插件是一个过滤器,旨在获取一段时间内的顶部序列。可以对其进行调整,以在一段时间内进行 top K
计算,从而平滑峰值。
此处理器在处理一批指标时会执行以下步骤
- 使用指标的标签和名称作为键将指标分组到桶中。
- 通过选定的聚合函数(总和、平均值等)聚合每个桶中每个选定的字段。
- 按生成的聚合之一对桶进行排序,返回前
K
个桶中的所有指标,然后按生成的聚合的下一个对桶重新排序,返回前K
个桶中的所有指标,依此类推,直到字段用完。
该插件确保不重复指标。
请注意,根据每个计算桶上的指标数量,可能会返回超过 K
个指标。
此页面是否对您有帮助?
感谢您的反馈!
支持和反馈
感谢您成为我们社区的一份子!我们欢迎并鼓励您提供关于 Telegraf 和本文档的反馈和错误报告。要获得支持,请使用以下资源
拥有年度合同或支持合同的客户可以联系 InfluxData 支持。