Files
Omika/docs/observability/unplug.md
T
2026-10-23 18:46:50 +02:00

42 lines
1.5 KiB
Markdown

# Procédure « unplug » — supprimer l'infrastructure externe sans casser Omika (§83)
## Objectif
Supprimer **entièrement** OpenTelemetry Collector / SigNoz / ClickHouse et vérifier
qu'Omika continue de fonctionner normalement. C'est un **test d'acceptation obligatoire**.
## Étapes
1. **Kill switch** : mettre `Observability:External:Enabled=false` dans la
configuration de l'API et du Worker.
2. **Redémarrer** l'API et le Worker (ou recharger la configuration).
3. **Arrêter la pile** sur la VM :
```bash
docker compose down
```
4. **Supprimer les volumes** (télémétrie externe) :
```bash
docker compose down -v
```
5. **Supprimer la VM** observabilité (Hyper-V) si la désinstallation est définitive.
6. **Vérifier** le fonctionnement complet d'Omika (critères §97/H) :
- `LocalFileTelemetryExporter` écrit les JSONL locaux ;
- `DiagnosticOutbox` (`omika-diagnostics.db`) fonctionne ;
- `POST /api/diagnostics` répond (ACK après persistance locale) ;
- `RemoteDiagnosticIngestionStore` écrit le JSONL serveur ;
- API métier, Worker, synchronisation, mobile : **tout fonctionne**.
## Résultat attendu
```text
Omika totalement fonctionnel.
Seule conséquence : absence de centralisation externe des diagnostics.
```
## Re-branchement (§91)
Réinstaller la pile, remettre `Enabled=true` avec un endpoint valide, redémarrer.
Les **nouveaux** événements recommencent à arriver. Aucun replay des événements
perdus hors mécanismes déjà persistés (les JSONL locaux + l'outbox restent la
sécurité durable).