Alertes
Le central ouvre une alerte quand une règle se déclenche. Une alerte ne fait jamais rien sur un serveur : corriger reste un ordre signé.
Les règles
| Règle | S'ouvre quand | Se résout |
|---|---|---|
sonde | 3 échecs de suite d'une sonde de santé (panne) | à la première mesure saine |
agent | aucun signe de l'agent depuis 45 s, soit 3 battements (panne) | au retour du battement |
certificat | échéance à 14 jours (alerte), à 3 jours ou expiré (panne) | au relevé d'un certificat renouvelé |
execution | un résultat signé failed | à la réussite suivante de la même action, au même endroit |
sauvegarde | sauvegarde en échec ou en retard ; restauration d'essai en échec (panne) | à la réussite suivante |
tache | tâche planifiée en retard ; échec signalé (panne) | à la réussite suivante |
erreur | nouvelle erreur, erreur revenue ; 100 occurrences dans l'heure (panne) | erreur marquée résolue ou ignorée |
signalement | « Je n'ai pas demandé cela » sur un ordre (panne) | à la main |
Prendre en main, endormir, résoudre
ouverte ──prise en main──▶ prise ──Résolu──▶ résolue │ ▲ │ │ └─réveil (échéance, aggravation, à la main) └──mettre en sommeil (1 h, 4 h, 24 h, 7 j)──▶ sommeil
Sur la page Alertes : prendre en main, mettre en sommeil, réveiller, résoudre. Une aggravation réveille une alerte en sommeil. Résoudre à la main une condition qui persiste laisse la règle ouvrir une nouvelle alerte à la mesure suivante. Chaque changement d'état est inscrit au journal chaîné.
Webhook de l'espace
Dans Alertes › Réglages, donnez une adresse https://. Le central génère un secret whsec_…, montré une seule fois, puis envoie un POST à chaque changement d'état :
POST <url>
Content-Type: application/json
Kantama-Evenement: alerte.ouverte
Kantama-Livraison: liv_9f2c41e8a07b5d2f
Kantama-Signature: t=1794300012,v1=<hex HMAC-SHA256(secret, "1794300012." ‖ corps brut)>
{"id": "liv_…", "type": "alerte.ouverte", "at": 1794300012, "espace": "<slug>",
"alerte": {"id", "projet", "regle", "titre", "detail", "gravite", "etat", …}}- Recalculez la signature sur le corps brut, comparez à temps constant, refusez un horodatage de plus de 5 minutes.
- Délai 5 s, redirections non suivies, 3 tentatives ; une réponse 2xx vaut réception.
- L'adresse doit résoudre vers des adresses publiques : le central ne sert pas de relais vers son propre réseau.
Un exemple de vérification en Python est dans API publique.
Sur le téléphone
Les téléphones liés reçoivent « Nouvelle alerte » à l'ouverture, à l'aggravation et au réveil d'une alerte. La notification ne dit rien d'autre : elle ouvre l'app.
Chaque membre choisit dans Alertes › Mes notifications s'il reçoit ces notifications ; celles des ordres qui attendent sa signature lui parviennent toujours. Les pannes peuvent aussi partir par SMS (Équipe et Entreprise).
Page de statut publique
Un projet peut être publié sur la page de statut de l'espace, /statut/<espace> : disponibilité sur 90 jours et incidents des 30 derniers jours, tirés des sondes, sans aucune donnée sensible. Le format est décrit dans API publique.
Les propositions de modification de la documentation ne sont pas encore ouvertes au public.