Skip to main content

Health endpoints

The node exposes CometBFT RPC on port 26657 (localhost only):

Enable Prometheus metrics

Edit config/config.toml:
Port 26660 must never be exposed publicly. Proxy through your monitoring stack over private network only.

Critical metrics

Grafana setup

1

Install Prometheus and configure scraping

Add http://localhost:26660/metrics as a scrape target.
2

Install Grafana and add data source

Add Prometheus at http://localhost:9090.
3

Import community dashboard

Dashboards → Import → Dashboard ID 11036 (Cosmos/CometBFT community dashboard).
4

Configure alerts

Set up Alertmanager alerts for validator_power = 0, peer count < 3, and block height stall.

Log monitoring

Key log patterns:

Monitoring checklist

  • Prometheus enabled and scraping successfully
  • Grafana dashboard imported (ID 11036)
  • Alert configured for validator power = 0
  • Alert configured for peer count < 3
  • Alert configured for block height stall (>60s)
  • Alert configured for RAM usage >85%
  • Log monitoring set up for error-level events