# Admin V2 - Monitoring Guide

## Goal

Track V2 route health during progressive rollout and detect regressions before broad enablement.

## Required Signals

- Error rate on `/admin/v2*` routes
- P95/P99 latency on:
  - `/admin/v2`
  - `/admin/v2/cardex/*`
  - `/admin/v2/orders`
  - `/admin/v2/catalog`
- 4xx spikes (403/404) during cohort rollout
- Livewire request failure count on V2 pages

## Recommended Dashboards

1. **V2 Request Health**
- requests/min by route
- 5xx rate by route
- median + P95 latency by route

2. **V2 Business Workflow Health**
- draft order saves from V2 workstation
- payment link generation success/failure
- invoice generation/send success/failure

3. **Access Rollout Health**
- allowed vs denied V2 accesses
- denied by role (coordinator, others)
- denied by feature gate (not in cohort)

## Alert Rules (Initial)

- `critical`: `/admin/v2*` 5xx > 2% over 5 min
- `warning`: P95 latency > 1500ms over 15 min on dashboard/cardex pages
- `warning`: payment link generation failures > 5 in 10 min
- `warning`: invoice generation failures > 3 in 10 min

## Rollout Steps

1. Enable cohort allowlist for internal managers only.
2. Observe 24h: error rate + latency.
3. Expand to selected place managers.
4. Enable global flag when metrics are stable.