traefik/docs/content/observability/metrics/influxdb.md

238 lines
3.3 KiB
Markdown
Raw Normal View History

2019-07-18 19:36:05 +00:00
# InfluxDB
To enable the InfluxDB:
```toml tab="File (TOML)"
[metrics]
[metrics.influxDB]
2019-07-18 19:36:05 +00:00
```
2019-07-22 07:58:04 +00:00
```yaml tab="File (YAML)"
2019-07-18 19:36:05 +00:00
metrics:
influxDB: {}
2019-07-18 19:36:05 +00:00
```
```bash tab="CLI"
2019-07-22 07:58:04 +00:00
--metrics.influxdb=true
2019-07-18 19:36:05 +00:00
```
#### `address`
_Required, Default="localhost:8089"_
Address instructs exporter to send metrics to influxdb at this address.
```toml tab="File (TOML)"
[metrics]
[metrics.influxDB]
2019-07-18 19:36:05 +00:00
address = "localhost:8089"
```
2019-07-22 07:58:04 +00:00
```yaml tab="File (YAML)"
2019-07-18 19:36:05 +00:00
metrics:
influxDB:
2019-07-18 19:36:05 +00:00
address: localhost:8089
```
```bash tab="CLI"
--metrics.influxdb.address=localhost:8089
2019-07-18 19:36:05 +00:00
```
#### `protocol`
_Required, Default="udp"_
InfluxDB's address protocol (udp or http).
```toml tab="File (TOML)"
[metrics]
[metrics.influxDB]
2019-09-16 13:34:05 +00:00
protocol = "udp"
2019-07-18 19:36:05 +00:00
```
2019-07-22 07:58:04 +00:00
```yaml tab="File (YAML)"
2019-07-18 19:36:05 +00:00
metrics:
influxDB:
2019-07-18 19:36:05 +00:00
protocol: udp
```
```bash tab="CLI"
--metrics.influxdb.protocol=udp
2019-07-18 19:36:05 +00:00
```
#### `database`
_Optional, Default=""_
InfluxDB database used when protocol is http.
```toml tab="File (TOML)"
[metrics]
[metrics.influxDB]
database = "db"
2019-07-18 19:36:05 +00:00
```
2019-07-22 07:58:04 +00:00
```yaml tab="File (YAML)"
2019-07-18 19:36:05 +00:00
metrics:
influxDB:
database: "db"
2019-07-18 19:36:05 +00:00
```
```bash tab="CLI"
--metrics.influxdb.database=db
2019-07-18 19:36:05 +00:00
```
#### `retentionPolicy`
_Optional, Default=""_
InfluxDB retention policy used when protocol is http.
```toml tab="File (TOML)"
[metrics]
[metrics.influxDB]
retentionPolicy = "two_hours"
2019-07-18 19:36:05 +00:00
```
2019-07-22 07:58:04 +00:00
```yaml tab="File (YAML)"
2019-07-18 19:36:05 +00:00
metrics:
influxDB:
retentionPolicy: "two_hours"
2019-07-18 19:36:05 +00:00
```
```bash tab="CLI"
--metrics.influxdb.retentionPolicy=two_hours
2019-07-18 19:36:05 +00:00
```
#### `username`
_Optional, Default=""_
InfluxDB username (only with http).
```toml tab="File (TOML)"
[metrics]
[metrics.influxDB]
username = "john"
2019-07-18 19:36:05 +00:00
```
2019-07-22 07:58:04 +00:00
```yaml tab="File (YAML)"
2019-07-18 19:36:05 +00:00
metrics:
influxDB:
username: "john"
2019-07-18 19:36:05 +00:00
```
```bash tab="CLI"
--metrics.influxdb.username=john
2019-07-18 19:36:05 +00:00
```
#### `password`
_Optional, Default=""_
InfluxDB password (only with http).
```toml tab="File (TOML)"
[metrics]
[metrics.influxDB]
password = "secret"
2019-07-18 19:36:05 +00:00
```
2019-07-22 07:58:04 +00:00
```yaml tab="File (YAML)"
2019-07-18 19:36:05 +00:00
metrics:
influxDB:
password: "secret"
2019-07-18 19:36:05 +00:00
```
```bash tab="CLI"
--metrics.influxdb.password=secret
2019-07-18 19:36:05 +00:00
```
#### `addEntryPointsLabels`
_Optional, Default=true_
Enable metrics on entry points.
```toml tab="File (TOML)"
[metrics]
[metrics.influxDB]
2019-07-18 19:36:05 +00:00
addEntryPointsLabels = true
```
2019-07-22 07:58:04 +00:00
```yaml tab="File (YAML)"
2019-07-18 19:36:05 +00:00
metrics:
influxDB:
2019-07-18 19:36:05 +00:00
addEntryPointsLabels: true
```
```bash tab="CLI"
--metrics.influxdb.addEntryPointsLabels=true
```
2021-04-30 08:22:04 +00:00
#### `AddRoutersLabels`
_Optional, Default=false_
Enable metrics on routers.
```toml tab="File (TOML)"
[metrics]
[metrics.influxDB]
addRoutersLabels = true
```
```yaml tab="File (YAML)"
metrics:
influxDB:
addRoutersLabels: true
```
```bash tab="CLI"
--metrics.influxdb.addrouterslabels=true
```
2019-07-18 19:36:05 +00:00
#### `addServicesLabels`
_Optional, Default=true_
Enable metrics on services.
```toml tab="File (TOML)"
[metrics]
[metrics.influxDB]
2019-07-18 19:36:05 +00:00
addServicesLabels = true
```
2019-07-22 07:58:04 +00:00
```yaml tab="File (YAML)"
2019-07-18 19:36:05 +00:00
metrics:
influxDB:
2019-07-18 19:36:05 +00:00
addServicesLabels: true
```
```bash tab="CLI"
--metrics.influxdb.addServicesLabels=true
```
#### `pushInterval`
_Optional, Default=10s_
The interval used by the exporter to push metrics to influxdb.
```toml tab="File (TOML)"
[metrics]
[metrics.influxDB]
2019-07-18 19:36:05 +00:00
pushInterval = 10s
```
2019-07-22 07:58:04 +00:00
```yaml tab="File (YAML)"
2019-07-18 19:36:05 +00:00
metrics:
influxDB:
2019-07-18 19:36:05 +00:00
pushInterval: 10s
```
```bash tab="CLI"
--metrics.influxdb.pushInterval=10s
```