Influxdb stats Exporter

Prometheus exporter for InfluxDB stats, as reported by a SHOW STATS query. Tested to work with InfluxDB 1.4 and 1.5.

Not to be confused with influxdb_exporter, which accepts the InfluxDB line protocol and converts it to Prometheus format.

Metrics

The exporter will make a SHOW STATS query to InfluxDB, and report all the returned statistics as metrics. The metrics are therefore dependent on the underlying InfluxDB installation. All metrics are prefixed with influxdb.

Two meta-metrics are added by the exporter, influxdb_exporter_stats_query_duration_seconds and influxdb_exporter_stats_query_success. influxdb_exporter_stats_query_duration_seconds is a gauge showing the number of seconds it took to get a query response from InfluxDB. influxdb_exporter_stats_query_success is 1 if a valid response was received, and 0 if there was an error.

As of InfluxDB 1.5, there is a Prometheus /metrics endpoint on InfluxDB itself. However, this does not yet return any of the statistics about InfluxDB, only the Golang process-level metrics. In future developments of InfluxDB, this exporter may (hopefully) become obsolete.

Usage

./influxdb_stats_exporter launches the exporter with all default options: Querying a local Influx server, without any authentication, and serving metrics on port 9424. If you need to alter these options, see the section on flags and environment variables below.

Flags and environment variables

influxdb_stats_exporter has a number of flags to set different options, some of which can also be set with environment variables:

Name	Description	Default value	Environment variable name
--influx.url	Url to InfluxDB	http://localhost:8086	INFLUX_URL
--influx.user	Username for InfluxDB	(Not set)	INFLUX_USER
--influx.password	Password for InfluxDB	(Not set)	INFLUX_PASSWORD
--ssl.skip-verify	Skip HTTPS certificate verification	false	-
--log.level	Log level for console output	info	-
--web.listen-address	Address on which to expose metrics	:9424	-
--web.metrics-path	Path under which the metrics are available	/metrics	-