Prometheus Metrics
Pebblify can expose real-time conversion metrics via a Prometheus-compatible HTTP endpoint. Enable it with the --metrics flag on the level-to-pebble or recover commands.
Enable Metrics
pebblify level-to-pebble --metrics ~/.gaia/data ./gaia-pebble
pebblify level-to-pebble --metrics --metrics-port 2112 ~/.gaia/data ./gaia-pebble
Options
| Flag | Description |
|---|---|
--metrics | Enable the Prometheus metrics exporter |
--metrics-port P | Port for the metrics server (default: 9090) |
Endpoint
Metrics are served at GET /metrics in the standard Prometheus exposition format.
curl http://localhost:9090/metrics
Available Metrics
| Metric | Type | Description |
|---|---|---|
pebblify_keys_processed_total | Counter | Total number of keys processed |
pebblify_bytes_read_total | Counter | Total bytes read from LevelDB |
pebblify_bytes_written_total | Counter | Total bytes written to PebbleDB |
pebblify_databases_total | Gauge | Number of databases by status (label: status) |
pebblify_keys_per_second | Gauge | Current key processing throughput |
pebblify_bytes_per_second | Gauge | Current byte processing throughput |
pebblify_batch_commits_total | Counter | Total batch commits performed |
pebblify_checkpoints_total | Counter | Total checkpoints saved |
Prometheus Scrape Config
scrape_configs:
- job_name: "pebblify"
static_configs:
- targets: ["localhost:9090"]
Combined with Health Probes
Health probes and metrics can be enabled simultaneously on separate ports:
pebblify level-to-pebble \
--health --health-port 8086 \
--metrics --metrics-port 9090 \
~/.gaia/data ./gaia-pebble