From 700dffc626c5e88f4c253e2960a9ceb84564621b Mon Sep 17 00:00:00 2001 From: Sam Ricotta Date: Fri, 6 Dec 2024 13:07:39 +0200 Subject: [PATCH 1/2] prometheus metrics --- docs/finality-provider-operation.md | 28 +++++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) 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` + From 715aba917b4fd587ff29fc55cce2d565b40b7759 Mon Sep 17 00:00:00 2001 From: Sam Ricotta Date: Mon, 9 Dec 2024 13:14:37 +0200 Subject: [PATCH 2/2] update metrics --- docs/finality-provider-operation.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/finality-provider-operation.md b/docs/finality-provider-operation.md index 7785213d..dcdc208e 100644 --- a/docs/finality-provider-operation.md +++ b/docs/finality-provider-operation.md @@ -661,3 +661,7 @@ hex as a label. > - Large gaps in `fp_seconds_since_last_vote` > - Increasing `fp_total_failed_votes` +For a complete list of available metrics, see: +- Finality Provider metrics: [fp_collectors.go](../metrics/fp_collectors.go) +- EOTS metrics: [eots_collectors.go](../metrics/eots_collectors.go) +