Modes d'ingestion
Chaque source, comme New Relic, NinjaOne ou Azure Monitor, transmet ses données à Excubius selon l'un des trois modes suivants : Polling (interrogation), Webhook only (webhook uniquement) ou Hybrid (hybride). Le mode détermine la rapidité d'arrivée des alertes, la nécessité ou non de fournir à Excubius des informations d'identification pour la source, et le fait qu'il reçoive l'inventaire et les métriques en plus des alertes. Cet article explique chaque mode et les cas où il convient.
Les trois modes
| Mode | Fonctionnement | Points forts | Points faibles | Convient lorsque |
|---|---|---|---|---|
| Polling | Le collecteur interroge l'API de la source selon une planification pour obtenir l'inventaire, les métriques et les alertes, avec des informations d'identification en lecture seule | Rien n'entre depuis l'extérieur. Il rattrape son retard après une interruption. Vous obtenez l'inventaire et les métriques | Les alertes apparaissent dans l'intervalle d'interrogation. Il consomme du quota d'API | La source ne peut pas joindre ce serveur : pas d'adresse publique, ou trafic entrant non autorisé |
| Webhook only | La source envoie ses alertes à une URL de webhook. Rien n'est interrogé et aucune information d'identification n'est stockée | Les alertes arrivent immédiatement. Aucune information d'identification d'API | Ni inventaire ni métriques. Les alertes envoyées pendant que ce serveur est arrêté sont perdues | Vous pouvez donner une URL à la source, mais pas d'informations d'identification d'API |
| Hybrid | Des webhooks pour les alertes, plus l'interrogation de l'inventaire et des métriques et un rapprochement périodique des alertes | Instantané et autoréparateur : une alerte fermée à la source alors que son webhook a été perdu est résolue au rapprochement suivant | Utilisation un peu plus importante de l'API | La source peut appeler ce serveur et vous pouvez lui fournir des informations d'identification en lecture seule. C'est le choix par défaut recommandé |
Vous choisissez le mode lorsque vous ajoutez la source dans Settings › Sources, et vous pouvez le modifier à tout moment sans redémarrage : le collecteur prend en compte le changement dans les 30 secondes, et chaque appel de webhook est contrôlé par rapport au mode.
Ce que fait chaque mode
| Polling | Webhook only | Hybrid | |
|---|---|---|---|
| Informations d'identification nécessaires | Oui | Non | Oui |
| Inventaire et métriques | Interrogés | Aucun | Interrogés |
| Alertes | Interrogées selon l'intervalle des alertes | Webhooks | Webhooks, rapprochées selon l'intervalle de rapprochement |
| Appels de webhook | Refusés et audités | Acceptés | Acceptés |
| La source est à jour tant que | Les interrogations réussissent | Un webhook est arrivé au cours de la dernière journée | Les interrogations réussissent |
| Test | S'exécute sur le collecteur | Répond immédiatement à partir de ce qui a été reçu | S'exécute sur le collecteur |
| Sync now | Oui | Non | Oui |
Une source interrogée reste à jour tant qu'elle a réussi dans un délai de trois fois son plus court intervalle d'interrogation, et d'au moins 15 minutes. Une source en mode webhook uniquement ne peut indiquer que la dernière fois qu'elle a reçu quelque chose : une journée calme la rend donc obsolète.
Rapprochement
Un rapprochement est une liste complète des alertes ouvertes de la source. Une alerte que la source ne répertorie plus est résolue dans Excubius, à deux exceptions près :
- Les alertes plus anciennes que la fenêtre de liste propre à la source, 30 jours pour les incidents New Relic et les alertes Azure Monitor, ne se résolvent que lorsque la source l'indique.
- Les alertes que quelqu'un a résolues manuellement dans Excubius ne sont pas rouvertes tant que la source continue de signaler la même occurrence. Une nouvelle occurrence ouvre une nouvelle alerte.
Rien n'est résolu à partir d'une interrogation en échec, et aucune alerte n'est inventée lorsqu'une source est injoignable : la source devient obsolète et affiche l'erreur à la place.
Comment les webhooks sont protégés
Chaque point de terminaison de webhook applique les mêmes règles, quelle que soit la source :
- HTTPS et un jeton impossible à deviner. L'URL contient un jeton aléatoire de 256 bits, dont seul un hachage est stocké. L'URL complète n'est affichée qu'une fois, lors de sa création. Rotate URL la remplace, et l'ancienne cesse immédiatement de fonctionner.
- Secret partagé facultatif. Lorsque vous définissez un Webhook secret, chaque appel doit le transmettre sous la forme
Authorization: Bearer <secret>, comme mot de passe deAuthorization: Basic, ou dansX-Webhook-SecretouX-Custom-Webhook-Secret. Les groupes d'actions Azure Monitor ne peuvent pas ajouter d'en-têtes : pour eux, le jeton fait office d'information d'identification. - Limites. Le serveur accepte 30 appels de webhook par minute et par adresse IP, avec des rafales de 20, et refuse les corps de plus de 512 Kio. Un jeton inconnu reçoit la même réponse qu'une source qui n'existe pas.
- Enregistrement avant traitement. La charge utile est d'abord enregistrée, puis traitée en arrière-plan. Une charge utile en échec est conservée avec son erreur et retraitée trois fois : rien n'est perdu à cause d'un bogue. Une nouvelle tentative du même événement, reconnue grâce à l'ID d'événement de la source, est acceptée puis écartée.
- Audit. Les appels refusés parce que la source est en mode interrogation ou désactivée sont comptabilisés sur la source et audités. Chaque changement de mode, rotation, test et synchronisation est écrit dans le journal d'audit avec l'utilisateur et l'heure.
Les événements reçus et ignorés sont conservés 30 jours ; Settings › Sources affiche les plus récents pour chaque source.
Intervalles d'interrogation
Chaque source a ses propres intervalles, en secondes, sous Polling intervals. Laissez un champ vide pour utiliser sa valeur par défaut :
| Source | Inventaire | Métriques | Alertes (interrogation) | Rapprochement des alertes (hybride) |
|---|---|---|---|---|
| New Relic | 900 | 300 | 300 | 900 |
| NinjaOne | 900 | 900 | 300 | 900 |
| Azure Monitor | 900 | 300 | 300 | 900 |
Le minimum est de 60 secondes, et de 300 pour le rapprochement. Chaque vérification conserve aussi son propre intervalle : la phase des métriques n'exécute donc que les vérifications arrivées à échéance. L'expiration Key Vault, par exemple, est lue toutes les heures. Des intervalles plus courts consomment du quota d'API : une erreur rate limited sur la source signifie qu'ils sont trop courts.
Les vérifications propres au collecteur ne dépendent d'aucun mode : elles s'exécutent selon les intervalles du catalogue, de 30 secondes à 24 heures.