Solana Validator Exporter

This is a Prometheus exporter for Solana validators that supports monitoring multiple validators across different networks (mainnet, testnet, devnet).

Features

• Multi-Network Support: Monitor validators on mainnet, testnet, and devnet simultaneously
• Multi-Validator Support: Monitor multiple validators per network
• Comprehensive Metrics: Track validator performance, financial metrics, and network statistics
• Network Labels: All metrics include network and vote account labels for easy identification

Setup

1. Create a configuration file.

   Copy the config.example.yaml to config.yaml and update the values:

   cp config.example.yaml config.yaml

   Then, edit config.yaml:

   Global Configuration

   • port: The port the exporter will listen on (e.g., 9090).

   Network RPC URLs (at least one required)

   • rpc_url_mainnet: The RPC URL for Solana mainnet (e.g., https://api.mainnet-beta.solana.com).
   • rpc_url_testnet: The RPC URL for Solana testnet (optional).
   • rpc_url_devnet: The RPC URL for Solana devnet (optional).

   Validator Accounts (at least one validator configuration required)

   • mainnet_vote_account & mainnet_identity_account: Your mainnet validator's vote and identity account public keys.
   • testnet_vote_account & testnet_identity_account: Your testnet validator's accounts (optional).
   • devnet_vote_account & devnet_identity_account: Your devnet validator's accounts (optional).

   Note: The naming convention determines which RPC URL is used (e.g., mainnet_* accounts use rpc_url_mainnet).

Running the Exporter

You have two options to run the exporter: direct build or Docker container.

Option 1: Direct Build

1. Install Rust (if not already installed):

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

2. Build the exporter:

   cargo build --release

3. Run the exporter:

   ./target/release/solana-validator-exporter --config-file config.yaml

Option 2: Docker Container

1. Build the Docker image:

   docker build -t solana-validator-exporter -f docker/Dockerfile .

2. Run the container:

   docker run -d \
     --name solana-validator-exporter \
     -p 9090:9090 \
     -v $(pwd)/config.yaml:/home/exporter/config.yaml \
     solana-validator-exporter --config-file /home/exporter/config.yaml

Verifying the Exporter

After running either method, you can verify the exporter is working by accessing the metrics endpoint:

curl http://localhost:9090/metrics

The exporter will expose metrics on the port specified in your configuration file (e.g., http://localhost:9090/metrics).

Metrics Labels

All metrics now include the following labels for easy filtering and identification:

• network: The Solana network (mainnet, testnet, or devnet)
• vote_account: The validator's vote account public key

Example metric with labels:

solana_slot{network="mainnet",vote_account="YourVoteAccount..."} 123456789
solana_slot{network="testnet",vote_account="YourTestnetVoteAccount..."} 987654321

This allows you to create separate Grafana dashboards or alerts for different networks and validators.