2020-10-22 23:53:08 +08:00
|
|
|
# Logz.io Output Plugin
|
|
|
|
|
|
|
|
|
|
This plugin sends metrics to Logz.io over HTTPs.
|
|
|
|
|
|
2022-10-27 03:58:36 +08:00
|
|
|
## 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.
|
|
|
|
|
|
2023-01-12 23:55:21 +08:00
|
|
|
[CONFIGURATION.md]: ../../../docs/CONFIGURATION.md#plugins
|
2022-10-27 03:58:36 +08:00
|
|
|
|
2023-02-03 00:31:23 +08:00
|
|
|
## Secret-store support
|
|
|
|
|
|
|
|
|
|
This plugin supports secrets from secret-stores for the `token` option.
|
|
|
|
|
See the [secret-store documentation][SECRETSTORE] for more details on how
|
|
|
|
|
to use them.
|
|
|
|
|
|
|
|
|
|
[SECRETSTORE]: ../../../docs/CONFIGURATION.md#secret-store-secrets
|
|
|
|
|
|
2021-11-25 02:47:33 +08:00
|
|
|
## Configuration
|
2020-10-22 23:53:08 +08:00
|
|
|
|
2022-05-25 22:48:59 +08:00
|
|
|
```toml @sample.conf
|
2020-10-22 23:53:08 +08:00
|
|
|
# A plugin that can send metrics over HTTPs to Logz.io
|
|
|
|
|
[[outputs.logzio]]
|
2022-06-23 03:33:58 +08:00
|
|
|
## Connection timeout, defaults to "5s" if not set.
|
|
|
|
|
# timeout = "5s"
|
2020-10-22 23:53:08 +08:00
|
|
|
|
2022-06-23 03:33:58 +08:00
|
|
|
## Optional TLS Config
|
|
|
|
|
# tls_ca = "/etc/telegraf/ca.pem"
|
|
|
|
|
# tls_cert = "/etc/telegraf/cert.pem"
|
|
|
|
|
# tls_key = "/etc/telegraf/key.pem"
|
2020-10-22 23:53:08 +08:00
|
|
|
|
|
|
|
|
## Logz.io account token
|
2022-06-23 03:33:58 +08:00
|
|
|
token = "your logz.io token" # required
|
2020-10-22 23:53:08 +08:00
|
|
|
|
|
|
|
|
## Use your listener URL for your Logz.io account region.
|
|
|
|
|
# url = "https://listener.logz.io:8071"
|
|
|
|
|
```
|
|
|
|
|
|
2021-11-25 02:47:33 +08:00
|
|
|
### Required parameters
|
2020-10-22 23:53:08 +08:00
|
|
|
|
|
|
|
|
* `token`: Your Logz.io token, which can be found under "settings" in your account.
|
|
|
|
|
|
2021-11-25 02:47:33 +08:00
|
|
|
### Optional parameters
|
2020-10-22 23:53:08 +08:00
|
|
|
|
|
|
|
|
* `check_disk_space`: Set to true if Logz.io sender checks the disk space before adding metrics to the disk queue.
|
|
|
|
|
* `disk_threshold`: If the queue_dir space crosses this threshold (in % of disk usage), the plugin will start dropping logs.
|
|
|
|
|
* `drain_duration`: Time to sleep between sending attempts.
|
|
|
|
|
* `queue_dir`: Metrics disk path. All the unsent metrics are saved to the disk in this location.
|
2021-11-25 02:47:33 +08:00
|
|
|
* `url`: Logz.io listener URL.
|
