Alertes

Les alertes viennent de trois outils du serveur : Gatus (chaque service répond-il), Healthchecks (chaque tâche planifiée s’est-elle signalée) et Beszel (le processeur, la mémoire et le disque sont-ils sains). La vue d’ensemble se trouve dans Supervision et alertes. Cette page couvre les réglages et le premier raccordement.

Champs

Paramètres > Alertes et signalement des tâches manquées contient l’adresse du signal de vie hors site. Les tâches planifiées se signalent au Healthchecks du serveur, qui donne l’alerte quand un signal est en retard ou annonce un échec.

Champ	Rôle
Adresse du signal de vie hors site	L’adresse de signal d’une vérification auprès d’un service de surveillance externe, par exemple une vérification gratuite healthchecks.io. Utilisée par le signal de vie hors site (Catena Pro), que vous activez dans Horaires.

Une surveillance installée sur le serveur ne peut pas signaler une panne qui emporte le serveur entier. Le signal de vie hors site comble cet écart : selon son horaire, le serveur vérifie que sa page d’état, son moniteur de tâches et son moniteur de ressources répondent, puis appelle l’adresse hors site. Un appel simple indique que tout va bien; un appel d’échec nomme les surveillances qui ne répondent plus; l’absence d’appel signifie que le serveur est hors service, et le service externe donne l’alerte. Enregistrer l’adresse seule n’envoie rien : le signal de vie s’exécute une fois que vous l’activez dans Horaires, où sa section indique la période et le délai de grâce à régler sur la vérification externe. À la fin de votre abonnement, les appels cessent : mettez alors la vérification externe en pause.

Les alertes parviennent aussi à votre courriel d’administrateur, par le service choisi dans Courriel sortant : tant que le courriel sortant est réglé, le serveur garde dans Healthchecks un canal de courriel vers votre adresse d’administrateur, rattaché à toutes les vérifications au moment de sa création. Un canal détaché d’une vérification dans Healthchecks le reste. Avec Aucun courriel sortant, le canal est retiré et les alertes ne parviennent qu’aux canaux que vous ajoutez dans Healthchecks.

La section se termine par Enregistrer et appliquer; les services qui utilisent ces valeurs redémarrent brièvement.

Parcours d’une alerte

Gatus sonde les services partagés (le panneau d’administration, Healthchecks, Keycloak, Beszel, le tunnel Cloudflare et le mandataire inverse) et chaque application exposée à intervalle fixe (environ une à deux minutes). Après 3 échecs consécutifs, il déclenche une alerte, et après 2 réussites, il la résout.
Chaque alerte de Gatus est publiée dans Healthchecks sous la forme d’une vérification par service, nommée gatus-<service>, créée au premier échec.
Healthchecks envoie chaque alerte à votre courriel d’administrateur et aux canaux ajoutés dans sa propre interface.
Les tâches planifiées (sauvegarde, copie hors site, entretien nocturne, sonde de redémarrage, signal de vie hors site) signalent leur passage à Healthchecks. Un signal manquant est en soi l’alerte. Les vérifications de la sauvegarde, de la copie hors site, de l’entretien nocturne (Nightly maintenance, avertie quand une nuit commence, échoue ou se termine) et du signal de vie hors site suivent les horaires des tâches qui s’y signalent; tant qu’aucune de ces tâches n’est activée, la vérification est en pause et n’est donc jamais en retard. Dans toutes les éditions, la veille des vulnérabilités crée aussi une vérification par vulnérabilité sur laquelle elle alerte (voir Alertes de sécurité). L’entretien nocturne ne se signale aux vérifications de la sauvegarde et de la copie hors site que tant que ses étapes de sauvegarde et de copie hors site sont activées (voir Choisir les étapes).
Beszel surveille le serveur avec des règles créées une seule fois et jamais écrasées : état (agent silencieux) pendant 5 minutes, processeur à 90 % pendant 10 minutes, mémoire à 90 % pendant 10 minutes, disque à 85 % pendant 10 minutes. Ses alertes passent par Healthchecks et parviennent donc aux mêmes canaux.

Envoyer des rapports d’erreurs au soutien de Catena

Paramètres > Rapports d’erreurs au soutien de Catena permet à un serveur sous Catena Pro ou Catena Business d’aviser le soutien de Catena quand l’un des contrôles propres à Catena échoue ou se rétablit, pour que le soutien puisse vous aider avant qu’un petit problème ne grossisse. L’option est désactivée tant que vous ne l’activez pas.

Pour l’activer :

Lisez le rapport que la section affiche. C’est le rapport que ce serveur enverrait à l’instant.
Cochez la case qui confirme votre accord, puis appuyez sur Activer les rapports d’erreurs. D’ici cinq minutes, le serveur s’inscrit auprès du soutien de Catena.

Pour la désactiver, appuyez sur Désactiver les rapports d’erreurs. Le serveur cesse aussitôt d’envoyer et se désinscrit.

Un rapport nomme le contrôle, indique s’il échoue et depuis quand, l’application concernée, votre version de Catena et votre édition. Il ne contient jamais ce qui se trouve dans vos applications : ni fichiers, ni lignes de journal, ni comptes d’utilisateurs, ni adresses courriel ou réseau, ni noms de domaine. Un rapport n’est envoyé que lorsque la liste des contrôles en échec change ou qu’un événement ponctuel survient.

Sous l’interrupteur, la section liste les 100 derniers rapports envoyés, du plus récent au plus ancien, chacun avec le texte exact qui a quitté le serveur et l’indication que le soutien de Catena l’a reçu ou non.

Quand une tâche en échec a écrit un texte sur ce qui a mal tourné, ce texte reste sur votre serveur. La liste le propose pour chaque rapport qui en a un :

Télécharger le texte de la tâche enregistre le texte tel quel.
Relire et envoyer au soutien de Catena ouvre le texte dans une zone. Retirez ce que vous ne voulez pas que le soutien voie, puis appuyez sur Envoyer ce texte au soutien de Catena. Seul le texte de la zone est envoyé, et la liste montre exactement ce que vous avez envoyé.

Le soutien répond du lundi au vendredi, de 8 h à 17 h. Les rapports d’erreurs ne forment pas une surveillance 24 heures sur 24, et un serveur éteint ou sans accès à Internet n’envoie rien : pour cela, utilisez le signal de vie hors site décrit plus haut.

Ajouter des canaux de notification dans Healthchecks

Les alertes parviennent à votre courriel d’administrateur sans aucune étape ici. Vous ajoutez d’autres canaux, pour d’autres personnes ou d’autres outils, dans Healthchecks :

Ouvrez https://healthchecks.yourdomain.com et connectez-vous (authentification unique).
Ouvrez la page des intégrations du projet et ajoutez un canal : courriel, Slack, ntfy, webhook, ou tout autre que la page propose.
Vérifiez que le canal est rattaché aux vérifications que vous voulez notifier. Les nouvelles vérifications, y compris celles qui commencent par gatus-, utilisent les canaux du projet.

Les canaux par courriel exigent Courriel sortant.

Où regarder

https://gatus.yourdomain.com : la page d’état de Gatus.
https://healthchecks.yourdomain.com : Healthchecks, avec le dernier signal de chaque tâche.
https://beszel.yourdomain.com : Beszel, avec les graphiques de ressources du serveur.
La page Système du panneau d’administration montre les alertes actives et les tâches qui ne se sont pas encore signalées.

Vous pouvez changer les noms de sous-domaines dans Domaine et Cloudflare.

Dépannage

Une tâche apparaît en retard ou en panne dans Healthchecks : la tâche a échoué ou ne s’est pas exécutée à son horaire. Consultez le Journal et Horaires.
Aucun courriel d’alerte : Courriel sortant est réglé à Aucun courriel sortant, votre canal de courriel d’administrateur a été détaché de cette vérification dans Healthchecks, ou le courriel est dans les pourriels.
Aucune notification sur un autre canal : ce canal n’est pas rattaché à la vérification. Rattachez-le comme ci-dessus.
Un canal que vous avez ajouté ne livre rien : comparez son adresse ou son sujet dans Healthchecks avec ceux du côté de la réception.