文档文档

Telegraf 命令和标志

telegraf 命令启动并运行 Telegraf functioning 所需的所有进程。

用法

telegraf [commands]
telegraf [flags]

命令

命令描述
config生成和迁移 Telegraf 配置
secrets管理秘密存储中的秘密
plugins打印可用插件
version将当前版本打印到 stdout

全局标志

标志描述
--config <file>要加载的配置文件。
--config-directory <directory>包含其他 *.conf 文件的目录。
--test-wait在 test 或 once 模式下等待服务输入完成的秒数。
--usage <plugin>打印插件用法 (例如: telegraf --usage mysql)。
--pprof-addr <address>pprof 监听地址。默认禁用。
--watch-config在本地配置更改时重新启动 Telegraf。使用文件系统通知 (notify) 或轮询 (poll)。默认禁用。
--pidfile <file>写入 PID 的文件。
--password <password>解锁秘密存储的密码。
--old-env-behavior切换回 v1.27 之前的环境变量替换行为。
--once收集一次指标,写入它们,然后退出。
--debug启用调试日志记录。
--quiet以安静模式运行。
--unprotected不在内存中保护秘密。
--test收集一次指标并打印它们。
--deprecation-list打印所有已弃用的插件或插件选项。
--input-list打印可用的输入插件。
--output-list打印可用的输出插件。
--version(已弃用) 打印 Telegraf 版本。
--sample-config(已弃用) 打印完整的示例配置。
--plugin-directory <directory>(已弃用) 包含 *.so 文件的目录,用于递归搜索插件。找到的插件将被加载、标记和识别。
--section-filter <filter>过滤要输出的配置节 (agent, global_tags, outputs, processors, aggregatorsinputs)。分隔符是 :
--input-filter <filter>过滤要启用的输入插件。分隔符是 :
--output-filter过滤要启用的输出插件。分隔符是 :
--aggregator-filter <filter>过滤要启用的聚合器。分隔符是 :
--processor-filter <filter>过滤要启用的处理器插件。分隔符是 :
--secretstore-filter <filter>过滤要启用的秘密存储插件。分隔符是 :

示例

生成 Telegraf 配置文件

telegraf config > telegraf.conf

生成仅包含特定插件的配置

telegraf config \
  --input-filter cpu \
  --output-filter influxdb

运行单个 Telegraf 配置并将指标输出到 stdout

telegraf --config telegraf.conf --test

使用配置文件中定义的所有插件运行 Telegraf

telegraf --config telegraf.conf

运行 Telegraf,但仅启用特定插件

telegraf \
  --config telegraf.conf \
  --input-filter cpu:mem \
  --output-filter influxdb

使用 pprof 运行 Telegraf

telegraf \
  --config telegraf.conf \
  --pprof-addr localhost:6060

此页面是否有帮助?

感谢您的反馈!


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