feat: add Prometheus alert rules and runbooks

Author: imane-ait

docs/runbooks/app-down.md

@@ -0,0 +1,54 @@
+# Runbook — AppDown
+
+## Alerte
+**Nom :** AppDown  
+**Sévérité :** Critical  
+**Condition :** `up{job="fleetops-api"} == 0` pendant 30 secondes
+
+## Symptômes
+- L'app FleetOps ne répond plus
+- `/health` retourne une erreur de connexion
+- Les utilisateurs ne peuvent plus accéder à l'API
+
+## Diagnostic
+
+### 1. Vérifier l'état des conteneurs
+```bash
+docker compose ps
+docker compose logs app --tail=50
+```
+
+### 2. Vérifier la connexion à la DB
+```bash
+curl http://localhost:8000/ready
+```
+
+### 3. Vérifier les ressources système
+```bash
+docker stats
+df -h
+free -m
+```
+
+## Remédiation
+
+### Si le conteneur est arrêté
+```bash
+docker compose up -d app
+```
+
+### Si la DB est inaccessible
+```bash
+docker compose restart db
+docker compose restart app
+```
+
+### Si manque de mémoire
+```bash
+docker compose down
+docker system prune -f
+docker compose up -d
+```
+
+## Escalade
+Si le problème persiste après 15 minutes → contacter l'équipe infrastructure.

docs/runbooks/high-error-rate.md

@@ -0,0 +1,51 @@
+# Runbook — HighErrorRate
+
+## Alerte
+**Nom :** HighErrorRate  
+**Sévérité :** Critical  
+**Condition :** plus de 5% des requêtes retournent une erreur 5xx depuis 1 minute
+
+## Symptômes
+- Les utilisateurs reçoivent des erreurs lors de leurs requêtes API
+- Le dashboard Grafana "Taux d'erreurs 5xx" dépasse 5%
+- Les logs de l'app montrent des exceptions ou stack traces
+
+## Diagnostic
+
+### 1. Regarder les logs de l'app
+```bash
+docker compose logs app --tail=100
+```
+
+### 2. Vérifier la connexion à la DB
+```bash
+curl http://localhost:8000/ready
+```
+
+### 3. Vérifier l'état des conteneurs
+```bash
+docker compose ps
+```
+
+## Remédiation
+
+### Si la DB est inaccessible
+```bash
+docker compose restart db
+docker compose restart app
+```
+
+### Si bug applicatif
+Identifier l'endpoint qui échoue dans les logs, puis rollback :
+```bash
+docker compose down
+docker compose up -d
+```
+
+### Si surcharge
+```bash
+docker compose restart app
+```
+
+## Escalade
+Si le problème persiste après 15 minutes → contacter l'équipe infrastructure et ouvrir un incident.

docs/runbooks/high-latency.md

@@ -0,0 +1,44 @@
+# Runbook — HighLatency
+
+## Alerte
+**Nom :** HighLatency  
+**Sévérité :** Warning  
+**Condition :** latence p95 > 300ms depuis 2 minutes
+
+## Symptômes
+- Les utilisateurs remarquent des temps de réponse lents
+- Le dashboard Grafana "Latence p95" dépasse 300ms
+- Les logs montrent des requêtes longues
+
+## Diagnostic
+
+### 1. Vérifier les logs de l'app
+```bash
+docker compose logs app --tail=100
+```
+
+### 2. Vérifier la charge des conteneurs
+```bash
+docker stats
+```
+
+### 3. Vérifier la connexion à la DB
+```bash
+curl http://localhost:8000/ready
+```
+
+## Remédiation
+
+### Si la DB est lente
+```bash
+docker compose restart db
+docker compose restart app
+```
+
+### Si surcharge CPU/mémoire
+```bash
+docker compose restart app
+```
+
+## Escalade
+Si le problème persiste après 15 minutes → contacter l'équipe infrastructure.

docs/runbooks/high-request-rate.md

@@ -0,0 +1,46 @@
+# Runbook — HighRequestRate
+
+## Alerte
+**Nom :** HighRequestRate  
+**Sévérité :** Warning  
+**Condition :** plus de 10 requêtes/seconde depuis 1 minute
+
+## Symptômes
+- Trafic inhabituellement élevé sur l'API
+- Dashboard Grafana "Requests per second" dépasse 10 RPS
+- Possible ralentissement de l'app
+
+## Diagnostic
+
+### 1. Identifier l'endpoint le plus appelé
+```bash
+docker compose logs app --tail=200 | grep "GET\|POST\|DELETE"
+```
+
+### 2. Vérifier si c'est légitime ou une attaque
+```bash
+docker compose logs app --tail=200 | grep "IP"
+```
+
+### 3. Vérifier la charge système
+```bash
+docker stats
+```
+
+## Remédiation
+
+### Si trafic légitime — surveiller
+```bash
+docker stats
+```
+
+### Si attaque — bloquer au niveau réseau
+Contacter l'équipe infrastructure pour bloquer l'IP source.
+
+### Si l'app commence à ralentir
+```bash
+docker compose restart app
+```
+
+## Escalade
+Si le trafic continue d'augmenter et l'app ralentit → contacter l'équipe infrastructure immédiatement.

docs/runbooks/no-traffic.md

@@ -0,0 +1,47 @@
+# Runbook — NoTraffic
+
+## Alerte
+**Nom :** NoTraffic  
+**Sévérité :** Warning  
+**Condition :** aucune requête reçue depuis 5 minutes
+
+## Symptômes
+- Aucune activité sur le dashboard Grafana
+- Prometheus ne collecte plus de métriques HTTP
+- Possible indisponibilité silencieuse
+
+## Diagnostic
+
+### 1. Vérifier que l'app tourne
+```bash
+docker compose ps
+curl http://localhost:8000/health
+```
+
+### 2. Vérifier que Prometheus scrape bien l'app
+```bash
+curl http://localhost:9090/targets
+```
+
+### 3. Vérifier les logs
+```bash
+docker compose logs app --tail=50
+```
+
+## Remédiation
+
+### Si l'app est down
+```bash
+docker compose up -d app
+```
+
+### Si Prometheus ne scrape plus
+```bash
+docker compose restart prometheus
+```
+
+### Si tout tourne mais pas de trafic
+C'est peut-être normal (nuit, weekend). Vérifier avec l'équipe produit.
+
+## Escalade
+Si l'app est down et ne redémarre pas → contacter l'équipe infrastructure.