写点什么

telegraf 常用命令总结

  • 2024-08-02
    福建
  • 本文字数:3675 字

    阅读完需:约 12 分钟

Telegraf 是一个灵活的服务器代理,用于收集和报告指标。它支持插件驱动,这意味着你可以根据需要添加或修改功能。


1.使用 telegraf --help 查看 telegraf 提供的相关命令和参数


使用 telegraf --help 可以查看 telegraf 提供的相关命令和参数,具体如下:

telegraf --helpTelegraf, The plugin-driven server agent for collecting and reporting metrics.
Usage:
telegraf [commands|flags]
The commands & flags are:
config print out full sample configuration to stdout version print the version to stdout
--aggregator-filter <filter> filter the aggregators to enable, separator is : --config <file> configuration file to load --config-directory <directory> directory containing additional *.conf files --plugin-directory directory containing *.so files, this directory will be searched recursively. Any Plugin found will be loaded and namespaced. --debug turn on debug logging --input-filter <filter> filter the inputs to enable, separator is : --input-list print available input plugins. --output-filter <filter> filter the outputs to enable, separator is : --output-list print available output plugins. --pidfile <file> file to write our pid to --pprof-addr <address> pprof address to listen on, don't activate pprof if empty --processor-filter <filter> filter the processors to enable, separator is : --quiet run in quiet mode --section-filter filter config sections to output, separator is : Valid values are 'agent', 'global_tags', 'outputs', 'processors', 'aggregators' and 'inputs' --sample-config print out full sample configuration --test gather metrics, print them out, and exit; processors, aggregators, and outputs are not run --test-wait wait up to this many seconds for service inputs to complete in test mode --usage <plugin> print usage for a plugin, ie, 'telegraf --usage mysql' --version display the version and exit
Examples:
# generate a telegraf config file: telegraf config > telegraf.conf
# generate config with only cpu input & influxdb output plugins defined telegraf --input-filter cpu --output-filter influxdb config
# run a single telegraf collection, outputing metrics to stdout telegraf --config telegraf.conf --test
# run telegraf with all plugins defined in config file telegraf --config telegraf.conf
# run telegraf, enabling the cpu & memory input, and influxdb output plugins telegraf --config telegraf.conf --input-filter cpu:mem --output-filter influxdb
# run telegraf with pprof telegraf --config telegraf.conf --pprof-addr localhost:6060
复制代码


基本命令

  • 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 收集,输出指标到 stdouttelegraf --config telegraf.conf --test

  • 按配置文件中定义的所有插件运行 Telegraftelegraf --config telegraf.conf

  • 启用 CPU 和内存输入,以及 InfluxDB 输出插件的 Telegraftelegraf --config telegraf.conf --input-filter cpu:mem --output-filter influxdb

  • 带有 pprof 的 Telegraf 运行telegraf --config telegraf.conf --pprof-addr localhost:6060


2.telegraf --debug 调试运行


运行实例如下:

root@533b2a4c7c7d:/# telegraf --debug2024-07-26T08:29:49Z I! Starting Telegraf 1.14.32024-07-26T08:29:49Z I! Using config file: /etc/telegraf/telegraf.conf2024-07-26T08:29:49Z I! Loaded inputs: procstat procstat procstat procstat procstat procstat procstat procstat procstat procstat procstat procstat procstat procstat procstat procstat procstat procstat procstat procstat procstat procstat procstat ping disk kernel mem system net cpu processes swap2024-07-26T08:29:49Z I! Loaded aggregators:2024-07-26T08:29:49Z I! Loaded processors:2024-07-26T08:29:49Z I! Loaded outputs: influxdb2024-07-26T08:29:49Z I! Tags enabled: host=controller1 nodetype=controller2024-07-26T08:29:49Z I! [agent] Config: Interval:30s, Quiet:false, Hostname:"controller1", Flush Interval:10s2024-07-26T08:29:49Z D! [agent] Initializing plugins2024-07-26T08:29:49Z D! [agent] Connecting outputs2024-07-26T08:29:49Z D! [agent] Attempting connection to [outputs.influxdb]2024-07-26T08:29:49Z W! [outputs.influxdb] When writing to [http://192.168.118.142:8097]: database "monitor" creation failed: 404 Not Found2024-07-26T08:29:49Z D! [agent] Successfully connected to outputs.influxdb2024-07-26T08:29:49Z D! [agent] Starting service inputs2024-07-26T08:30:00Z D! [outputs.influxdb] Buffer fullness: 0 / 10000 metrics2024-07-26T08:30:10Z D! [outputs.influxdb] Wrote batch of 81 metrics in 8.753274ms2024-07-26T08:30:10Z D! [outputs.influxdb] Buffer fullness: 0 / 10000 metrics2024-07-26T08:30:20Z D! [outputs.influxdb] Wrote batch of 4 metrics in 1.620578ms2024-07-26T08:30:20Z D! [outputs.influxdb] Buffer fullness: 0 / 10000 metrics2024-07-26T08:30:30Z D! [outputs.influxdb] Buffer fullness: 0 / 10000 metrics2024-07-26T08:30:40Z D! [outputs.influxdb] Wrote batch of 83 metrics in 11.697527ms2024-07-26T08:30:40Z D! [outputs.influxdb] Buffer fullness: 0 / 10000 metrics2024-07-26T08:30:50Z D! [outputs.influxdb] Wrote batch of 4 metrics in 1.38142ms
复制代码


关注后面几行日志:

  • 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

       


文章转载自:香吧香

原文链接:https://www.cnblogs.com/zjdxr-up/p/18336269

体验地址:http://www.jnpfsoft.com/?from=infoq

用户头像

还未添加个人签名 2023-06-19 加入

还未添加个人简介

评论

发布
暂无评论
telegraf 常用命令总结_服务器_不在线第一只蜗牛_InfoQ写作社区