InfluxData / Telegraf

Telegraf is an agent for collecting, processing, aggregating, and writing metrics, logs, and other arbitrary data. Telegraf 是一个用于收集、处理、聚合和写入指标、日志及其他任意数据的代理程序。

Offers a comprehensive suite of over 300 plugins, covering a wide range of functionalities including system monitoring, cloud services, and message passing. 它提供了一套包含 300 多个插件的综合套件，涵盖了系统监控、云服务和消息传递等广泛的功能。

Enables the integration of user-defined code to collect, transform, and transmit data efficiently. 支持集成用户自定义代码，以高效地收集、转换和传输数据。

Compiles into a standalone static binary without any external dependencies, ensuring a streamlined deployment process. 可编译为无需任何外部依赖的独立静态二进制文件，确保了部署过程的精简高效。

Utilizes TOML for configuration, providing a user-friendly and unambiguous setup experience. 使用 TOML 进行配置，提供了用户友好且清晰明确的设置体验。

Developed with contributions from a diverse community of over 1,200 contributors. 由超过 1,200 名贡献者组成的多元化社区共同开发。

Users can choose plugins from a wide range of topics, including but not limited to: 用户可以从广泛的主题中选择插件，包括但不限于：

• Devices: OPC UA, Modbus
• 设备： OPC UA, Modbus
• Logs: File, Tail, Directory Monitor
• 日志： 文件、Tail、目录监控
• Messaging: AMQP, Kafka, MQTT
• 消息传递： AMQP, Kafka, MQTT
• Monitoring: OpenTelemetry, Prometheus
• 监控： OpenTelemetry, Prometheus
• Networking: Cisco TelemetryMDT, gNMI
• 网络： Cisco TelemetryMDT, gNMI
• System monitoring: CPU, Memory, Disk, Network, SMART, Docker, Nvidia SMI, etc.
• 系统监控： CPU、内存、磁盘、网络、SMART、Docker、Nvidia SMI 等。
• Universal: Exec, HTTP, HTTP Listener, SNMP, SQL
• 通用： Exec, HTTP, HTTP Listener, SNMP, SQL
• Windows: Event Log, Management Instrumentation, Performance Counters
• Windows： 事件日志、管理规范 (WMI)、性能计数器

🔨 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. 有关 Telegraf 的二进制构建、Docker 镜像、RPM 和 DEB 包以及其他构建版本，请参阅安装指南。有关版本控制和发布时间的详细信息，请参阅发布文档。

💻 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. 用户通过 TOML 配置文件定义想要使用的插件和设置，然后将其传递给 Telegraf。Telegraf 代理会在每个间隔从输入端收集数据，并在每个刷新间隔将数据发送到输出端。如需基础入门指南，请参阅快速入门。

📖 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: Changelog, Configuration, FAQ, Releases, Security. 如需完整的文档列表（包括教程、参考资料和其他材料），请从 /docs 目录开始。此外，每个插件都有自己的 README，其中包含有关如何配置、使用以及有时如何调试或排查故障的详细信息。请查看 /plugins 目录以获取特定插件的信息。以下是一些常用的文档：更新日志 (Changelog)、配置 (Configuration)、常见问题解答 (FAQ)、发布说明 (Releases)、安全 (Security)。

❤️ 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. 我们热爱拥有超过 1,200 名贡献者的社区！Telegraf 中包含的许多插件最初都是由社区成员贡献的。如果您有兴趣提供帮助，请查看我们的贡献指南。此外，如果您对我们的工程团队有任何问题或建议，欢迎加入我们的社区 Slack 或社区论坛。如果您是 Telegraf 和 InfluxDB 的新手，也可以在 InfluxDB 大学免费注册课程以了解更多信息。

ℹ️ Support

ℹ️ 支持

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. 如果您对我们的工程团队有任何问题或建议，请使用社区 Slack 或社区论坛。GitHub Issues 仅限于报告实际问题和功能请求。

📜 License

📜 许可证