Skip to content

fagnercarvalho/prometheus-iotdb-exporter

Repository files navigation

IoTDB Server Exporter Github Actions

Go Report Card Go Reference Docker Pulls GitHub go.mod Go version Codecov

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