Agent for collecting, processing, aggregating, and writing metrics, logs, and other arbitrary data.
Agent for collecting, processing, aggregating, and writing metrics, logs, and other arbitrary data.
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:
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.
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.
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:
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.
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.