btcnode-metrics 2.0.0

The Bitcoin node metrics exporter for Prometheus built on the Rust Bitcoin Community's corepc-client crate.
btcnode-metrics-2.0.0 is not a library.

btcnode-metrics

The best Bitcoin node metrics exporter for Prometheus based on corepc-client.

Install & Configure

Install

cargo install btcnode-metrics

Configure

After installing btcnode-metrics,

  • Copy config.toml.example to config.local.toml.
  • Edit config.local.toml
    • the node section is for the Bitcoin node to monitor
    • the server section is for exposing the endpoint for Prometheus

Usage

To run:

cargo run -- -c ./config.local.toml

For additional output, set the [logging level(https://docs.rs/env_logger/latest/env_logger/)]:

RUST_LOG=info cargo run -- -c ./config.local.toml

Additional Details

About corepc-client

The corepc-client crate replaces the previous the Bitcoin node RPC crates that were archived on 11/25/2025:

The Rust Bitcoin Community's public repository for this crate is at corepc-client.

Code structure

This repository's code is separated into:

  • btcnode-metrics implements the API for Prometheus to call for gathering metrics.
  • btcnode-metrics gathers metrics from the Bitcoin node and transforms them into Prometheus format.