telegraf 常用命令总结
Telegraf 是一个灵活的服务器代理,用于收集和报告指标。它支持插件驱动,这意味着你可以根据需要添加或修改功能。
1.使用 telegraf --help 查看 telegraf 提供的相关命令和参数
使用 telegraf --help 可以查看 telegraf 提供的相关命令和参数,具体如下:
基本命令
telegraf config
: 打印完整的样本配置到标准输出。telegraf version
: 打印版本信息。
配置相关
--config <file>
: 指定要加载的配置文件。--config-directory <directory>
: 指定包含额外 *.conf 文件的目录。--plugin-directory
: 指定包含 *.so 文件的目录,Telegraf 将递归搜索此目录并加载任何找到的插件。--debug
: 启用调试日志。--input-filter <filter>
: 过滤要启用的输入插件,分隔符为冒号。--output-filter <filter>
: 过滤要启用的输出插件,分隔符为冒号。--pidfile <file>
: 指定写入进程 ID 的文件。--pprof-addr <address>
: 指定监听 pprof 的地址。如果为空,则不激活 pprof。--processor-filter <filter>
: 过滤要启用的处理器,分隔符为冒号。--quiet
: 以静默模式运行。--section-filter
: 过滤要输出的配置部分,有效值包括 'agent', 'global_tags', 'outputs', 'processors', 'aggregators' 和 'inputs'。--sample-config
: 打印完整的样本配置。--test
: 收集指标、打印它们并退出;在测试模式下,不会运行处理器、聚合器和输出。--test-wait
: 在测试模式下等待多长时间以完成服务输入。--usage <plugin>
: 打印特定插件的使用信息,例如 'telegraf --usage mysql'。
示例
生成 Telegraf 配置文件:
telegraf config > telegraf.conf
仅定义 CPU 输入和 InfluxDB 输出插件的配置:
telegraf --input-filter cpu --output-filter influxdb config
单次 Telegraf 收集,输出指标到 stdout:
telegraf --config telegraf.conf --test
按配置文件中定义的所有插件运行 Telegraf:
telegraf --config telegraf.conf
启用 CPU 和内存输入,以及 InfluxDB 输出插件的 Telegraf:
telegraf --config telegraf.conf --input-filter cpu:mem --output-filter influxdb
带有 pprof 的 Telegraf 运行:
telegraf --config telegraf.conf --pprof-addr localhost:6060
2.telegraf --debug 调试运行
运行实例如下:
关注后面几行日志:
Buffer fullness: 这些消息显示了 Telegraf 内部缓冲区的状态,即在任何给定时间点,等待被发送到 InfluxDB 的指标数量。例如,“Buffer fullness: 0 / 10000 metrics”意味着当前没有指标在缓冲区中等待发送,而“Buffer fullness: 3 / 10000 metrics”表示有 3 个指标在缓冲区等待发送。这个数字显示了缓冲区的当前占用情况,与缓冲区的总容量(在这种情况下是 10000 个指标)相比。
Wrote batch of X metrics in Y ms: 这些消息表示 Telegraf 成功地将一批指标发送到 InfluxDB,并给出了处理这批指标所花费的时间。例如,“Wrote batch of 80 metrics in 8.915386ms”意味着 Telegraf 成功地将 80 个指标作为一批发送到 InfluxDB,这个过程花费了大约 8.92 毫秒。
3.通过修改配置文件开启 debug 模式:
修改 telegraf.conf 配置文件中得 debug 为 true
文章转载自:香吧香
评论