diff --git a/docs/finality-provider-operation.md b/docs/finality-provider-operation.md index e248a41c..7785213d 100644 --- a/docs/finality-provider-operation.md +++ b/docs/finality-provider-operation.md @@ -634,4 +634,30 @@ removal from the active set. > ⚠️ **Critical**: Slashing is irreversible and results in > permanent removal from the network. - +### 5.5 Prometheus + +The finality provider exposes Prometheus metrics for monitoring your +finality provider. The metrics endpoint is configurable in `fpd.conf`: + +#### Core Metrics + +1. **Status for Finality Providers** + - `fp_status`: Current status of a finality provider + - `babylon_tip_height`: The current tip height of the Babylon network + - `last_polled_height`: The most recent block height checked by the poller + +2. **Key Operations** + - `fp_seconds_since_last_vote`: Seconds since the last finality sig vote + - `fp_seconds_since_last_randomness`: Seconds since the last public + randomness commitment + - `fp_total_failed_votes`: The total number of failed votes + - `fp_total_failed_randomness`: The total number of failed + randomness commitments + +Each metric with `fp_` prefix includes the finality provider's BTC public key +hex as a label. + +> 💡 **Tip**: Monitor these metrics to detect issues before they lead to jailing: +> - Large gaps in `fp_seconds_since_last_vote` +> - Increasing `fp_total_failed_votes` +