Introduction
quiet-guard/monitor-symfony-bundle apporte Quiet Guard aux applications Symfony. C'est un bundle Symfony léger posé sur le cœur PHP agnostique quiet-guard/monitor-php : le cœur fait le vrai travail, construire les charges utiles, masquer les données sensibles et dialoguer avec le serveur via un transport curl sans dépendances, tandis que le bundle le câble dans le conteneur de services et les événements du kernel pour que tout paraisse naturel dans un projet Symfony.
Ce qu'il fait
Une fois installé et configuré, le bundle :
- capture les exceptions non gérées grâce à un event subscriber sur l'événement
kernel.exceptionet les transmet à votre serveur Quiet Guard ; - transmet les logs applicatifs grâce à un handler Monolog optionnel qui regroupe les enregistrements et les expédie au serveur ;
- expose un service
Reporterpartagé que vous pouvez injecter pour remonter des exceptions ou envoyer des logs à la main.
Tout est additif et non bloquant : la remontée ne modifie jamais la réponse HTTP, ne change jamais la propagation des exceptions et ne lève jamais d'erreur, la surveillance ne doit pas casser l'application hôte.
Comment cela s'articule
Le bundle enregistre un petit ensemble de services dans le conteneur, tous construits à partir des types du cœur monitor-php : un objet valeur Config, un Scrubber, un ExceptionPayloadBuilder, un HttpClient curl et le Reporter qui les relie. Vous ne déclarez qu'une arborescence de configuration monitor ; le bundle construit et connecte le reste pour vous. Il n'y a pas de fichier de ressource de services XML/YAML, le câblage vit dans l'extension d'injection de dépendances du bundle.
Comme il partage la même API d'ingestion et le même cœur que le SDK Laravel, une application Symfony apparaît dans le même dashboard que vos applications Laravel, un seul cockpit pour un parc PHP hétérogène.
Prérequis
| Prérequis | Contrainte |
|---|---|
| PHP | ^8.2 |
| Symfony | 6.4 (LTS), 7.x ou 8.x |
quiet-guard/monitor-php | ^0.2 (tiré automatiquement) |
monolog/monolog | ^3.0, requis uniquement si vous activez la remontée des logs |
Étapes suivantes
- Installation: installer le package et enregistrer le bundle.
- Configuration: l'arborescence de configuration
monitorcomplète, clé par clé. - Usage: ce qui est capturé automatiquement et comment remonter manuellement.
- Mise à jour: versionnage et compatibilité.
Vous lisez la documentation Symfony Bundle v1.0.