influxdata /telegraf

Agent for collecting, processing, aggregating, and writing metrics, logs, and other arbitrary data.

★ 17,907⑂ 5,852👁 292⑃ 11,297● 8,786▤ 222
GoMITCreated 2015-04-01influxdata.com/telegraf
下载:v1.40.3v1.40.3 ↓1.40.32026-11-02
+2
日增长
+12
周增长
+42
月增长
17,907
stars
5,852
forks
292
watchers
11,297
prs
8,786
issues
222
releases

README

!tiger Telegraf






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

 Offers a comprehensive suite of over 300 plugins, covering a wide range of
  functionalities including system monitoring, cloud services, and message
  passing
 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
 Developed with contributions from a diverse community of over 1,200
  contributors

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

 Devices: [OPC UA][], [Modbus][]
 Logs: [File][], [Tail][], [Directory Monitor][]
 Messaging: [AMQP][], [Kafka][], [MQTT][]
 Monitoring: [OpenTelemetry][], [Prometheus][]
 Networking: [Cisco TelemetryMDT][], [gNMI][]
 System monitoring: [CPU][], [Memory][], [Disk][], [Network][], [SMART][],
  [Docker][], [Nvidia SMI][], etc.
 Universal: [Exec][], [HTTP][], [HTTP Listener][], [SNMP][], [SQL][]
 Windows: [Event Log][], [Management Instrumentation][],
  [Performance Counters][]

 🔨 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:

 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.

 ℹ️ 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.

 📜 License



[OPC UA]: https://github.com/influxdata/telegraf/tree/master/plugins/inputs/opcua
[Modbus]: https://github

Top issues

Latest release

v1.40.3 v1.40.3 2026-11-02
v1.40.3 [2026-11-02]

 Bugfixes

- 19958 agent Name v1.41.0 in skip_processors_after_aggregators warning
- 20026 disk-buffer Shift mask by number of truncated entries
- 20012 internal Read all process output before closing the pipes
- 20003 metric Skip adding nonconvertible field values
- 19920 common.proxy Send CONNECT credentials in Proxy-Authorization
- 19884 common.proxy Use TLS towards https proxies before sending CONNECT
- 20007 inputs.docker_log Do not record a zero timestamp for empty log streams
- 19928 inputs.docker_log Keep log-stream state when stream is cancelled
- 199

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON