Get started with the InfluxData Platform
This page documents an earlier version of . is the latest stable version. View this page in the documentation.
Understand how Telegraf writes data to InfluxDB
Once Telegraf is installed and started, it will send system metrics to InfluxDB by default, which automatically creates a ‘telegraf’ database.
The configuration file for Telegraf specifies where metrics come from and where they go (inputs and outputs). In this example, we’ll focus on CPU data, which is one of the default system metrics generated by Telegraf. For this example, it is worth noting some relevant values:
[agent].interval- declares the frequency at which system metrics will be sent to InfluxDB.
[[outputs.influxdb]]- declares how to connect to InfluxDB and the destination database, which is the default ‘telegraf’ database.
[[inputs.cpu]]- declares how to collect the system cpu metrics to be sent to InfluxDB. Enabled by default.
For details about the configuration file, see Get started with Telegraf.
Query data in InfluxDB
As reviewed above, Telegraf is sending system data, including CPU usage, to InfluxDB. There are two ways you can query your InfluxDB data:
- In Chronograf with the Data Explorer. Use the builder to select from your existing data and allow Chronograf to format the query for you. Alternatively, manually enter and edit a query. You can move between using the builder and manually editing the query.
- Using the command line interface.
SELECT "usage_system", "usage_user" FROM "telegraf"."autogen"."cpu" WHERE time > now() - 30m
Visualize that data in a Chronograf dashboard
Create an alert in Kapacitor based on that data
Since InfluxDB is running on
localhost:8086, Kapacitor finds it during start up and creates several subscriptions on InfluxDB. These subscriptions tell InfluxDB to send all the data it receives from Telegraf to Kapacitor.
For step-by-step instructions on how to set up an alert in Kapacitor based on your data, see Creating Chronograf alert rules.
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.