From 86cad6c2e208fde9177236475ddfa4be865d5eeb Mon Sep 17 00:00:00 2001
From: "telegraf-tiger[bot]"
 <76974415+telegraf-tiger[bot]@users.noreply.github.com>
Date: Thu, 24 Mar 2022 12:19:58 -0600
Subject: [PATCH] feat: update etc/telegraf.conf and etc/telegraf_windows.conf
 (#10885)

---
 etc/telegraf.conf         | 11 +++++++++--
 etc/telegraf_windows.conf | 11 +++++++++--
 2 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/etc/telegraf.conf b/etc/telegraf.conf
index dd82e08f9..81b208cec 100644
--- a/etc/telegraf.conf
+++ b/etc/telegraf.conf
@@ -2877,7 +2877,10 @@
 #   ## How many seconds between aggregations
 #   # period = 10
 #
-#   ## How many top metrics to return
+#   ## How many top buckets to return per field
+#   ## Every field specified to aggregate over will return k number of results.
+#   ## For example, 1 field with k of 10 will return 10 buckets. While 2 fields
+#   ## with k of 3 will return 6 buckets.
 #   # k = 10
 #
 #   ## Over which tags should the aggregation be done. Globs can be specified, in
@@ -2885,7 +2888,11 @@
 #   ## empty list is no aggregation over tags is done
 #   # group_by = ['*']
 #
-#   ## Over which fields are the top k are calculated
+#   ## The field(s) to aggregate
+#   ## Each field defined is used to create an independent aggregation. Each
+#   ## aggregation will return k buckets. If a metric does not have a defined
+#   ## field the metric will be dropped from the aggregation. Considering using
+#   ## the defaults processor plugin to ensure fields are set if required.
 #   # fields = ["value"]
 #
 #   ## What aggregation to use. Options: sum, mean, min, max
diff --git a/etc/telegraf_windows.conf b/etc/telegraf_windows.conf
index 8b0afd912..4d19e8047 100644
--- a/etc/telegraf_windows.conf
+++ b/etc/telegraf_windows.conf
@@ -2877,7 +2877,10 @@
 #   ## How many seconds between aggregations
 #   # period = 10
 #
-#   ## How many top metrics to return
+#   ## How many top buckets to return per field
+#   ## Every field specified to aggregate over will return k number of results.
+#   ## For example, 1 field with k of 10 will return 10 buckets. While 2 fields
+#   ## with k of 3 will return 6 buckets.
 #   # k = 10
 #
 #   ## Over which tags should the aggregation be done. Globs can be specified, in
@@ -2885,7 +2888,11 @@
 #   ## empty list is no aggregation over tags is done
 #   # group_by = ['*']
 #
-#   ## Over which fields are the top k are calculated
+#   ## The field(s) to aggregate
+#   ## Each field defined is used to create an independent aggregation. Each
+#   ## aggregation will return k buckets. If a metric does not have a defined
+#   ## field the metric will be dropped from the aggregation. Considering using
+#   ## the defaults processor plugin to ensure fields are set if required.
 #   # fields = ["value"]
 #
 #   ## What aggregation to use. Options: sum, mean, min, max