IoTDB Server Exporter

Prometheus exporter for IoTDB server metrics.

Supported version: 0.11.0.

Running (Linux)

export IOTDB_PASSWORD=root
./prometheus-iotdb-exporter <flags>

Running (Windows)

set IOTDB_PASSWORD=root
prometheus-iotdb-exporter.exe <flags>

Then go to localhost:8092 to see your metrics.

Flags

Name	Description	Default
listenPort	exporter listening port	8092
iotDBHost	IoTDB server host	127.0.0.1
iotDBPort	IoTDB server port	6667
iotDBUsername	IoTDB username	root

For security reasons the server password needs to be set by using IOTDB_PASSWORD environment variable.

Metrics

Name	Metric Name	Description
Write Ahead File Size	iotdb_write_ahead_file_size_bytes	Write Ahead File Size (extracted from the root.stats.file_size.WAL time series) in bytes. For this metric to be collected the enable_stat_monitor option must be enabled in the /iotdb/conf/iotdb-engine.properties config file. To update the config file check the server_example folder.
System File Size	iotdb_system_file_size_bytes	System File Size (extracted from the root.stats.file_size.SYS time series) in bytes. For this metric to be collected the enable_stat_monitor option must be enabled in the /iotdb/conf/iotdb-engine.properties config file. To update the config file check the server_example folder.
Storage Group Count	iotdb_storage_groups	Storage group count
Timeseries Count	iotdb_time_series	Timeseries (across all storage groups) count
Users Count	iotdb_users	Database users count

Docker

You can deploy this exporter by using the fagner/prometheus-iotdb-exporter Docker image.

docker pull fagner/prometheus-iotdb-exporter

docker run -d -p "2000:8092" --name iotdb-exporter fagner/prometheus-iotdb-exporter

Or clone the repo and run the following commands.

docker build -t iotdb-exporter .
docker run -d -p "2000:8092" --name iotdb-exporter iotdb-exporter