influxdata / telegraf

Agent for collecting, processing, aggregating, and writing metrics, logs, and other arbitrary data.
https://influxdata.com/telegraf
MIT License
14.89k stars 5.6k forks source link

Add default settings to sample config of merge aggregator #16181

Open R290 opened 1 week ago

R290 commented 1 week ago

Use Case

My use case relies on a quick (order seconds) throughput from acquisition to writing to the database. The merge aggregator has a default window of 30 seconds and writes the metrics after this window has closed. I wanted to modify these settings and found this without any defaults listed: https://github.com/influxdata/telegraf/tree/master/config#aggregator-plugins. You actually need to look inside the code to find these: https://github.com/influxdata/telegraf/blob/1cfc65abef54277028f27c3f96dcf845e4a7ea72/config/config.go#L1360-L1365. The alternative is to enable the debug mode.

Expected behavior

The default values should be listed in the sample config of the merge aggregator plugin. Preferably with some description on what the Delay, Grace and Period settings actually do.

Actual behavior

The default 30 second merge window is sometimes too long and is not that straightforward to modify.

Additional info

Might apply to other aggregators as well?