Fighting Game · Guides & deep dives

V2 Telemetry Alerting Rules

The surface emits:

3sections1 minread
Markdown source
On this page

Phase 72.5.2.13 adds @v2/telemetry-alerting-rules, the operational alerting surface for crash spikes, player count drops, and matchmaking wait regressions.

The service composes @iris/analytics-realtime alert rule types through buildV2TelemetryAlertingRulesSurface. It evaluates aggregate telemetry samples and emits deterministic alert rows for:

  • crash-rate-spike-2x: crash rate multiplier greater than or equal to 2
  • player-count-drop-20pct: player count drop greater than or equal to 0.2
  • matchmaking-wait-time-3min: p95 matchmaking wait greater than or equal to 180 seconds

Raw account IDs are not accepted or emitted. Inputs are operational aggregates such as crash rate, baseline crash rate, current player count, baseline player count, and p95 matchmaking wait time.

Policy#

  • Policy ID: v2-telemetry-alerting-rules-v1
  • Source library: @iris/analytics-realtime
  • Rule families: crash rate spike, player count drop, matchmaking wait time
  • Thresholds: crash rate spike 2x, player count drop 20%, matchmaking wait 3 minutes
  • Privacy: aggregate samples only; raw account IDs are never exposed

Output#

The surface emits:

  • the three AlertRule definitions used by operators and gates
  • latest-sample evaluations per rule family
  • deterministic active alert rows with rule ID, severity, observed value, and threshold
  • summary counts for active, critical, and warning alerts
  • chart-ready copies of evaluations and alerts

Gates#

check-v2-telemetry-alerting-rules.py validates the contract, service package, source tokens, tests, docs, workflow wiring, Horde gates, and the Phase 72 checklist item. Required gates are telemetry-alerting-rules-service-present, telemetry-alerting-rules-crash-rate-spike, telemetry-alerting-rules-player-count-drop, telemetry-alerting-rules-matchmaking-wait, and telemetry-alerting-rules-ci-wired.

Targeted verification:

bash
pnpm --filter @v2/telemetry-alerting-rules run typecheck
pnpm --filter @v2/telemetry-alerting-rules run test
python V2/ue/Tools/check-v2-telemetry-alerting-rules.py