This document serves as a place of discussion for the metrics that each client must track when participating in the PQ Interop.

Ream currently tracks the following metrics in it's Grafana Dashboard:

| Name | Metric type | Usage |
| ----------------------------- | ----------- | ---------------------------------- |
| `lean_finalized_slot` | Gauge | Current finalized slot |
| `lean_justified_slot` | Gauge | Current justified slot |
| `lean_head_slot` | Gauge | Latest slot of the lean chain |
| `lean_propose_block_time_sum` | Bar Chart | Block proposal time (over slot) |

The following metrics are from [beacon interop metrics](https://github.com/ethereum/beacon-metrics/blob/master/metrics.md) and could be used a source of reference in deciding metrics for this interop:

| Name | Metric type | Usage |
| ---------------------------------- | ----------- | --------------------------------------- |
| `libp2p_peers` | Gauge | Tracks the total number of libp2p peers |
| `beacon_head_slot` | Gauge | Latest slot of the beacon chain |
| `beacon_finalized_epoch` | Gauge | Current finalized epoch |
| `beacon_current_justified_epoch` | Gauge | Current justified epoch |
| `beacon_previous_justified_epoch` | Gauge | Current previously justified epoch |
| `beacon_current_active_validators` | Gauge | Current total active validators |
| `beacon_reorgs_total` | Counter | Total number of chain reorganizations |
| `beacon_processed_deposits_total` | Gauge | Total number of deposits processed |

Proposed Action on Beacon Metrics for Lean Metrics:

1. `libp2p_peers`: We should track this in leanMetrics
2. `beacon_head_slot`: Tracked in lean as `lean_head_slot`
3. `beacon_finalized_epoch`: No more epoch tracking, current finalized slot is tracked as `lean_finalized_slot`
4. `beacon_current_justified_epoch`: Current justified slot should be tracked as `lean_current_justified_slot`
5. `beacon_previous_justified_epoch`: Previous justified slot should be tracked as `lean_previous_justified_slot`
6. `beacon_current_active_validators`: Should track in lean as `lean_current_active_validators`
7. `beacon_reorgs_total`: Could be tracked as `lean_reorgs_total`
8. `beacon_processed_deposits_total`: TBD

## Proposed Interop Metrics

| Name | Metric type | Usage |
| ---------------------------------- | ----------- | --------------------------------------- |
| `libp2p_peers` | Gauge | Tracks the total number of libp2p peers |
| `lean_head_slot` | Gauge | Latest slot of the lean chain |
| `lean_finalized_slot` | Gauge | Current finalized slot |
| `lean_justified_slot` | Gauge | Current justified slot |
| `lean_previous_justified_slot` | Gauge | Current previously justified slot |
| `lean_current_active_validators` | Gauge | Current total active validators |
| `lean_reorgs_total` | Counter | Total number of chain reorganizations |
| `lean_processed_deposits_total` | Gauge | Total number of deposits processed |

## Ream's Current PQ Devnet Dashboard