Fix docs for metric buffer limit to reflect current behavior (#5741)

etc/telegraf.conf

@@ -9,9 +9,9 @@
 # Use 'telegraf -config telegraf.conf -test' to see what metrics a config
 # file would generate.
 #
-# Environment variables can be used anywhere in this config file, simply prepend
-# them with $. For strings the variable must be within quotes (ie, "$STR_VAR"),
-# for numbers and booleans they should be plain (ie, $INT_VAR, $BOOL_VAR)
+# Environment variables can be used anywhere in this config file, simply surround
+# them with ${}. For strings the variable must be within quotes (ie, "${STR_VAR}"),
+# for numbers and booleans they should be plain (ie, ${INT_VAR}, ${BOOL_VAR})
 
 
 # Global tags can be specified here in key="value" format.
@@ -35,10 +35,7 @@
   ## This controls the size of writes that Telegraf sends to output plugins.
   metric_batch_size = 1000
 
-  ## For failed writes, telegraf will cache metric_buffer_limit metrics for each
-  ## output, and will flush this buffer on a successful write. Oldest metrics
-  ## are dropped first when this buffer fills.
-  ## This buffer only fills when writes fail to output plugin(s).
+  ## Maximum number of unwritten metrics per output.
   metric_buffer_limit = 10000
 
   ## Collection jitter is used to jitter the collection by a random amount.
@@ -1092,6 +1089,10 @@
 #   ## When true will convert all _ (underscore) characters in final metric name. default is true
 #   #convert_paths = true
 #
+#   ## Use Strict rules to sanitize metric and tag names from invalid characters
+#   ## When enabled forward slash (/) and comma (,) will be accpeted
+#   #use_strict = false
+#
 #   ## Use Regex to sanitize metric and tag names from invalid characters
 #   ## Regex is more thorough, but significantly slower. default is false
 #   #use_regex = false
@@ -1352,6 +1353,10 @@
 #   ## aggregator and will not get sent to the output plugins.
 #   drop_original = false
 #
+#   ## If true, the histogram will be reset on flush instead
+#   ## of accumulating the results.
+#   reset = false
+#
 #   ## Example config that aggregates all fields of the metric.
 #   # [[aggregators.histogram.config]]
 #   #   ## The set of buckets.
@@ -1469,7 +1474,8 @@
 
 # Read metrics about system load & uptime
 [[inputs.system]]
-  # no configuration
+  ## Uncomment to remove deprecated metrics.
+  # fielddrop = ["uptime_format"]
 
 
 # # Gather ActiveMQ metrics
@@ -1586,6 +1592,15 @@
 #   tubes = ["notifications"]
 
 
+# # Read BIND nameserver XML statistics
+# [[inputs.bind]]
+#   ## An array of BIND XML statistics URI to gather stats.
+#   ## Default is "http://localhost:8053/xml/v3".
+#   # urls = ["http://localhost:8053/xml/v3"]
+#   # gather_memory_contexts = false
+#   # gather_views = false
+
+
 # # Collect bond interface status, slaves statuses and failures count
 # [[inputs.bond]]
 #   ## Sets 'proc' directory path
@@ -2151,6 +2166,18 @@
 #   ]
 
 
+# # Gather repository information from GitHub hosted repositories.
+# [[inputs.github]]
+#   ## List of repositories to monitor.
+#   repositories = ["influxdata/telegraf"]
+#
+#   ## Github API access token.  Unauthenticated requests are limited to 60 per hour.
+#   # access_token = ""
+#
+#   ## Timeout for HTTP requests.
+#   # http_timeout = "5s"
+
+
 # # Read flattened metrics from one or more GrayLog HTTP endpoints
 # [[inputs.graylog]]
 #   ## API endpoint, currently supported API:
@@ -3260,9 +3287,19 @@
 #   ##       "fcgi://10.0.0.12:9000/status"
 #   ##       "cgi://10.0.10.12:9001/status"
 #   ##
-#   ## Example of multiple gathering from local socket and remove host
+#   ## Example of multiple gathering from local socket and remote host
 #   ## urls = ["http://192.168.1.20/status", "/tmp/fpm.sock"]
 #   urls = ["http://localhost/status"]
+#
+#   ## Duration allowed to complete HTTP requests.
+#   # timeout = "5s"
+#
+#   ## Optional TLS Config
+#   # tls_ca = "/etc/telegraf/ca.pem"
+#   # tls_cert = "/etc/telegraf/cert.pem"
+#   # tls_key = "/etc/telegraf/key.pem"
+#   ## Use TLS but skip chain & host verification
+#   # insecure_skip_verify = false
 
 
 # # Ping given url(s) and return statistics
@@ -3334,6 +3371,9 @@
 #   ## Field name prefix
 #   # prefix = ""
 #
+#   ## When true add the full cmdline as a tag.
+#   # cmdline_tag = false
+#
 #   ## Add PID as a tag instead of a field; useful to differentiate between
 #   ## processes whose tags are otherwise the same.  Can create a large number
 #   ## of series, use judiciously.
@@ -4853,6 +4893,9 @@
 #   ## - prometheus.io/path: If the metrics path is not /metrics, define it with this annotation.
 #   ## - prometheus.io/port: If port is not 9102 use this annotation
 #   # monitor_kubernetes_pods = true
+#   ## Restricts Kubernetes monitoring to a single namespace
+#   ##   ex: monitor_kubernetes_pods_namespace = "default"
+#   # monitor_kubernetes_pods_namespace = ""
 #
 #   ## Use bearer token for authorization. ('bearer_token' takes priority)
 #   # bearer_token = "/path/to/bearer/token"

etc/telegraf_windows.conf

@@ -35,10 +35,7 @@
   ## This controls the size of writes that Telegraf sends to output plugins.
   metric_batch_size = 1000
 
-  ## For failed writes, telegraf will cache metric_buffer_limit metrics for each
-  ## output, and will flush this buffer on a successful write. Oldest metrics
-  ## are dropped first when this buffer fills.
-  ## This buffer only fills when writes fail to output plugin(s).
+  ## Maximum number of unwritten metrics per output.
   metric_buffer_limit = 10000
 
   ## Collection jitter is used to jitter the collection by a random amount.