diff options
| author | Michael <michael.songer@infinitivegroup.co.uk> | 2026-09-28 13:35:15 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2026-09-28 13:35:15 +0100 |
| commit | 2b6e3bd9c90c2fc0032712eb1cd87069f2ce7e1d (patch) | |
| tree | de6f7856cd3a9f2636f25b48ec6386d9c7f601c8 /docs | |
| parent | 48dc4266d84f7d541fb94724aafe7eb5261caf5b (diff) | |
| download | vyos-documentation-2b6e3bd9c90c2fc0032712eb1cd87069f2ce7e1d.tar.gz vyos-documentation-2b6e3bd9c90c2fc0032712eb1cd87069f2ce7e1d.zip | |
T9274: Add telegraf agent configuration (#2238)
Added documentation to correspond to the change to make several agent values configurable instead of hardcoded
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/configuration/service/monitoring.md | 46 |
1 files changed, 46 insertions, 0 deletions
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 |
