Omika/docs/observability/unplug.md

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 :

   docker compose down
   

4. Supprimer les volumes (télémétrie externe) :

   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

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).