Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 19 additions & 6 deletions metrics.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,14 +20,17 @@

| Name | Type | Usage | Sample collection event | Labels | Buckets | Lantern | Qlean | Ream | Zeam |
|--------|-------|-------|-------------------------|--------|---------|----------|----------|----------|----------|
| `lean_pq_sig_individual_signatures_total` | Counter | Total number of individual attestation signatures | On gossip attestation | | | □ | □ | □ | □ |
| `lean_pq_sig_individual_signatures_valid_total`| Counter | Total number of valid individual attestation signatures | On gossip attestation | | | □ | □ | □ | □ |
| `lean_pq_sig_individual_signatures_invalid_total`| Counter | Total number of invalid individual attestation signatures | On gossip attestation | | | □ | □ | □ | □ |
| `lean_pq_sig_attestation_signing_time_seconds` | Histogram | Time taken to sign an attestation | On each attestation signing | | 0.005, 0.01, 0.025, 0.05, 0.1, 1 | □ | □ | ✅ | □ |
| `lean_pq_sig_attestation_verification_time_seconds` | Histogram | Time taken to verify an attestation signature | On each `signature.verify()` on an attestation | | 0.005, 0.01, 0.025, 0.05, 0.1, 1 | □ | □ | ✅ | □ |
| `lean_pq_sig_aggregated_signatures_total` | Counter | Total number of aggregated signatures | On aggregated signature production | | | □ | □ | □ | □ |
| `lean_pq_sig_attestations_in_aggregated_signatures_total` | Counter | Total number of attestations included into aggregated signatures | On aggregated attestation production | | | □ | □ | □ | □ |
| `lean_pq_sig_attestation_signatures_building_time_seconds` | Histogram | Time taken to build an aggregated attestation signature | On aggregated signature production | | 0.005, 0.01, 0.025, 0.05, 0.1, 1 | □ | □ | □ | □ |
| `lean_pq_sig_aggregated_signatures_verification_time_seconds` | Histogram | Time taken to verify an aggregated attestation signature | On validate aggregated signature | | 0.005, 0.01, 0.025, 0.05, 0.1, 1 | □ | □ | □ | □ |
| `lean_pq_sig_attestation_verification_time_seconds` | Histogram | Time taken to verify an attestation signature | On each attestation signature verification | | 0.005, 0.01, 0.025, 0.05, 0.1, 1 | □ | □ | ✅ | □ |
| `lean_pq_sig_aggregated_signatures_total` | Counter | Total number of aggregated signatures | On aggregated signature production | | | □ | □ | □ | □ |
| `lean_pq_sig_aggregated_signatures_valid_total`| Counter | Total number of valid aggregated signatures | On validate aggregated signature | | | □ | □ | □ | □ |
| `lean_pq_sig_aggregated_signatures_invalid_total`| Counter | Total number of invalid aggregated signatures | On validate aggregated signature | | | □ | □ | □ | □ |
| `lean_pq_sig_attestations_in_aggregated_signatures_total` | Counter | Total number of attestations included into aggregated signatures | On aggregated signature production | | | □ | □ | □ | □ |
| `lean_pq_sig_attestation_signatures_building_time_seconds` | Histogram | Time taken to build an aggregated attestation signature | On aggregated signature production | | 0.005, 0.01, 0.025, 0.05, 0.1, 1 | □ | □ | □ | □ |
| `lean_pq_sig_aggregated_signatures_verification_time_seconds` | Histogram | Time taken to verify an aggregated attestation signature | On validate aggregated signature | | 0.005, 0.01, 0.025, 0.05, 0.1, 1 | □ | □ | □ | □ |

## Fork-Choice Metrics

Expand All @@ -42,6 +45,13 @@
|`lean_attestation_validation_time_seconds`| Histogram | Time taken to validate attestation | On validate attestation | | 0.005, 0.01, 0.025, 0.05, 0.1, 1 | ✅ | ✅ | ✅ | □ |
| `lean_fork_choice_reorgs_total` | Counter | Total number of fork choice reorgs | On fork choice reorg | | | □ | □ | □ | □ |
| `lean_fork_choice_reorg_depth` | Histogram | Depth of fork choice reorgs (in blocks) | On fork choice reorg | | 1, 2, 3, 5, 7, 10, 20, 30, 50, 100 | □ | □ | □ | □ |
| `lean_gossip_signatures_count` | Gauge | Current number of gossip signatures in fork-choice store | On gossip signatures update | | | □ | □ | □ | □ |
| `lean_latest_new_aggregated_payloads_count` | Gauge | Current number of new aggregated payloads | On new aggregated payloads update | | | □ | □ | □ | □ |
| `lean_latest_known_aggregated_payloads_count` | Gauge | Current number of known aggregated payloads | On known aggregated payloads update | | | □ | □ | □ | □ |
| `lean_committee_signatures_aggregation_time_seconds` | Histogram | Time taken to aggregate committee signatures | On committee signatures aggregation | | 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 0.75, 1 | □ | □ | □ | □ |
|`lean_committee_aggregated_attestations_total`| Counter | total number of aggregated attestations produced by committee aggregation | On committee signatures aggregation | | | □ | □ | □ | □ |



## State Transition Metrics

Expand All @@ -62,11 +72,14 @@
| Name | Type | Usage | Sample collection event | Labels | Lantern | Qlean | Ream | Zeam |
|--------|-------|-------|-------------------------|--------|----------|----------|----------|----------|
|`lean_validators_count`| Gauge | Number of validators managed by a node | On scrape | | ✅ | ✅ | ✅ | ✅ |
|`lean_is_aggregator`| Gauge | Validator's `is_aggregator` status. True=1, False=0 | On change `is_aggregator` | | □ | □ | □ | □ |

## Network Metrics

| Name | Type | Usage | Sample collection event | Labels | Lantern | Qlean | Ream | Zeam |
|--------|-------|-------|-------------------------|--------|----------|----------|----------|----------|
|`lean_connected_peers`| Gauge | Number of connected peers | On scrape | client=lantern,qlean,ream,zeam | □ | 📝 | ✅ | □ |
|`lean_peer_connection_events_total`| Counter | Total number of peer connection events | On peer connection | direction=inbound,outbound<br>result=success,timeout,error | □ | □ | 📝 | □ |
|`lean_peer_disconnection_events_total`| Counter | Total number of peer disconnection events | On peer disconnection | direction=inbound,outbound<br>reason=timeout,remote_close,local_close,error | □ | □ | 📝 | □ |
|`lean_peer_disconnection_events_total`| Counter | Total number of peer disconnection events | On peer disconnection | direction=inbound,outbound<br>reason=timeout,remote_close,local_close,error | □ | □ | 📝 | □ |
|`lean_committee_attestation_subnet`| Gauge | Current commitee's attestation subnet | On node start | | □ | □ | □ | □ |
|`lean_committee_attestation_subnets_count`| Gauge | Number of commitee's attestation subnets, `ATTESTATION_COMMITTEE_COUNT` | On node start | | □ | □ | □ | □ |