文档文档

Telegraf 输出插件

Telegraf 输出插件将指标发送到各种目标。

Amon

插件 ID: outputs.amon
Telegraf v0.2.1 - v1.37.0 已弃用

此插件将指标写入 Amon 监控平台。它需要 serverkeyamoninstance URL,您可以在 网站 上为您自己的帐户获取。

如果发送的点值无法转换为 float64,则该指标将被跳过。

查看

AMQP

插件 ID: outputs.amqp
Telegraf v0.1.9+

此插件写入高级消息队列协议 v0.9.1 代理。该协议的一个突出实现是 RabbitMQ

此插件不将 AMQP 交换绑定到队列。

如需入门,请查看 AMQP 概念页面RabbitMQ 入门指南

查看

Azure Application Insights

插件 ID: outputs.application_insights
Telegraf v1.7.0+

此插件将指标写入 Azure Application Insights 服务。

查看

Arc

插件 ID: outputs.arc
Telegraf v1.37.0+

此插件通过 MessagePack 二进制协议消息将指标写入 Arc(一个高性能时间序列数据库),其性能比行协议格式 提高 3-5 倍

查看

Azure Data Explorer

插件 ID: outputs.azure_data_explorer
Telegraf v1.20.0+

此插件将指标写入 Azure Data ExplorerAzure Synapse Data ExplorerFabric 中的实时分析 服务。

Azure Data Explorer 是一个分布式、面向列的存储,专为任何类型的日志、指标和时间序列数据而构建。

查看

Azure Monitor

插件 ID: outputs.azure_monitor
Telegraf v1.8.0+

此插件将指标写入 Azure Monitor,其指标分辨率为一分钟。为了在 Telegraf 中进行适应,该插件将自动将指标聚合到一分钟的桶中,并在每个刷新间隔将其发送到服务。

Azure Monitor 自定义指标服务目前处于预览状态,可能并非在所有 Azure 区域都可用。也请注意指标时间限制!

每个输入插件的指标将写入一个单独的 Azure Monitor 命名空间,默认情况下以 Telegraf/ 作为前缀。每个指标的字段名将作为 Azure Monitor 指标名写入。所有字段值将作为汇总集写入,包括:最小值、最大值、总和、计数。标签将作为维度写入每个 Azure Monitor 指标。

查看

Google BigQuery

插件 ID: outputs.bigquery
Telegraf v1.18.0+

此插件将指标写入 Google Cloud BigQuery 服务,并需要使用服务帐户或用户凭据 通过 Google Cloud 进行身份验证

请注意,此插件访问 收费 的 API,可能会产生费用。

查看

Clarify

插件 ID: outputs.clarify
Telegraf v1.27.0+

此插件将指标写入 Clarify。要使用此插件,您需要获取一套 凭据

查看

Google Cloud PubSub

插件 ID: outputs.cloud_pubsub
Telegraf v1.10.0+

此插件以支持的 数据格式之一将指标发布到 Google Cloud PubSub 主题。

查看

Amazon CloudWatch

插件 ID: outputs.cloudwatch
Telegraf v0.10.1+

此插件将指标写入 Amazon CloudWatch 服务。

查看

Amazon CloudWatch Logs

插件 ID: outputs.cloudwatch_logs
Telegraf v1.19.0+

此插件将日志指标写入 Amazon CloudWatch 服务。

查看

CrateDB

插件 ID: outputs.cratedb
Telegraf v1.5.0+

此插件通过其 PostgreSQL 协议将指标写入 CrateDB

查看

Datadog

插件 ID: outputs.datadog
Telegraf v0.1.6+

此插件将指标写入 Datadog Metrics API,需要一个 apikey,您可以在 网站 上为您自己的帐户获取。

此插件支持 v1 API。

查看

Discard

插件 ID: outputs.discard
Telegraf v1.2.0+

此插件会丢弃写入它的所有指标,仅用于测试目的。

查看

Dynatrace

插件 ID: outputs.dynatrace
Telegraf v1.16.0+

此插件通过 Dynatrace Metrics API V2 将指标写入 Dynatrace。它可以与 Dynatrace OneAgent 一起运行以实现自动身份验证,或者可以通过指定 URL 和 API Token 在没有 OneAgent 的主机上独立运行。

有关该插件的更多信息,请参阅 Dynatrace 文档

所有指标都报告为仪表盘,除非它们被指定为增量计数器(使用 additional_countersadditional_counters_patterns 配置选项,见下文)。有关那里定义的类型,请参阅 Dynatrace Metrics ingestion protocol 文档

查看

Elasticsearch

插件 ID: outputs.elasticsearch
Telegraf v0.1.5+

此插件使用 Elastic 客户端库通过 HTTP 将指标写入 Elasticsearch。该插件支持从 v5.x 到 v7.x 的 Elasticsearch 版本。

查看

Azure Event Hubs

插件 ID: outputs.event_hubs
Telegraf v1.21.0+

此插件将指标写入 Azure Event Hubs 服务,格式为任何支持的 数据格式。指标以批次发送,每个消息负载包含一个指标对象,最好是 JSON 格式,因为这有助于与下游组件集成。

每个批次都发送到命名空间内的单个 Event Hub。如果未指定分区键,则批次将在所有 Event Hub 分区之间自动进行负载均衡(轮询)。

查看

Executable

插件 ID: outputs.exec
Telegraf v1.12.0+

此插件通过 stdin 将指标写入外部应用程序。命令将在每次写入时执行,创建一个新进程。指标以支持的 数据格式之一传递。

可执行文件和各个参数必须定义为一个列表。可执行文件到 stderr 的所有输出将在 Telegraf 日志中记录。

为了获得更好的性能,请考虑使用 execd,它会持续运行。

查看

Executable Daemon

插件 ID: outputs.execd
Telegraf v1.15.0+

此插件通过 stdin 将指标写入外部守护进程。该命令将执行一次,并以支持的数据格式之一将其传递给它。可执行文件和单个参数必须定义为一个列表。

可执行文件到 stderr 的所有输出都将在 Telegraf 日志中记录。Telegraf 最低版本:Telegraf 1.15.0

查看

File

插件 ID: outputs.file
Telegraf v0.10.3+

此插件以支持的数据格式之一将指标写入一个或多个本地文件。

查看

Graphite

插件 ID: outputs.graphite
Telegraf v0.10.1+

此插件通过 TCP 将指标写入Graphite。有关 Telegraf 指标与 Graphite 输出之间的转换的详细信息,请参阅Graphite 数据格式

查看

Graylog

插件 ID: outputs.graylog
Telegraf v1.0.0+

此插件使用GELF 数据格式将指标写入Graylog 实例。

查看

GroundWork

插件 ID: outputs.groundwork
Telegraf v1.21.0+

此插件将指标写入GroundWork Monitor 实例。

插件仅支持 GroundWork v8 或更高版本。

查看

Health

插件 ID: outputs.health
Telegraf v1.11.0+

此插件提供了一个 HTTP 健康检查端点,可以配置为根据指标值返回失败状态码。

当插件健康时,它将返回 200 响应;当不健康时,它将返回 503 响应。默认状态为健康,必须有一个或多个检查失败,资源才能进入失败状态。

查看

Heartbeat

插件 ID: outputs.heartbeat
Telegraf v1.37.0+

此插件通过 POST 以固定间隔向 HTTP 端点发送心跳信号。这对于跟踪大型部署中现有的 Telegraf 实例很有用。

查看

HTTP

插件 ID: outputs.http
Telegraf v1.7.0+

此插件使用支持的数据格式之一将指标写入 HTTP 端点。对于支持批处理的数据格式,指标默认以批处理方式发送。

查看

InfluxDB v1.x

插件 ID: outputs.influxdb
Telegraf v0.1.1+

此插件通过 HTTP 或 UDP 协议将指标写入InfluxDB v1.x 实例。

查看

InfluxDB v2.x

插件 ID: outputs.influxdb_v2
Telegraf v1.8.0+

此插件通过 HTTP 将指标写入InfluxDB v2.x 实例。

查看

Inlong

插件 ID: outputs.inlong
Telegraf v1.35.0+

此插件将指标发布到Apache InLong 实例。

查看

Instrumental

插件 ID: outputs.instrumental
Telegraf v0.13.1+

此插件将指标写入Instrumental Collector API,需要项目特定的 API 令牌。

Instrumental 接受的统计信息格式非常接近 Graphite,唯一的区别是统计信息(gauge、increment)的类型是第一个令牌,并用空格与度量本身分隔。increment 类型仅在使用statsd 输入插件通过计数器接收指标时使用。

查看

Apache IoTDB

插件 ID: outputs.iotdb
Telegraf v1.24.0+

此插件将指标写入Apache IoTDB 实例,一个用于物联网的数据库,支持会话连接和数据插入。

查看

Kafka

插件 ID: outputs.kafka
Telegraf v0.1.7+

此插件将指标作为 Kafka 生产者写入Kafka Broker

查看

Amazon Kinesis

插件 ID: outputs.kinesis
Telegraf v0.2.5+

此插件将指标写入Amazon Kinesis 端点。它会将一个请求中的所有点打包,以减少 API 请求数量。

有关 Kinesis 架构和概念的更多详细信息,请参阅Amazon 官方文档

查看

Librato

插件 ID: outputs.librato
Telegraf v0.2.0+

此插件将指标写入Librato 服务。它需要 api_userapi_token,这些可以在您账户的网站上获取。

配置文件中的 source_tag 选项用于将 Point Tags 的上下文信息发送到 API。除此之外,该插件目前不发送任何额外的关联 Point Tags。

如果发送的点值无法转换为 float64,则会跳过该指标。

查看

Logz.io

插件 ID: outputs.logzio
Telegraf v1.17.0+

此插件通过 HTTP 将指标写入Logz.io 服务。

查看

Grafana Loki

插件 ID: outputs.loki
Telegraf v1.18.0+

此插件使用指标名称和标签作为标签,将日志写入Grafana Loki 实例。日志行将包含所有字段,格式为 key="value",易于 Loki 中的 logfmt 解析器解析。

每个流中的日志在发送到 Loki 之前按时间戳排序。

查看

Microsoft Fabric

插件 ID: outputs.microsoft_fabric
Telegraf v1.35.0+

此插件将指标写入Fabric EventhouseFabric Eventstream,这些是Microsoft Fabric 中的实时智能的组件。

实时智能是 Microsoft Fabric 中的一项 SaaS 服务,可让您提取见解并可视化动态数据。它为事件驱动的场景、流数据和数据日志提供端到端解决方案。

查看

MongoDB

插件 ID: outputs.mongodb
Telegraf v1.21.0+

此插件将指标写入MongoDB,如果集合不存在,则会自动创建为时间序列集合。

此插件需要 MongoDB v5 或更高版本才能使用时间序列集合。

查看

MQTT Producer

插件 ID: outputs.mqtt
Telegraf v0.2.0+

此插件将指标作为 MQTT 生产者写入MQTT 代理。该插件支持 MQTT 协议 3.1.15

在 mosquitto MQTT 服务器的 v2.0.12+ 版本中,存在一个错误,要求在 Telegraf 中将 keep_alive 值设置为非零。否则,服务器将返回 identifier rejected。作为参考,eclipse/paho.golangkeep_alive 设置为 30。

查看

NATS

插件 ID: outputs.nats
Telegraf v1.1.0+

此插件以支持的数据格式之一将指标写入一组NATS 实例的主题。

查看

Nebius Cloud Monitoring

插件 ID: outputs.nebius_cloud_monitoring
Telegraf v1.27.0+

此插件将指标写入Nebuis Cloud Monitoring 服务。

查看

New Relic

插件 ID: outputs.newrelic
Telegraf v1.15.0+

此插件使用Metrics API 将指标写入New Relic Insights。要使用此插件,您必须获得Insights API 密钥

查看

NSQ

插件 ID: outputs.nsq
Telegraf v0.2.1+

此插件以支持的数据格式之一将指标写入NSQ 实例的给定主题,作为生产者。

查看

OpenSearch

插件 ID: outputs.opensearch
Telegraf v1.29.0+

此插件通过 HTTP 将指标写入OpenSearch 实例。它支持 OpenSearch 1.x 和 2.x 版本,但不能保证与 1.x 的未来兼容性,而是将专注于 2.x 的支持。

请考虑为 1.x 版本使用现有的 Elasticsearch 插件。

查看

OpenTelemetry

插件 ID: outputs.opentelemetry
Telegraf v1.20.0+

此插件通过 gRPC 将指标写入OpenTelemetry 服务器和代理。

查看

OpenTSDB

插件 ID: outputs.opentsdb
Telegraf v0.1.9+

此插件使用 telnet 或 HTTP 模式将指标写入OpenTSDB 实例。由于 OpenTSDB 2.0,建议使用 HTTP API。

查看

Parquet

插件 ID: outputs.parquet
Telegraf v1.32.0+

此插件将指标写入parquet 文件。默认情况下,指标按度量名称分组并写入同一文件。

如果指标模式与文件中的模式不匹配,该指标将被丢弃。

要了解有关 parquet 格式的更多信息,请查看parquet 文档以及一篇关于查询 parquet 的博文。

查看

PostgreSQL

插件 ID: outputs.postgresql
Telegraf v1.24.0+

此插件将指标写入PostgreSQL(或兼容)服务器,并管理模式和自动更新丢失的列。

查看

Prometheus

插件 ID: outputs.prometheus_client
Telegraf v0.2.1+

此插件启动一个Prometheus 客户端,并默认在 /metrics 端点上公开写入的指标。然后,Prometheus 服务器可以轮询此端点。

查看

Quix

插件 ID: outputs.quix
Telegraf v1.33.0+

此插件将指标写入Quix 端点。

有关 Quix 平台架构和概念的更多详细信息,请参阅 Quix 的官方文档

查看

Redis Time Series

插件 ID: outputs.redistimeseries
Telegraf v1.0.0+

此插件将指标写入Redis time-series 服务器。

查看

Remote File

插件 ID: outputs.remotefile
Telegraf v1.32.0+

此插件使用rclone 库将指标写入远程位置的文件。目前支持以下后端:

查看

Riemann

插件 ID: outputs.riemann
Telegraf v1.3.0+

此插件通过 TCP 或 UDP 将指标写入Riemann 服务。

查看

Sensu Go

插件 ID: outputs.sensu
Telegraf v1.18.0+

此插件通过其 HTTP 事件 API 将指标写入Sensu Go

查看

SignalFx

插件 ID: outputs.signalfx
Telegraf v1.18.0+

此插件将指标写入SignalFx

查看

Socket Writer

插件 ID: outputs.socket_writer
Telegraf v1.3.0+

此插件以支持的数据格式之一将指标写入网络服务,例如通过 UDP 或 TCP。

查看

SQL

插件 ID: outputs.sql
Telegraf v1.19.0+

此插件将指标写入支持的 SQL 数据库,使用简单、硬编码的数据库模式。每个指标类型都有一个表,表名对应指标名称。每个字段都有一个列,每个标签都有一个列,还有一个可选的指标时间戳列。

每条指标写入一行。这意味着即使指标名称、标签和时间戳相同,多个指标也不会合并到一行中。

该插件使用 Golang 的通用“database/sql”接口和第三方驱动程序。有关支持的驱动程序列表和详细信息,请参阅驱动程序特定部分。

查看

Google Cloud Monitoring

插件 ID: outputs.stackdriver
Telegraf v1.9.0+

此插件将指标写入Google Cloud Monitoring(以前称为 Stackdriver)的 project。需要使用服务帐户或用户凭据进行身份验证

此插件访问收费的 API,可能会产生费用。

默认情况下,指标按 namespace 变量和指标键分组,例如:custom.googleapis.com/telegraf/system/load5。但是,这不是最佳实践。设置 metric_name_format = "official" 将产生一种更易于查询的格式:metric_type_prefix/[namespace_]name_key/kind。如果未设置全局命名空间,则省略。

查看

ActiveMQ STOMP

插件 ID: outputs.stomp
Telegraf v1.24.0+

此插件将指标写入Active MQ Broker 以用于STOMP,但也支持Amazon MQ 代理。指标可以以支持的数据格式之一写入。

查看

Sumo Logic

插件 ID: outputs.sumologic
Telegraf v1.16.0+

此插件使用以下数据格式之一将指标写入Sumo Logic HTTP Source

  • graphite,Content-Type 为 application/vnd.sumologic.graphite
  • carbon2,Content-Type 为 application/vnd.sumologic.carbon2
  • prometheus,Content-Type 为 application/vnd.sumologic.prometheus

查看

Syslog

插件 ID: outputs.syslog
Telegraf v1.11.0+

此插件通过 UDP 以RFC5426 格式或通过 TCP 以RFC6587 格式或通过 TLS 以RFC5425 格式将指标作为 syslog 消息写入,无论是否带八位字节计数帧。

Syslog 消息根据RFC5424 进行格式化,在发送消息时根据 RFC 的syslog 消息格式部分限制字段大小。发送超出这些大小的消息可能会被严格的接收方静默丢弃。

查看

Amazon Timestream

插件 ID: outputs.timestream
Telegraf v1.16.0+

此插件将指标写入Amazon Timestream 服务。

查看

Warp10

插件 ID: outputs.warp10
Telegraf v1.14.0+

此插件将指标写入Warp 10 服务。

查看

Wavefront

插件 ID: outputs.wavefront
Telegraf v1.5.0+

此插件通过 HTTP 或 HTTPS 将指标写入Wavefront 实例或 Wavefront Proxy 实例。

查看

Websocket

插件 ID: outputs.websocket
Telegraf v1.19.0+

此插件以支持的数据格式之一将指标写入 WebSocket 端点。

查看

Yandex Cloud Monitoring

插件 ID: outputs.yandex_cloud_monitoring
Telegraf v1.17.0+

此插件将指标写入Yandex Cloud Monitoring 服务。

查看

Zabbix

插件 ID: outputs.zabbix
Telegraf v1.30.0+

此插件通过陷阱将指标写入Zabbix。它已在 v3.0、v4.0 和 v6.0 版本上进行了测试,但只要协议不改变,它应该也能与更新版本的 Zabbix 一起工作。

查看

此页面是否有帮助?

感谢您的反馈!


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