Adding upstream version 1.34.4.

Signed-off-by: Daniel Baumann <daniel@debian.org>

plugins/outputs/sensu/README.md

@@ -0,0 +1,116 @@
+# Sensu Go Output Plugin
+
+This plugin writes metrics to [Sensu Go][sensu] via its HTTP events API.
+
+⭐ Telegraf v1.18.0
+🏷️ applications
+💻 all
+
+[sensu]: https://sensu.io
+
+## Global configuration options <!-- @/docs/includes/plugin_config.md -->
+
+In addition to the plugin-specific configuration settings, plugins support
+additional global and plugin configuration settings. These settings are used to
+modify metrics, tags, and field or create aliases and configure ordering, etc.
+See the [CONFIGURATION.md][CONFIGURATION.md] for more details.
+
+[CONFIGURATION.md]: ../../../docs/CONFIGURATION.md#plugins
+
+## Configuration
+
+```toml @sample.conf
+# Send aggregate metrics to Sensu Monitor
+[[outputs.sensu]]
+  ## BACKEND API URL is the Sensu Backend API root URL to send metrics to
+  ## (protocol, host, and port only). The output plugin will automatically
+  ## append the corresponding backend API path
+  ## /api/core/v2/namespaces/:entity_namespace/events/:entity_name/:check_name).
+  ##
+  ## Backend Events API reference:
+  ## https://docs.sensu.io/sensu-go/latest/api/events/
+  ##
+  ## AGENT API URL is the Sensu Agent API root URL to send metrics to
+  ## (protocol, host, and port only). The output plugin will automatically
+  ## append the correspeonding agent API path (/events).
+  ##
+  ## Agent API Events API reference:
+  ## https://docs.sensu.io/sensu-go/latest/api/events/
+  ##
+  ## NOTE: if backend_api_url and agent_api_url and api_key are set, the output
+  ## plugin will use backend_api_url. If backend_api_url and agent_api_url are
+  ## not provided, the output plugin will default to use an agent_api_url of
+  ## http://127.0.0.1:3031
+  ##
+  # backend_api_url = "http://127.0.0.1:8080"
+  # agent_api_url = "http://127.0.0.1:3031"
+
+  ## API KEY is the Sensu Backend API token
+  ## Generate a new API token via:
+  ##
+  ## $ sensuctl cluster-role create telegraf --verb create --resource events,entities
+  ## $ sensuctl cluster-role-binding create telegraf --cluster-role telegraf --group telegraf
+  ## $ sensuctl user create telegraf --group telegraf --password REDACTED
+  ## $ sensuctl api-key grant telegraf
+  ##
+  ## For more information on Sensu RBAC profiles & API tokens, please visit:
+  ## - https://docs.sensu.io/sensu-go/latest/reference/rbac/
+  ## - https://docs.sensu.io/sensu-go/latest/reference/apikeys/
+  ##
+  # api_key = "${SENSU_API_KEY}"
+
+  ## 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
+
+  ## Timeout for HTTP message
+  # timeout = "5s"
+
+  ## HTTP Content-Encoding for write request body, can be set to "gzip" to
+  ## compress body or "identity" to apply no encoding.
+  # content_encoding = "identity"
+
+  ## NOTE: Due to the way TOML is parsed, tables must be at the END of the
+  ## plugin definition, otherwise additional config options are read as part of
+  ## the table
+
+  ## Sensu Event details
+  ##
+  ## Below are the event details to be sent to Sensu.  The main portions of the
+  ## event are the check, entity, and metrics specifications. For more information
+  ## on Sensu events and its components, please visit:
+  ## - Events - https://docs.sensu.io/sensu-go/latest/reference/events
+  ## - Checks -  https://docs.sensu.io/sensu-go/latest/reference/checks
+  ## - Entities - https://docs.sensu.io/sensu-go/latest/reference/entities
+  ## - Metrics - https://docs.sensu.io/sensu-go/latest/reference/events#metrics
+  ##
+  ## Check specification
+  ## The check name is the name to give the Sensu check associated with the event
+  ## created. This maps to check.metadata.name in the event.
+  [outputs.sensu.check]
+    name = "telegraf"
+
+  ## Entity specification
+  ## Configure the entity name and namespace, if necessary. This will be part of
+  ## the entity.metadata in the event.
+  ##
+  ## NOTE: if the output plugin is configured to send events to a
+  ## backend_api_url and entity_name is not set, the value returned by
+  ## os.Hostname() will be used; if the output plugin is configured to send
+  ## events to an agent_api_url, entity_name and entity_namespace are not used.
+  # [outputs.sensu.entity]
+  #   name = "server-01"
+  #   namespace = "default"
+
+  ## Metrics specification
+  ## Configure the tags for the metrics that are sent as part of the Sensu event
+  # [outputs.sensu.tags]
+  #   source = "telegraf"
+
+  ## Configure the handler(s) for processing the provided metrics
+  # [outputs.sensu.metrics]
+  #   handlers = ["influxdb","elasticsearch"]
+```