Introduction

quiet-guard/laravel-monitor est le SDK client Laravel officiel de Quiet Guard. Vous l'installez avec Composer dans l'application à surveiller ; son service provider et la façade Monitor sont auto-découverts, il n'y a donc aucune inscription manuelle à faire.

Une fois configuré avec trois variables d'environnement (MONITOR_ENABLED, MONITOR_URL, MONITOR_KEY), le SDK enregistre un callback additif sur le handler d'exceptions de Laravel : chaque exception reportée est transmise à votre dashboard sans toucher à votre propre logging. La capture est fail-safe, une erreur réseau ou de configuration de Quiet Guard est avalée et n'affecte jamais l'application surveillée.

Ce qu'il fait

• Remontée d'exceptions: capture automatique via le handler d'exceptions du framework, plus une API manuelle Monitor::report(). Voir Remontée d'exceptions.
• Logs applicatifs: transmission opt-in des événements MessageLogged, bufferisés et envoyés en un seul batch par requête. Voir Logs applicatifs.
• Scan des dépendances: la commande monitor:dependencies envoie votre composer.lock pour que le serveur signale les vulnérabilités connues. Voir Scan des dépendances.
• Heartbeats: la commande monitor:heartbeat et la macro de scheduler ->monitorHeartbeat() pinguent le serveur depuis vos tâches planifiées pour qu'il puisse vous alerter quand elles cessent de tourner. Voir Heartbeats.
• Sauvegardes chiffrées: les commandes monitor:backup / monitor:restore stockent des dumps de base de données ou des dossiers dans le coffre zéro-knowledge, chiffrés côté client. Voir Sauvegardes chiffrées.
• Confidentialité par défaut: les clés sensibles (mots de passe, tokens, cookies, en-têtes d'autorisation) sont masquées avant tout envoi.

Bâti sur le cœur PHP

Le SDK est un adaptateur Laravel léger au-dessus de quiet-guard/monitor-php, le cœur agnostique du framework. Tous deux partagent le même contrat d'ingestion et le même chiffrement de sauvegarde, si bien que les clients Laravel, Symfony et WordPress parlent tous l'API d'ingestion neutre documentée dans la documentation du serveur.

Prérequis

• PHP 8.2 ou supérieur
• Laravel 11, 12 ou 13
• Un serveur Quiet Guard et une clé d'API par projet

Les pages suivantes détaillent l'installation, la configuration et l'usage au quotidien.