Aller au contenu

Rapports par email

Un rapport est un court email qui raconte à votre équipe comment l’infrastructure s’est comportée sur le dernier jour, la dernière semaine ou le dernier mois, sans que personne n’ouvre DumbMonit. Il est hebdomadaire par défaut ; quotidien et mensuel sont à un clic. Les rapports réutilisent un canal de notification email (SMTP), configurez-en donc un d’abord (voir Canaux de notification).

Ouvrez Rapports (dans le rail d’icônes) pour les configurer. La page réunit l’export de disponibilité (SLA) d’une période, les rapports planifiés et l’historique de leurs envois ; elle était dans les Réglages, et /settings/reports y redirige. Tout ici est réservé aux administrateurs, lecture incluse, car la page liste les adresses des destinataires.

SectionContenu
En-têteDisponibilité globale sur la période, nombre d’incidents, et évolution par rapport à la période précédente.
Disponibilité par groupeUne ligne par groupe, puis par surveillance (les 40 moins disponibles au plus), calculée de la même façon que sur les pages d’état : les sondes par leur taux de réussite, les hôtes et surveillances par leur fréquence de remontée. Les surveillances sans historique sont montrés comme « aucune donnée » plutôt que 100 %.
IncidentsQuand chacun a commencé, combien de temps il a duré (ou qu’il est toujours ouvert) et sur quelle surveillance. 25 au plus. Les alertes informatives sont laissées de côté.
Surveillances les moins stablesLes cinq surveillances avec la disponibilité la plus faible ou le plus d’incidents.
ComparaisonDisponibilité et nombre d’incidents comparés à la période de même durée juste avant.

L’email est composé de simples tableaux HTML avec des styles en ligne et aucune image distante, si bien qu’il s’affiche pareil partout et que rien n’est récupéré à son ouverture. Une version texte est envoyée en complément. Chaque nom de surveillance et chaque message est échappé.

RéglageCe qu’il fait
NomAffiché seulement dans la liste.
ActivéDésactivé conserve les réglages sans rien envoyer.
FréquenceQuotidien, hebdomadaire (défaut) ou mensuel.
JourLe jour de la semaine pour les rapports hebdomadaires, le jour du mois (1 à 28) pour les mensuels.
Heure et Fuseau horaireQuand le rapport part, dans un fuseau horaire IANA comme Europe/Paris. L’heure d’été est suivie.
DestinatairesJusqu’à 20 adresses, libres : elles n’ont pas besoin d’être des utilisateurs DumbMonit. Chaque destinataire reçoit son propre email, personne ne voit les autres.
Canal emailQuel canal SMTP l’envoie. Par défaut, le premier activé. Seul le serveur de messagerie du canal est utilisé : ses propres destinataires sont ignorés.

La période est une fenêtre glissante qui se termine à l’envoi du rapport : les 24 dernières heures, 7 jours ou 30 jours. La période précédente est la fenêtre de même durée juste avant.

Cliquez sur le i à côté du titre de section pour un rappel du contenu.

Un calendrier de type Rapport SLA est le rapport mensuel de disponibilité que l’on remet à un client ou à un auditeur. Il couvre le mois civil précédent (du 1er à minuit au 1er suivant à minuit, dans le fuseau du calendrier) : il est donc toujours mensuel. Le courriel part le jour du mois choisi, avec :

  • le PDF : le nom de l’organisation (le titre d’une page de statut que vous choisissez, sinon DumbMonit), la période, la disponibilité, les incidents et l’indisponibilité totale, la disponibilité par groupe et par moniteur avec le temps de réponse moyen et au 95e centile de chaque sonde, et chaque incident ;
  • deux fichiers CSV : les moniteurs (availability-2026-10-monitors.csv) et les incidents (availability-2026-10-incidents.csv), en UTF-8 avec une marque d’ordre des octets pour Excel. Une cellule qui commence par =, +, - ou @ reçoit une apostrophe, pour qu’un nom de moniteur ne devienne pas une formule de tableur.

Les deux pièces jointes se désactivent séparément. Avec un objectif de disponibilité (par exemple 99,9), chaque moniteur est marqué Tenu ou Manqué (Met / Missed dans le rapport) et le rapport dit combien l’ont tenu ; sans objectif, les mots habituels sont utilisés (Healthy, Degraded, Poor). Le rapport est en anglais ; les chiffres sont ceux des pages de statut.

Le PDF est écrit par DumbMonit lui-même, avec les polices standard Helvetica et sans bibliothèque : A4, texte et tableaux, un pied de page avec la date de génération et le numéro de page. Le logo d’une page de statut n’est pas incorporé ; son nom coiffe le rapport.

En haut de la page, Rapport de disponibilité (SLA) construit le même rapport à la demande, pour toute période d’un an au plus (les deux jours inclus, dans le fuseau choisi, jusqu’à maintenant si elle n’est pas terminée). Choisissez le PDF, le CSV des moniteurs ou le CSV des incidents. Le défaut est le mois civil précédent. En mode MSP, choisissez le client concerné. Réservé aux administrateurs.

En bas de la page, Historique des envois liste chaque rapport planifié avec son dernier envoi, le prochain prévu et le résultat de la dernière tentative (un envoi échoué affiche son erreur jusqu’au prochain succès).

Envoyer un aperçu adresse le rapport actuel aux destinataires enregistrés tout de suite, avec [Preview] dans le sujet. Cela ne change rien à la planification : le prochain rapport part toujours à l’heure. Un aperçu peut être envoyé une fois toutes les 30 secondes par rapport. Enregistrez vos modifications d’abord, car l’aperçu utilise les destinataires enregistrés.

  • Au plus une fois. Le créneau est réservé dans la base de données avant que l’email soit construit, si bien qu’un redémarrage n’envoie jamais le même rapport deux fois. Quand l’envoi échoue, l’erreur est conservée sur le rapport et affichée dans la liste, et le créneau n’est pas retenté ; le prochain part normalement.
  • Pas de rattrapage. Si DumbMonit était indisponible au moment prévu, le rapport n’est envoyé au retour que si c’est dans les 3 heures du créneau. Au-delà, il attend le prochain créneau. Un rapport que vous créez ou réactivez n’envoie jamais un créneau déjà passé.
  • Il peut exister au plus 10 rapports.
  • En mode démo, rien n’est envoyé.

Les rapports sont inclus dans les sauvegardes : le canal email est retrouvé par son nom à la restauration, et un rapport restauré repart à zéro (sa date de dernier envoi n’est pas conservée).

Voir API HTTP.