From 2b6e3bd9c90c2fc0032712eb1cd87069f2ce7e1d Mon Sep 17 00:00:00 2001
From: Michael <michael.songer@infinitivegroup.co.uk>
Date: Mon, 28 Sep 2026 13:35:15 +0100
Subject: T9274: Add telegraf agent configuration (#2238)

Added documentation to correspond to the change to make several agent values configurable instead of hardcoded
---
 docs/configuration/service/monitoring.md | 46 ++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

(limited to 'docs')

diff --git a/docs/configuration/service/monitoring.md b/docs/configuration/service/monitoring.md
index 8d39fc5b..49604918 100644
--- a/docs/configuration/service/monitoring.md
+++ b/docs/configuration/service/monitoring.md
@@ -83,6 +83,52 @@ Example:
 set service monitoring telegraf vrf mgmt
 ```
 
+### Agent Configuration
+
+This section covers configuration commands which affect the overall agent behaviour.
+
+```{cfgcmd} set service monitoring telegraf agent collection-jitter \<interval\>
+
+   Set the collection jitter to jitter the collection by a random interval.
+   Each plugin will sleep for a random time within jitter before collecting.
+   This can be used to avoid many plugins querying things like sysfs at the same time,
+   which can have a measurable effect on the system.
+   
+   By default vyos sets it to 5s.
+```
+
+```{cfgcmd} set service monitoring telegraf agent debug
+
+   Enable logging at debug level.
+   
+   Delete this node to disable logging at debug level.
+```
+
+```{cfgcmd} set service monitoring telegraf agent flush-interval \<interval\>
+
+   Set the default flushing interval for all outputs. Maximum flush-interval will
+   be flush-interval + flush-jitter.
+   
+   By default vyos sets it to 15s.
+```
+
+```{cfgcmd} set service monitoring telegraf agent flush-jitter \<interval\>
+
+   Set the default flush jitter for all outputs. This jitters the flush interval by
+   a random amount. This is primarily to avoid large write spikes for users running
+   a large number of telegraf instances. ie, a jitter of 5s and interval 10s means
+   flushes will happen every 10-15s.
+   
+   By default vyos sets it to 0s.
+```
+
+```{cfgcmd} set service monitoring telegraf agent interval \<interval\>
+
+   Set the default data collection interval for all inputs.
+   
+   By default vyos sets it to 15s.
+```
+
 ### Azure Data Explorer
 
 A configuration for this plugin is committable only when
-- 
cgit v1.2.3