Circonus Output Plugin
This plugin writes metrics data to the Circonus platform. In order to use this
plugin, an HTTPTrap check must be configured on a Circonus broker. This check
can be automatically created by the plugin or manually configured (see the
plugin configuration information). For information about Circonus HTTPTrap
check configuration click here.
Configuration
[[outputs.circonus]]
## Circonus API Configuration, this is required for automatic check creation
## and automatic check lookup, and retrieving broker CA information.
## An API token must be provided to use this plugin:
api_token = "11223344-5566-7788-9900-aabbccddeeff"
## If not provided, the api URL will default to the Circonus SaaS API URL:
# api_url = "https://api.circonus.com/"
## If not provided, the API application used will default to circonus-unified-agent:
# api_app = "circonus-unified-agent"
## Optional API TLS Configuration:
# api_tls_ca = "/etc/circonus-unified-agent/circonus_api_ca.pem"
## Check name prefix - unique prefix to use for all checks created by this instance
## default is the hostname from the OS.
# check_name_prefix = "example"
## One check - all metrics go to a single check vs one check per input plugin
# one_check = false
## Broker
## Optional: explicit broker id or blank (default blank, auto select)
## example:
# broker = "/broker/35"
Configuration Options
Setting |
Description |
api_token |
The authentication token to used when connecting to the Circonus API. It is recommended to create a token/application combination specifically for use with this plugin. This is required. |
api_url |
The URL that can be used to connect to the Circonus API. This will default to the Circonus SaaS API URL if not provided. |
api_app |
The API token application to use when connecting to the Circonus API. This will default to circonus-unified-agent if not provided. |
api_tls_ca |
The certificate authority file to use when connecting to the Circonus API, if needed. |
check_name_prefix |
Unique prefix to use for all checks created by this instance. Default is the host name from the OS. |
one_check |
Send all metrics to one single check. Default is one check per active plugin. |
broker |
The CID of a Circonus broker to use when automatically creating a check. If omitted, then a random eligible broker will be selected. |