Build your own dashboards

This page explains how to create your own dashboards using StereumLabs data and conventions. It covers data access and custom labels.

If you need the official dashboards instead, see: Dashboards.

Goals

Enable operators, client teams, and researchers to tailor views to their needs.

Operator views: resource saturation, headroom, alert-focused panels.
Client team views: pipeline timings (import/execute/write), DB/FS behavior.
Research views: propagation, mempool dynamics, reorg signals (non-staking).
Environment studies: cloud vs. bare-metal profiles, kernel/filesystem tuning impact.

Staking-focused panels (participation, inclusion delay, missed duties) will be documented separately when available.

StereumLabs offers a set of different data sources to build dashboards with.

prometheus-free: prometheus data source available to Free subscribers.
prometheus-cold: prometheus data source covering all available metrics without retention or delay restrictions.
- prometheus-node-exporter: per-machine metrics for cpu, memory, storage and more; details at https://github.com/prometheus/node_exporter
- client metrics of the respective client
elasticsearch access to logs of respective clients

Prometheus data sources usually provide a 15 seconds time scrap interval.

For more details about the features and accessibility of data please review the Plans page.

To keep building dashboards on StereumLabs easy, we offer a variety of helpful labels on the prometheus metrics:

ec_client: name of the execution client
ec_version: version of the execution client
cc_client: name of the consensus client
cc_version: version of the consensus client
role: what client to look at
- ec: filter for execution client
- cc: filter for consensus client
tba_config_name: refers to a specific scenario (e.g., VM specs, geolocation, client params)

To give an example:

p2p_peer_count{cc_client="prysm", cc_version="v6.1.3", ec_client="nethermind", ec_version="1.35.0", role="cc"}

Returns peers metrics of prym 6.1.3 which runs with nethermind 1.35.0.

Send a short proposal via TBA with audience, metrics, and a link.
We can list or link high-quality community dashboards once labels/units/definitions match this page.

Change control for this page: material edits will be logged in the global Changelog with a short rationale and effective date.