Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ZPOOL_INFLUXDB(8)	    System Manager's Manual	     ZPOOL_INFLUXDB(8)

NAME
       zpool_influxdb -- collect ZFS pool statistics in	InfluxDB line protocol
       format

SYNOPSIS
       zpool_influxdb		  [-e|--execd]		   [-n|--no-histogram]
		      [-s|--sum-histogram-buckets]
		      [-t|--tags key=value[,key=value]]	[pool]

DESCRIPTION
       zpool_influxdb produces InfluxDB-line-protocol-compatible metrics  from
       zpools.	 Like the zpool	command, 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	proto-
       col.  The expected use is as a plugin to	a metrics collector or	aggre-
       gator, such as Telegraf.

       By  default,  zpool_influxdb  prints pool metrics and status in the In-
       fluxDB line protocol format.  All pools are  printed,  similar  to  the
       zpool  status  command.	 Providing a pool name restricts the output to
       the named pool.

OPTIONS
       -e, --execd  Run	in daemon mode compatible with Telegraf's  execd  plu-
		    gin.   In  this  mode,  the	pools are sampled every	time a
		    newline appears on the standard input.

       -n, --no-histogram
		    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.

       -s, --sum-histogram-buckets
		    Accumulates	bucket values.	By default, the	values are not
		    accumulated	and the	raw data appears  as  shown  by	 zpool
		    iostat.   This  works  well	 for Grafana's heatmap plugin.
		    Summing the	buckets	produces output	similar	to  Prometheus
		    histograms.

       -t, --tags key=value[,key=value]
		    Adds specified tags	to the tag set.	 No sanity checking is
		    performed.	See the	InfluxDB Line Protocol format documen-
		    tation  for	details	on escaping special characters used in
		    tags.

       -h, --help   Print a usage summary.

SEE ALSO
       zpool-iostat(8),		      zpool-status(8),		     InfluxDB:
       https://github.com/influxdata/influxdb,			     Telegraf:
       https://github.com/influxdata/telegraf,	Grafana:  https://grafana.com,
       Prometheus: https://prometheus.io

FreeBSD	13.2			 May 26, 2021		     ZPOOL_INFLUXDB(8)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=zpool_influxdb&sektion=8&manpath=FreeBSD+14.0-RELEASE+and+Ports>

home | help