Front Next.js¶
Le front (namespace frontend, 2 à 4 réplicas) sert l'espace joueur, le portail manager et le BFF qui appelle CTFd.
Symptômes¶
FrontendHigh5xxRatio: plus de 5 % d'erreurs 5xx.FrontendCtfdSlow: les appels BFF vers CTFd ont un p95 supérieur à 2 s.FrontendMetricsMissing: les métriquespad_frontend_*sont absentes (le scale KEDA devient aveugle).- Les joueurs sont déconnectés ou voient des erreurs après une rotation de secret.
Alertes concernées¶
| Alerte | Sévérité | Durée | Résumé |
|---|---|---|---|
FrontendCtfdSlow |
warning | 10m | Les appels du BFF vers CTFd sont lents (p95 > 2 s) |
FrontendHigh5xxRatio |
warning | 10m | Plus de 5 % d'erreurs 5xx sur le front |
FrontendMetricsMissing |
warning | 15m | Les métriques du front sont absentes |
Expressions PromQL
Diagnostic¶
export KUBECONFIG="$PWD/.state/kubeconfig"
kubectl -n frontend get pods,scaledobject
kubectl -n frontend logs deploy/frontend --tail=100
curl -s https://ctf.example.net/api/health
# Latence et erreurs côté CTFd
kubectl -n ctfd get pods
kubectl -n ctfd logs deploy/ctfd --tail=50
Remédiation¶
- 5xx à cause de CTFd : voir CTFd. Le BFF ne masque pas une panne de CTFd.
- 401/403 sur
/api/v1/sso/session: le secret HMACPAD_SSO_SHARED_SECRETdiffère entre le front et CTFd (rotation incomplète). Voir la procédure de rotation. - Connexion OIDC en échec : Authentik est-il joignable ? Voir Authentik.
- Valkey indisponible : le front retombe sur une mémoire locale (token CTFd par replica) mais perd verrous et partages ;
kubectl -n storage get pods. - OOM / redémarrages : Charges Kubernetes.
- Métriques absentes : l'endpoint
/api/metricsexigeMETRICS_TOKENen production ; vérifier que le ServiceMonitor porte le bon token.
Escalade¶
Si le front est totalement indisponible, les joueurs n'ont plus d'accès : l'interface d'administration brute de CTFd (ctfd-admin, via NetBird staff) permet aux organisateurs de garder la main.
Retour à l'index des runbooks.