From 48b177e80593fcd28500d2aac7550fbe4bf53384 Mon Sep 17 00:00:00 2001 From: matthieu Date: Sun, 28 Jun 2026 13:33:30 +0200 Subject: [PATCH] docs : ajoute la commande de test d'envoi (sentry:test) au runbook GlitchTip Co-Authored-By: Claude Opus 4.8 (1M context) --- doc/error-tracking.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/doc/error-tracking.md b/doc/error-tracking.md index 16d077b..a43fdc8 100644 --- a/doc/error-tracking.md +++ b/doc/error-tracking.md @@ -47,6 +47,31 @@ container PHP joint GlitchTip via un **tunnel Tailscale** monté sur le host de docker compose exec php php bin/console cache:clear --env=prod ``` +## Tester l'envoi + +Le bundle `sentry/sentry-symfony` fournit une commande qui envoie un événement de test et +confirme s'il est bien parti vers GlitchTip. Elle n'existe qu'en **prod** (bundle prod-only) et +nécessite `SENTRY_DSN` défini. + +```bash +# Sur le serveur, dans le container PHP (SENTRY_DSN doit être dans l'env) : +docker compose exec php sh -lc "APP_ENV=prod php bin/console sentry:test" +``` + +Sortie attendue : `Sending test message... done.` → une **Issue de test** apparaît dans le projet +`sirh-api` côté GlitchTip. Si l'envoi échoue (`Message not sent`), le problème est réseau +(Tailscale/route/port) ou DSN, pas applicatif. + +Pré-check connectivité depuis le host prod (ex. IP tailnet GlitchTip `100.111.223.34`) : + +```bash +tailscale ping 100.111.223.34 +curl -sS -o /dev/null -w "%{http_code}\n" http://100.111.223.34:/_health/ # 200 attendu +``` + +Alternative sans commande dédiée : déclencher un `throw new \RuntimeException('glitchtip test')` +temporaire dans un endpoint, ou un `$logger->error('glitchtip test')` (niveau ERROR+ → Issue). + ## CA HTTPS (conditionnel) Uniquement si le DSN cible l'HTTPS interne `logs.malio-dev.fr` (cert auto-signé) : baker la CA