Define agent reporting rules

Reporting rules define how long an agent can go without sending a heartbeat before Telegraf Controller changes its status to Not Reporting. They can also automatically delete agents that haven’t reported in a specified amount of time.

Telegraf Controller requires a default reporting rule. Newly created agents are automatically assigned to the current default reporting rule.

Manage reporting rules in the Reporting Rules section of Controller, then assign them to agents from either the agent list or an agent details page.

• Create a reporting rule
• Update a reporting rule
• Delete a reporting rule
• Set a default reporting rule
  • From the reporting rules list
  • From reporting rule details
• Assign a reporting rule to agents
  • From the agent list
  • From an agent details page

Create a reporting rule

1. In Telegraf Controller, go to Reporting Rules.
2. Select + Add Rule.
3. Enter the following:
   • Description: Reporting rule description
   • Not Reporting Threshold: The maximum time an agent can go without reporting before Controller assigns the “Not Reporting” status.
   • Auto-delete agents: Enable to automatically delete agents that haven’t reported in the defined auto-delete threshold.
   • Default Rule: Enable to make the rule the default reporting rule.
4. Save the rule.

Update a reporting rule

1. In Reporting Rules, click the More button (⋮) of the rule you want to update.
2. Select Edit.
3. Edit the description, not reporting threshold, auto-delete settings, or make the rule the default reporting rule.
4. Save your changes.

Delete a reporting rule

1. In Reporting Rules, click the More button (⋮) of the rule you want to delete.
2. Select Delete and confirm.

Set a default reporting rule

From the reporting rules list

1. In Reporting Rules, click the More button (⋮) of the rule you want to make the default.
2. Select Make Default.

From reporting rule details

1. In Reporting Rules, click the More button (⋮) of the rule you want to make the default.
2. Select Edit.
3. Toggle Default Rule to true.
4. Save your changes.

Assign a reporting rule to agents

From the agent list

1. In Agents, select one or more agents.
2. Select Assign Rule.
3. Choose a rule and assign it.

From an agent details page

1. In Agents, click the More button (⋮) for an agent and select View Details.
2. In the Reporting Rule section, select Change.
3. Choose a rule and apply it.