Aller au contenu principal
Version : 0.4 · actuelle

Modes d'ingestion

ConceptRévisé le 11 octobre 2026
S'applique à :Excubius 0.4Rôles : Administrateur d'entité
PlansFree · Core · Pro · EnterpriseDéploiementAuto-hébergé

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​

ModeFonctionnementPoints fortsPoints faiblesConvient lorsque
PollingLe 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 seuleRien n'entre depuis l'extérieur. Il rattrape son retard après une interruption. Vous obtenez l'inventaire et les métriquesLes alertes apparaissent dans l'intervalle d'interrogation. Il consomme du quota d'APILa source ne peut pas joindre ce serveur : pas d'adresse publique, ou trafic entrant non autorisé
Webhook onlyLa source envoie ses alertes à une URL de webhook. Rien n'est interrogé et aucune information d'identification n'est stockéeLes alertes arrivent immédiatement. Aucune information d'identification d'APINi inventaire ni métriques. Les alertes envoyées pendant que ce serveur est arrêté sont perduesVous pouvez donner une URL à la source, mais pas d'informations d'identification d'API
HybridDes webhooks pour les alertes, plus l'interrogation de l'inventaire et des métriques et un rapprochement périodique des alertesInstantané et autoréparateur : une alerte fermée à la source alors que son webhook a été perdu est résolue au rapprochement suivantUtilisation un peu plus importante de l'APILa 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​

PollingWebhook onlyHybrid
Informations d'identification nécessairesOuiNonOui
Inventaire et métriquesInterrogésAucunInterrogés
AlertesInterrogées selon l'intervalle des alertesWebhooksWebhooks, rapprochées selon l'intervalle de rapprochement
Appels de webhookRefusés et auditésAcceptésAcceptés
La source est à jour tant queLes interrogations réussissentUn webhook est arrivé au cours de la dernière journéeLes interrogations réussissent
TestS'exécute sur le collecteurRépond immédiatement à partir de ce qui a été reçuS'exécute sur le collecteur
Sync nowOuiNonOui

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 :

  1. 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.
  2. 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 de Authorization: Basic, ou dans X-Webhook-Secret ou X-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.
  3. 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.
  4. 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.
  5. 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 :

SourceInventaireMétriquesAlertes (interrogation)Rapprochement des alertes (hybride)
New Relic900300300900
NinjaOne900900300900
Azure Monitor900300300900

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.