Soyez alerté de chaque erreur critique : monitoring d'erreurs externe (Sentry / webhook)
Monitoring d'erreurs externe (Sentry / webhook) une fonctionnalité du module Analytics, heatmap & tableau de bord de Clustraly. Le monitoring d'erreurs externe transfère automatiquement chaque log error ou critical vers Sentry ou un webhook (Slack, Discord, collecteur maison).
Branchez Clustraly à Sentry ou à un webhook, et laissez chaque log error ou critical partir tout seul vers l'outil où vous surveillez déjà. Vous choisissez la destination, le CMS se charge de vous prévenir sans jamais faire tomber une page.
Les erreurs viennent à vous, vous ne courez plus après les logs
Quand une erreur grave survient, vous voulez l'apprendre tout de suite pas en fouillant un fichier de logs trois jours plus tard. Le monitoring d'erreurs externe relaie chaque log error ou critical vers l'outil que vous consultez déjà, au moment même où l'incident est journalisé.
Vous restez maître du canal : tant que la destination n'est pas configurée, rien n'est envoyé. Vous décidez où partent vos alertes, le CMS se charge de les y faire arriver.
- Chaque log error ou critical transféré automatiquement
- Plus aucune surveillance manuelle des fichiers de logs
- Silencieux tant que vous n'avez rien configuré
Comment activer le monitoring d'erreurs ?
Une seule variable suffit. Le service reste dormant par défaut : renseignez la variable MONITORING_DSN et il s'enregistre comme reporter du journal de l'application. À partir de là, chaque erreur remontée par le Logger est relayée, sans une ligne de code supplémentaire.
Le format du DSN décide de la suite. Le CMS l'analyse et choisit tout seul la bonne façon d'envoyer vos erreurs vous n'avez qu'à coller votre adresse de destination.
- Activé uniquement si la variable MONITORING_DSN est définie
- Branché au Logger via register(), sans code à écrire
- Destination auto-détectée à partir du DSN fourni
Sentry ou webhook : Slack, Discord ou votre propre collecteur
Un DSN au format Sentry (clé publique, hôte, identifiant de projet) envoie vos erreurs vers l'endpoint de stockage Sentry, avec l'en-tête d'authentification X-Sentry-Auth, le bon mapping de niveau (un critical devient un fatal) et le contexte complet : release, environnement, nom du serveur, transaction, tags, extras et données d'exception.
Tout autre DSN bascule en webhook HTTPS générique : un JSON structuré service, niveau, message, canal, identifiant de requête, environnement, release, URL, méthode, exception, contexte que Slack, Discord ou un collecteur maison savent recevoir.
- Driver Sentry avec en-tête X-Sentry-Auth et mapping des niveaux
- Webhook JSON structuré prêt pour Slack, Discord ou un endpoint maison
- Le bon driver est choisi automatiquement, sans réglage manuel
Assez de contexte pour comprendre l'erreur du premier coup
Une erreur sans contexte fait perdre du temps. Chaque signalement embarque l'essentiel pour reconstituer la scène : l'URL et la méthode de la requête, l'environnement, la release, l'identifiant de requête et les données d'exception de quoi relier l'alerte à ce qui s'est réellement passé.
Besoin de remonter un incident précis vous-même ? Les méthodes captureException et captureMessage sont exposées pour signaler directement une exception ou un message, sans attendre qu'il passe par le journal.
- Chaque alerte porte URL, méthode, environnement, release et identifiant de requête
- Données d'exception jointes au signalement
- captureException / captureMessage pour un signalement direct
Un mouchard qui ne casse jamais vos pages
Un outil de monitoring ne doit jamais devenir la panne. Le service n'émet qu'en HTTPS, passe par un client anti-SSRF (SafeHttpClient), plafonne à dix envois par requête, se protège de la réentrance et travaille avec des délais courts (4 s puis 3 s). Quoi qu'il arrive, il ne lève jamais d'exception : si l'envoi échoue, votre page reste servie.
Côté confidentialité, la query string est systématiquement retirée des URLs avant l'envoi vos paramètres sensibles ne partent pas dans l'alerte.
- HTTPS uniquement, via un client anti-SSRF (SafeHttpClient)
- Plafond de 10 envois par requête et garde de réentrance
- Ne lève jamais d'exception, ne casse jamais la page
- Query string retirée des URLs avant envoi
Optionnel par nature, sûr par conception
Le monitoring d'erreurs externe ne s'active que si vous le décidez, n'envoie que sur HTTPS et ne fait jamais tomber une page. Vous branchez une destination quand vous êtes prêt ; sinon, le CMS n'envoie rien.
Questions fréquentes
Faut-il obligatoirement un compte Sentry ?
Que se passe-t-il si la destination est injoignable ?
Quelles erreurs sont réellement transférées ?
Mes URLs avec paramètres sensibles risquent-elles de fuiter ?
Gardez un œil sur vos erreurs, là où vous travaillez déjà
Le monitoring d'erreurs externe relie Clustraly à Sentry ou à votre webhook en une seule variable, transfère chaque erreur critique avec son contexte, et se met en retrait dès que quelque chose cloche. Vous choisissez la destination, le CMS s'occupe de vous prévenir sans jamais mettre vos pages en danger.