Manage Telegraf agents
Telegraf Controller tracks agents that send heartbeats through the Telegraf
heartbeat output plugin.
Each heartbeat includes a unique instance_id (also called “agent ID”) so
Controller can distinguish one agent from another.
- Telegraf Controller automatically creates agents the first time a heartbeat arrives from a unique agent.
- Click the More button (⋮) in the agent list and select View Details to see information and reporting history for an agent.
- Reporting rules define how long an agent can go without sending a heartbeat before Controller marks it as Not Reporting. They can also automatically delete agents that haven’t reported in a specified amount of time.
- You can assign a reporting rule from the agent list or an agent details page.
- Sort the agent list by Agent Details, Status, or Last Reported by clicking a column header. Click the header again to reverse the sort order.
Create agents
Learn how Telegraf Controller creates agents from heartbeat plugin reports and how to verify new agents in the UI.
Define agent reporting rules
Define reporting rules that determine when Telegraf Controller marks agents as not reporting and optionally automatically delete not reporting agents.
Set agent statuses
Configure agent status evaluation using CEL expressions in the Telegraf heartbeat output plugin and view statuses in Telegraf Controller.
Delete agents
Remove individual or multiple Telegraf agents from Telegraf Controller.
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 Telegraf and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.