|ZPOOL_INFLUXDB(8)||System Manager's Manual||ZPOOL_INFLUXDB(8)|
collect ZFS pool statistics in InfluxDB line protocol
InfluxDB-line-protocol-compatible metrics from zpools. Like the
zpool_influxdb reads the current pool status and
statistics. Unlike the
zpool command which is
intended for humans,
zpool_influxdb formats the
output in the InfluxDB line protocol. The expected use is as a plugin to a
metrics collector or aggregator, such as Telegraf.
zpool_influxdb prints pool
metrics and status in the InfluxDB line protocol format. All pools are
printed, similar to the
status command. Providing a pool name restricts the
output to the named pool.
- Run in daemon mode compatible with Telegraf's
execdplugin. In this mode, the pools are sampled every time a newline appears on the standard input.
- Do not print latency and I/O size histograms. This can reduce the total amount of data, but one should consider the value brought by the insights that latency and I/O size distributions provide. The resulting values are suitable for graphing with Grafana's heatmap plugin.
- Accumulates bucket values. By default, the values are not accumulated and
the raw data appears as shown by
iostat. This works well for Grafana's heatmap plugin. Summing the buckets produces output similar to Prometheus histograms.
- Adds specified tags to the tag set. No sanity checking is performed. See the InfluxDB Line Protocol format documentation for details on escaping special characters used in tags.
- Print a usage summary.
zpool-iostat(8), zpool-status(8), InfluxDB, Telegraf, Grafana, Prometheus
|May 26, 2021||Debian|