Telegraf 输出插件
Telegraf 输出插件将指标发送到各种目标。
Amon
此插件将指标写入 Amon 监控平台。它需要 serverkey 和 amoninstance URL,您可以在 网站 上为您自己的帐户获取。
如果发送的点值无法转换为 float64,则该指标将被跳过。
AMQP
此插件写入高级消息队列协议 v0.9.1 代理。该协议的一个突出实现是 RabbitMQ。
此插件不将 AMQP 交换绑定到队列。
如需入门,请查看 AMQP 概念页面和 RabbitMQ 入门指南。
Azure Application Insights
此插件将指标写入 Azure Application Insights 服务。
Azure Data Explorer
此插件将指标写入 Azure Data Explorer、Azure Synapse Data Explorer 和 Fabric 中的实时分析 服务。
Azure Data Explorer 是一个分布式、面向列的存储,专为任何类型的日志、指标和时间序列数据而构建。
Azure Monitor
此插件将指标写入 Azure Monitor,其指标分辨率为一分钟。为了在 Telegraf 中进行适应,该插件将自动将指标聚合到一分钟的桶中,并在每个刷新间隔将其发送到服务。
Azure Monitor 自定义指标服务目前处于预览状态,可能并非在所有 Azure 区域都可用。也请注意指标时间限制!
每个输入插件的指标将写入一个单独的 Azure Monitor 命名空间,默认情况下以 Telegraf/ 作为前缀。每个指标的字段名将作为 Azure Monitor 指标名写入。所有字段值将作为汇总集写入,包括:最小值、最大值、总和、计数。标签将作为维度写入每个 Azure Monitor 指标。
Google BigQuery
此插件将指标写入 Google Cloud BigQuery 服务,并需要使用服务帐户或用户凭据 通过 Google Cloud 进行身份验证。
请注意,此插件访问 收费 的 API,可能会产生费用。
Google Cloud PubSub
此插件以支持的 数据格式之一将指标发布到 Google Cloud PubSub 主题。
Amazon CloudWatch
此插件将指标写入 Amazon CloudWatch 服务。
Amazon CloudWatch Logs
此插件将日志指标写入 Amazon CloudWatch 服务。
CrateDB
此插件通过其 PostgreSQL 协议将指标写入 CrateDB。
Discard
此插件会丢弃写入它的所有指标,仅用于测试目的。
Dynatrace
此插件通过 Dynatrace Metrics API V2 将指标写入 Dynatrace。它可以与 Dynatrace OneAgent 一起运行以实现自动身份验证,或者可以通过指定 URL 和 API Token 在没有 OneAgent 的主机上独立运行。
有关该插件的更多信息,请参阅 Dynatrace 文档。
所有指标都报告为仪表盘,除非它们被指定为增量计数器(使用 additional_counters 或 additional_counters_patterns 配置选项,见下文)。有关那里定义的类型,请参阅 Dynatrace Metrics ingestion protocol 文档。
Elasticsearch
此插件使用 Elastic 客户端库通过 HTTP 将指标写入 Elasticsearch。该插件支持从 v5.x 到 v7.x 的 Elasticsearch 版本。
Azure Event Hubs
此插件将指标写入 Azure Event Hubs 服务,格式为任何支持的 数据格式。指标以批次发送,每个消息负载包含一个指标对象,最好是 JSON 格式,因为这有助于与下游组件集成。
每个批次都发送到命名空间内的单个 Event Hub。如果未指定分区键,则批次将在所有 Event Hub 分区之间自动进行负载均衡(轮询)。
Executable
此插件通过 stdin 将指标写入外部应用程序。命令将在每次写入时执行,创建一个新进程。指标以支持的 数据格式之一传递。
可执行文件和各个参数必须定义为一个列表。可执行文件到 stderr 的所有输出将在 Telegraf 日志中记录。
为了获得更好的性能,请考虑使用 execd,它会持续运行。
Executable Daemon
此插件通过 stdin 将指标写入外部守护进程。该命令将执行一次,并以支持的数据格式之一将其传递给它。可执行文件和单个参数必须定义为一个列表。
可执行文件到 stderr 的所有输出都将在 Telegraf 日志中记录。Telegraf 最低版本:Telegraf 1.15.0
Graphite
此插件通过 TCP 将指标写入Graphite。有关 Telegraf 指标与 Graphite 输出之间的转换的详细信息,请参阅Graphite 数据格式。
Health
此插件提供了一个 HTTP 健康检查端点,可以配置为根据指标值返回失败状态码。
当插件健康时,它将返回 200 响应;当不健康时,它将返回 503 响应。默认状态为健康,必须有一个或多个检查失败,资源才能进入失败状态。
Heartbeat
此插件通过 POST 以固定间隔向 HTTP 端点发送心跳信号。这对于跟踪大型部署中现有的 Telegraf 实例很有用。
InfluxDB v1.x
此插件通过 HTTP 或 UDP 协议将指标写入InfluxDB v1.x 实例。
InfluxDB v2.x
此插件通过 HTTP 将指标写入InfluxDB v2.x 实例。
Inlong
此插件将指标发布到Apache InLong 实例。
Instrumental
此插件将指标写入Instrumental Collector API,需要项目特定的 API 令牌。
Instrumental 接受的统计信息格式非常接近 Graphite,唯一的区别是统计信息(gauge、increment)的类型是第一个令牌,并用空格与度量本身分隔。increment 类型仅在使用statsd 输入插件通过计数器接收指标时使用。
Apache IoTDB
此插件将指标写入Apache IoTDB 实例,一个用于物联网的数据库,支持会话连接和数据插入。
Kafka
此插件将指标作为 Kafka 生产者写入Kafka Broker。
Amazon Kinesis
此插件将指标写入Amazon Kinesis 端点。它会将一个请求中的所有点打包,以减少 API 请求数量。
有关 Kinesis 架构和概念的更多详细信息,请参阅Amazon 官方文档。
Librato
此插件将指标写入Librato 服务。它需要 api_user 和 api_token,这些可以在您账户的网站上获取。
配置文件中的 source_tag 选项用于将 Point Tags 的上下文信息发送到 API。除此之外,该插件目前不发送任何额外的关联 Point Tags。
如果发送的点值无法转换为 float64,则会跳过该指标。
Grafana Loki
此插件使用指标名称和标签作为标签,将日志写入Grafana Loki 实例。日志行将包含所有字段,格式为 key="value",易于 Loki 中的 logfmt 解析器解析。
每个流中的日志在发送到 Loki 之前按时间戳排序。
Microsoft Fabric
此插件将指标写入Fabric Eventhouse 和 Fabric Eventstream,这些是Microsoft Fabric 中的实时智能的组件。
实时智能是 Microsoft Fabric 中的一项 SaaS 服务,可让您提取见解并可视化动态数据。它为事件驱动的场景、流数据和数据日志提供端到端解决方案。
MQTT Producer
此插件将指标作为 MQTT 生产者写入MQTT 代理。该插件支持 MQTT 协议 3.1.1 和 5。
在 mosquitto MQTT 服务器的 v2.0.12+ 版本中,存在一个错误,要求在 Telegraf 中将 keep_alive 值设置为非零。否则,服务器将返回 identifier rejected。作为参考,eclipse/paho.golang 将 keep_alive 设置为 30。
Nebius Cloud Monitoring
此插件将指标写入Nebuis Cloud Monitoring 服务。
New Relic
此插件使用Metrics API 将指标写入New Relic Insights。要使用此插件,您必须获得Insights API 密钥。
OpenSearch
此插件通过 HTTP 将指标写入OpenSearch 实例。它支持 OpenSearch 1.x 和 2.x 版本,但不能保证与 1.x 的未来兼容性,而是将专注于 2.x 的支持。
请考虑为 1.x 版本使用现有的 Elasticsearch 插件。
OpenTelemetry
此插件通过 gRPC 将指标写入OpenTelemetry 服务器和代理。
Parquet
此插件将指标写入parquet 文件。默认情况下,指标按度量名称分组并写入同一文件。
如果指标模式与文件中的模式不匹配,该指标将被丢弃。
要了解有关 parquet 格式的更多信息,请查看parquet 文档以及一篇关于查询 parquet 的博文。
PostgreSQL
此插件将指标写入PostgreSQL(或兼容)服务器,并管理模式和自动更新丢失的列。
Prometheus
此插件启动一个Prometheus 客户端,并默认在 /metrics 端点上公开写入的指标。然后,Prometheus 服务器可以轮询此端点。
Redis Time Series
此插件将指标写入Redis time-series 服务器。
SQL
此插件将指标写入支持的 SQL 数据库,使用简单、硬编码的数据库模式。每个指标类型都有一个表,表名对应指标名称。每个字段都有一个列,每个标签都有一个列,还有一个可选的指标时间戳列。
每条指标写入一行。这意味着即使指标名称、标签和时间戳相同,多个指标也不会合并到一行中。
该插件使用 Golang 的通用“database/sql”接口和第三方驱动程序。有关支持的驱动程序列表和详细信息,请参阅驱动程序特定部分。
Google Cloud Monitoring
此插件将指标写入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
此插件将指标写入Active MQ Broker 以用于STOMP,但也支持Amazon MQ 代理。指标可以以支持的数据格式之一写入。
Sumo Logic
此插件使用以下数据格式之一将指标写入Sumo Logic HTTP Source:
graphite,Content-Type 为application/vnd.sumologic.graphitecarbon2,Content-Type 为application/vnd.sumologic.carbon2prometheus,Content-Type 为application/vnd.sumologic.prometheus
Syslog
此插件通过 UDP 以RFC5426 格式或通过 TCP 以RFC6587 格式或通过 TLS 以RFC5425 格式将指标作为 syslog 消息写入,无论是否带八位字节计数帧。
Syslog 消息根据RFC5424 进行格式化,在发送消息时根据 RFC 的syslog 消息格式部分限制字段大小。发送超出这些大小的消息可能会被严格的接收方静默丢弃。
Amazon Timestream
此插件将指标写入Amazon Timestream 服务。
Yandex Cloud Monitoring
此插件将指标写入Yandex Cloud Monitoring 服务。
此页面是否有帮助?
感谢您的反馈!
支持和反馈
感谢您成为我们社区的一员!我们欢迎并鼓励您对 Telegraf 和本文档提出反馈和 bug 报告。要获取支持,请使用以下资源
具有年度合同或支持合同的客户可以 联系 InfluxData 支持。