Comment fonctionne Honk
Votre boutique, vos formulaires, votre maison et vos serveurs signalent à Honk ce qui se passe. Honk garde chaque message, regroupe les répétitions, n’envoie en push que ce qui ne peut pas attendre et range le reste dans une boîte de réception, à lire quand vous voulez.
De la requête au push
- Requête Votre code envoie du JSON à
/v1/messages, avec la clé d’ingestion d’un projet. - Enregistré Honk l’écrit sur disque, puis répond
202. Une nouvelle tentative avec la mêmeIdempotency-Keyrenvoie le même identifiant, sans créer de second message. - Regroupé L’événement rejoint le groupe qui correspond à son projet, son environnement, sa source, son canal et sa
group_key. - Aiguillé Pour chaque personne, Honk choisit : push immédiat, récapitulatif, ou boîte de réception seulement.
- Envoyé Les push partent par le service push d’Apple et par Web Push. Tout reste dans la boîte de réception, où vous pouvez faire une recherche.
202 veut dire que Honk a reçu le message, pas que quelqu’un l’a vu. C’est pourquoi les apps ne disent jamais « distribué » : Apple et les services push des navigateurs confirment seulement qu’ils ont accepté la notification.
Groupes et épisodes
Un groupe réunit les événements qui parlent de la même chose. Deux événements vont dans le même groupe s’ils viennent du même projet, du même environnement, de la même source et du même canal, avec la même group_key. Sans group_key, Honk compare le titre et le message mot pour mot : seuls les événements identiques sont regroupés.
Un épisode, c’est une occurrence d’un problème dans un groupe, du début à la fin. Le premier événement l’ouvre, et il se termine de l’une de deux façons : la source signale un rétablissement pour la même group_key, ou plus rien n’arrive pendant un moment (24 heures par défaut) et l’épisode devient inactif. Inactif ne veut pas dire réglé : l’événement suivant ouvre un nouvel épisode et vous prévient de nouveau.
Marquer comme traité est un repère pour vous : vous vous êtes occupé de l’épisode. Cela ne veut pas dire que le problème est réglé, et un nouvel épisode réclamera de nouveau votre attention.
Choisir une clé de groupe
db/backup- une tâche : chaque échec de la sauvegarde nocturne va dans le même groupe
requests/4812- une demande client par groupe : deux clients ne se retrouvent jamais dans la même notification
disk/app-01/var- un disque sur un serveur
ci/acme/api/main- une branche d’un dépôt, dans la CI
Activité
Événements
Ce qui part en push
Le serveur décide pour chaque personne qui suit le projet, toujours selon les mêmes règles. Sur iPhone, l’IA peut reformuler une notification, mais elle ne change jamais ce qui part en push.
| Le premier événement d’un épisode | Envoyé tout de suite. |
|---|---|
| Un niveau plus fort que le dernier push | Envoyé tout de suite, même pendant le délai entre mises à jour. Les mises en sourdine restent prises en compte. |
| Un rétablissement | Envoyé tout de suite, avec l’heure indiquée par la source. |
| D’autres événements identiques | Au plus une mise à jour par délai (5 minutes par défaut, réglable de 1 à 120), avec le nombre d’événements. |
| Sous votre seuil de push | Gardé pour le récapitulatif, envoyé toutes les 15 minutes par défaut. Un récapitulatif vide n’est jamais envoyé. |
| Pendant vos heures calmes | Mis de côté, puis envoyé en un seul résumé à la fin. Seuls passent les événements urgents d’une clé autorisée à en envoyer. |
| En sourdine, ou une règle « boîte de réception uniquement » | Pas de push. L’événement arrive quand même dans la boîte de réception, et reste non lu. |
Un Long coup de klaxon ou un Klaxon continu est toujours au moins en priorité Haute. La priorité Urgente nécessite une clé d’ingestion avec l’option « Autoriser la priorité “urgent” » activée.
Une nuit avec des heures calmes
Les heures calmes se règlent par personne et par projet, dans votre fuseau horaire, et tiennent compte du changement d’heure. Voici une nuit avec des heures calmes de 22 h à 7 h :
- Début des heures calmes.
- Deux Petits coups de klaxon d’une tâche de sauvegarde. Ils attendent le récapitulatif.
- Un Long coup de klaxon de l’API de facturation. Il attend le matin.
- Un Klaxon continu urgent, venant d’une clé qui en a le droit. Il passe, et une Activité en direct démarre sur l’écran verrouillé.
- La source signale le rétablissement. L’Activité en direct affiche « Rétabli ».
- Fin des heures calmes. Un seul push résume ce qui a été mis de côté.
Pour passer malgré les heures calmes, un événement doit réunir trois conditions : il est envoyé en priorité urgent, sa clé d’ingestion a l’option « Autoriser la priorité “urgent” » activée, et vos heures calmes ont l’option « Laisser passer les messages urgents » activée.
Récapitulatifs et point du jour
Les événements de routine sous votre seuil de push sont réunis dans un récapitulatif : un push toutes les 15 minutes par défaut, réglable de 5 minutes à 24 heures, par projet et par personne. Un récapitulatif vide n’est jamais envoyé.
Le point du jour est un push discret, une fois par jour à l’heure de votre choix, 8 h par défaut. Par exemple : « 2 incidents ouverts · 5 nouvelles demandes clients · 120 messages depuis hier ». Il n’est pas envoyé les jours sans activité, et il attend la fin de vos heures calmes.
mardi 6 octobre
08:00
Règles et mises en sourdine
Les règles d’un projet s’appliquent dans l’ordre, à chaque événement. Une règle peut porter sur le titre, le message, la source, l’environnement, le canal, la gravité, la priorité, le type d’événement, la clé de groupe, la catégorie ou un champ de métadonnées. Elle peut alors envoyer l’événement au récapitulatif ou seulement dans la boîte de réception, lui donner une catégorie ou relever sa priorité.
Les mises en sourdine ne concernent que vous. Coupez un groupe pendant une heure depuis sa notification, mettez tout un projet en sourdine, ou utilisez Tout en sourdine dans le centre de contrôle pour couper tous les push de l’espace de travail pendant une heure. Les événements en sourdine arrivent quand même et restent non lus.
Espaces de travail et projets
L’espace de travail définit qui y a accès, et dans quelles limites. Le projet indique d’où viennent les événements.
Un espace de travail réunit les membres, leurs rôles (propriétaire, administrateur ou membre) et le forfait. Les limites du forfait se comptent par espace de travail.
Un projet, c’est une app, un serveur ou un script. Chaque projet a ses propres clés d’ingestion, ses règles, sa durée de conservation (dans la limite du forfait), son récapitulatif et son délai entre mises à jour.
- Chacun commence avec un espace de travail personnel, au forfait Free.
- Une équipe crée un espace de travail partagé et y invite des personnes.
- Les propriétaires et les administrateurs voient tous les projets ; les membres, seulement ceux auxquels ils ont accès.
- Heures calmes, mises en sourdine et réglages de push sont propres à chaque personne et à chaque projet : ils ne changent jamais rien sur le téléphone de quelqu’un d’autre.
Si vous connaissez Sentry, c’est le même modèle : un espace de travail correspond à une organisation, un projet à un projet, et une clé d’ingestion à un DSN.
- API de facturation 2 clés d’ingestion · 4 règles · 30 jours
- Maison 1 clé d’ingestion · heures calmes de 22 h à 7 h
Ce que Honk n’est pas
- Pas un outil de supervision. Honk reçoit des événements, il ne vérifie pas vos services. Si un serveur tombe sans rien dire, rien n’arrive : ajoutez un outil de surveillance qui prévient aussi Honk.
- Pas un outil d’astreinte. Pas de rotations ni d’escalade, et Honk n’envoie jamais de SMS et ne vous appelle jamais.
- Pas une archive. Les messages sont supprimés au bout de 3, 14 ou 30 jours, selon votre forfait.