telegraf README

The project's README from github.com/influxdata/telegraf. As one markdown file: README.md.

tiger Telegraf

GoDoc Docker pulls Go Report Card Circle CI

Telegraf is an agent for collecting, processing, aggregating, and writing metrics, logs, and other arbitrary data.

Users can choose plugins from a wide range of topics, including but not limited to:

🔨 Installation

For binary builds, Docker images, RPM & DEB packages, and other builds of Telegraf, please see the install guide.

See the releases documentation for details on versioning and when releases are made.

💻 Usage

Users define a TOML configuration with the plugins and settings they wish to use, then pass that configuration to Telegraf. The Telegraf agent then collects data from inputs at each interval and sends data to outputs at each flush interval.

For a basic walkthrough see quick start.

📖 Documentation

For a full list of documentation including tutorials, reference and other material, start with the /docs directory.

Additionally, each plugin has its own README that includes details about how to configure, use, and sometimes debug or troubleshoot. Look under the /plugins directory for specific plugins.

Here are some commonly used documents:

❤️ Contribute

Contribute

We love our community of over 1,200 contributors! Many of the plugins included in Telegraf were originally contributed by community members. Check out our contributing guide if you are interested in helping out. Also, join us on our Community Slack or Community Forums if you have questions or comments for our engineering teams.

If you are completely new to Telegraf and InfluxDB, you can also enroll for free at InfluxDB university to take courses to learn more.

ℹ️ Support

Slack Forums

Please use the Community Slack or Community Forums if you have questions or comments for our engineering teams. GitHub issues are limited to actual issues and feature requests only.

📜 License

MIT

telegraf (influxdata/telegraf)

Searching Database…

17.9K ·GitHub
这是什么东西?Telegraf 是一个开源代理,用于采集、处理、聚合和写入指标、日志以及其他各类数据。它自带 300 多个插件,覆盖系统监控、云服务和消息队列等场景。
也就是说,我只需要在每台想监控的机器上都装一个代理,对吗?是的——它编译成独立的静态二进制文件,没有任何外部依赖,所以部署起来就是在每台机器上放一个二进制文件,再把它的输出指向你的后端即可。
怎么把它跑起来?按照安装指南安装二进制包、Docker 镜像或 RPM/DEB 安装包,然后写一个列出所用插件的 TOML 配置文件并运行——代理会按采集间隔从输入插件收集数据,并按刷新间隔写入输出插件。
它有图形界面吗,还是全靠配置文件?没有提到任何界面——所有东西都在一个 TOML 配置文件里描述,然后交给代理运行。TOML 配置的设计目标是对用户友好、没有歧义,但终究全是文本文件。
它在 Windows 服务器上也能跑吗,还是只支持 Linux?它是跨平台的:提供二进制包、Docker 镜像和 RPM/DEB 安装包,还有专门的 Windows 插件家族——事件日志(Event Log)、管理规范(WMI)和性能计数器(Performance Counters)。
开箱即用能从哪些类型的数据源采集数据?超过 300 个插件:系统指标(CPU、内存、磁盘、网络、SMART、Docker、Nvidia SMI)、设备(OPC UA、Modbus)、日志(文件、tail、目录监控)、消息队列(Kafka、MQTT、AMQP)、监控(OpenTelemetry、Prometheus)、网络(Cisco Telemetry MDT、gNMI),还有 SNMP、SQL、HTTP 和 Windows 事件日志。
后端必须用 InfluxDB 吗?README 里没有任何地方要求必须用它——输出是你自己挑选的插件。Telegraf 出自 InfluxData 之手,如果你对两者都完全陌生,InfluxDB University 提供免费课程。
某个插件的具体配置该怎么查?每个插件在 /plugins 目录下都有自己的 README,说明如何配置和使用,有些还包含调试或故障排查方法;/docs 目录里则是通用文档。
Creator
influxdata
Size
86.1 MB
Stars
17.9K
Age
11y
Commits · 90 Days