Repository files navigation

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

• Offers a comprehensive suite of over 300 plugins, covering a wide range offunctionalities including system monitoring, cloud services, and messagepassing
• Enables the integration of user-defined code to collect, transform, andtransmit 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 unambiguoussetup experience
• Developed with contributions from a diverse community of over 1,200contributors

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

• 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

For binary builds, Docker images, RPM & DEB packages, and other builds ofTelegraf, please see theinstall guide.

See thereleases documentation for details on versioningand when releases are made.

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

For a basic walkthrough seequick start.

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

Additionally, each plugin has its own README that includes details about how toconfigure, 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

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

If you are completely new to Telegraf and InfluxDB, you can also enroll for freeatInfluxDB university to take coursesto learn more.

Please use theCommunity Slack orCommunity Forums if you have questions orcomments for our engineering teams. GitHub issues are limited to actual issuesand feature requests only.