Pour que Portail ZAPP reçoive les alertes d'un outil de supervision, on déclare cet outil comme source. Chaque source a sa propre clé d'intégration : l'outil l'envoie avec chaque événement, et Portail ZAPP refuse tout envoi sans clé valide.
L'écran Sources de supervision est réservé aux groupes Administrateurs Supervision, Administrateurs Service Desk et Administrateurs. On l'ouvre depuis la Console des alertes (bouton Sources de supervision).
La liste des sources
La liste montre, pour chaque source, son nom, son statut (Actif ou Désactivé), son Débit max./min, ses Alertes ouvertes et la date de son Dernier événement. Un badge Clé révoquée signale une source dont la clé a été révoquée.
Créer une source
Cliquez sur Nouvelle source et renseignez :
- Nom et Description ;
- Débit maximal (événements par minute) : au-delà , les événements de cette source sont refusés. La valeur par défaut est de 120 ;
- Format des événements : la façon dont l'outil écrit ses envois (voir ci-dessous).
à l'enregistrement, la Clé d'intégration s'affiche une seule fois : « Copiez cette clé maintenant : elle ne sera plus jamais affichée. » Le bouton Copier la place dans le presse-papiers. La page montre aussi l'adresse à indiquer dans l'outil et un exemple d'envoi. Cliquez sur J'ai copié la clé une fois la clé mise de cÎté.
Portail ZAPP ne conserve jamais la clé en clair. Si elle est perdue, régénérez-la (voir plus bas).
Les formats reconnus
| Format | Pour quels outils |
|---|---|
| Standard (PagerDuty Events v2) | Zabbix (type de média PagerDuty), Datadog, Nagios, Centreon, PRTG et la plupart des outils, qui savent émettre ce format. Dans l'outil, choisissez l'intégration PagerDuty (Events API v2) et indiquez l'adresse et la clé de la source comme « routing key » ou « integration key » |
| Prometheus Alertmanager | Un récepteur webhook dans Alertmanager, avec send_resolved pour que la résolution ferme l'alerte |
| Azure Monitor (schéma d'alerte commun) | Une action Webhook dans un groupe d'actions Azure, avec le schéma d'alerte commun activé |
| CloudEvents 1.0 | Les intégrations sur mesure |
| Correspondance libre (JSON) | Un outil plus ancien qui n'envoie qu'un JSON libre : vous indiquez oĂč trouver chaque information |
Les formats reconnus s'utilisent sans configuration. La fiche de la source montre, dans le bloc Brancher l'outil de supervision, l'Adresse du point d'entrée propre à son format et la marche à suivre.
Transmettre la clĂ© : l'outil l'envoie dans l'en-tĂȘte « Authorization: Bearer » ou « X-Routing-Key ». N'utilisez le paramĂštre routing_key dans l'adresse que si l'outil ne sait pas poser d'en-tĂȘte, comme le webhook Azure Monitor : une adresse peut apparaĂźtre dans les journaux d'un proxy.
La correspondance libre
Avec le format Correspondance libre (JSON), la fiche affiche la Correspondance de champs. Pour chaque information, indiquez le chemin oĂč la lire dans le JSON de l'outil : des noms sĂ©parĂ©s par des points, et l'index d'un tableau entre crochets (hosts[0].name).
- Résumé et HÎte sont obligatoires ;
- Clé de déduplication, Gravité, Date, Composant, Groupe, Classe sont facultatifs. Sans clé de déduplication, une empreinte de l'hÎte, du composant et de la classe la remplace ;
- Champ action, Valeurs qui résolvent et Valeurs qui acquittent disent quand un envoi résout ou acquitte l'alerte ;
- Tableau d'alertes (facultatif) : si l'outil envoie plusieurs alertes Ă la fois ;
- Détails conservés (vide : tout) : les informations à garder dans les détails bruts de l'alerte ;
- Table de gravités : une ligne par valeur de l'outil, par exemple
Disaster=critical.
Tester sur un exemple
Le bloc Tester sur un exemple de la fiche vĂ©rifie le branchement avant de l'activer : collez un envoi rĂ©el de l'outil, puis cliquez sur Tester. L'envoi est lu exactement comme au point d'entrĂ©e, avec le format et la correspondance saisis. Le rĂ©sultat montre les ĂvĂ©nements lus (action, clĂ©, rĂ©sumĂ©, hĂŽte, gravitĂ©, composant) ou les Erreurs de lecture. Rien n'est enregistrĂ©.
Désactiver une source, régénérer ou révoquer sa clé
Dans la fiche d'une source :
- décochez Source active (événements acceptés) pour refuser ses événements sans toucher à sa clé ;
- Régénérer la clé crée une nouvelle clé, affichée une seule fois. L'ancienne cesse aussitÎt de fonctionner : pensez à mettre l'outil à jour ;
- Révoquer la clé refuse les événements de la source jusqu'à la prochaine régénération.
Ensuite
Une fois la source branchée, ses alertes arrivent dans la Console des alertes. Pour les rattacher aux CI de la CMDB et ouvrir automatiquement des incidents, voir « Automatiser le traitement des alertes ».