Skip to main content

Analytics

ChainLaunch provides built-in analytics for your Fabric networks through Prometheus metrics collection and Grafana dashboards.

Prerequisites

  • A running Fabric network with at least one peer or orderer
  • Monitoring configured (Prometheus + Grafana)

Enable Metrics on Nodes

Fabric peers and orderers expose Prometheus metrics when configured. ChainLaunch enables this automatically when you set up monitoring.

To verify metrics are enabled on a node, use the CLI:

chainlaunch metrics enable --version="v3.4.0" --port=9091

Or check via the API:

curl -s http://localhost:8100/api/v1/nodes | jq '.[].metrics'

Access the Analytics Dashboard

  1. Open ChainLaunch at http://localhost:8100
  2. Navigate to Analytics in the left sidebar
  3. You'll see dashboards for your active networks

The analytics page shows:

  • Transaction throughput — transactions per second across channels
  • Block generation rate — how fast new blocks are committed
  • Peer health — endorsement success/failure rates per peer
  • Orderer performance — block cut time, consensus latency
  • Resource usage — CPU, memory, and disk per node container

Key Metrics

MetricDescriptionWhat to watch
endorser_successful_proposalsSuccessful endorsementsShould increase with transaction load
broadcast_processed_countTransactions submitted to ordererMatches client submission rate
blockcutter_block_fill_durationTime to fill a blockHigh values = low throughput
ledger_block_processing_timeBlock commit latencySpikes indicate bottlenecks
gossip_membership_total_peers_knownPeers visible via gossipShould match expected peer count

Set Up Alerts

You can configure alerts in Grafana for critical conditions:

  • Peer down — no metrics received for 2+ minutes
  • High endorsement failure rateendorser_failed_proposals exceeds threshold
  • Block processing slowledger_block_processing_time > 5 seconds
  • Disk usage high — container disk > 80%

See Configure Monitoring for full Grafana alert setup.

Video Walkthrough

Next Steps