Offchain analytics and alerting for FCM health and positions

[vishalchangrani]

Context

We need an offchain analytics and monitoring service for Flow Credit Markets (FCM) to support protocol health visibility and incident alerting.

Scope

Build an offchain analytics pipeline that ingests FCM events and state, exposes prometheus metrics, and integrates with existing Grafana monitoring and alerting.

Core metrics

• Total open positions
• Positions by health factor buckets (eg >1.3, healthy, rebalancing range, liquidatable range)
• Other aggregate protocol health indicators
• Alerting requirements
  • Trigger an incident alert if any position health factor drops below 1.0
  • Alert should be high severity since this should not happen under normal operation.
  • Optional early warning alerts for rapid health factor degradation

Integration notes

• Should integrate with existing monitoring and alerting stack (Grafana preferred)
• May require adding or extending heartbeat or health check events to explicitly surface health factors below 1.0

Acceptance criteria

• Metrics visible on a Grafana dashboard
• Automated alerts fire reliably for HF < 1.0

[vishalchangrani]

• Kan, Vishal, KROK to have a kickoff call.