Aller au contenu principal
Version : 0.4 · actuelle

Ajouter une ressource

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

Une ressource est un élément que surveille Excubius : une instance SQL Server, un point de terminaison web, un serveur de rapports, un hôte. Lorsque vous en ajoutez une, Excubius configure immédiatement les vérifications par défaut de son type. Ce guide explique comment ajouter une ressource avec l'Assistant Add resource, tester sa connexion, découvrir ce qui s'exécute dessus, et la modifier ou la supprimer.

Avant de commencer​

Les ressources signalées par une source, comme les ressources Azure provenant d'Azure Monitor ou les appareils provenant de NinjaOne, apparaissent d'elles-mêmes. Vous n'ajoutez que ce que le collecteur natif atteint. Les bases de données et les serveurs liés ne s'ajoutent pas non plus manuellement : vous les découvrez à partir de leur instance.

Ajouter la ressource​

  1. Ouvrez Resources et sélectionnez Add resource.
  2. Type : choisissez de quoi il s'agit. Chaque type indique combien de vérifications il reçoit par défaut et les informations dont il a besoin.
  3. Place and name : choisissez l'Entity, qui détermine ce dont la ressource hérite (seuils, canaux, informations d'identification), et saisissez le Name affiché partout, par exemple sql-ventas-01.
  4. Connection : saisissez les informations propres au type, en commençant par les informations obligatoires. Elles sont vérifiées avant que vous puissiez continuer.
  5. Tags : ajoutez des paires key:value, au moins env, role et client, ainsi qu'une Criticality de 1 (faible) à 5 (critique).
  6. Credential : choisissez des informations d'identification appropriées parmi celles accessibles, None pour utiliser celles de la ressource parente, ou New credential pour en créer ici.
  7. Review : vérifiez ce que vous avez saisi, puis sélectionnez Create resource.

Les vérifications par défaut sont configurées immédiatement et les premières valeurs arrivent en une ou deux minutes. Le dernier écran propose Test connection, Discover pour les instances SQL Server, Open the resource et Add another.

Informations par type​

TypeObligatoireAutres informations
Instance SQL Serverhostport (1433 par défaut) ; instance pour une instance nommée sans port fixe, atteinte par SQL Server Browser sur UDP 1434
Groupe de disponibilité Always Onag_nameGénéralement créé par la découverte, avec son écouteur, ses réplicas et ses bases de données
SQL Server Reporting Servicesportal_urltest_report_path pour générer un rapport ; host, port, instance et report_server_db (ReportServer par défaut) pour la vérification du journal d'exécution
Point de terminaison web / portailurlexpect_status, expect_text ; domain (le domaine enregistrable) pour l'expiration du domaine
Hôte Windows—ip ; sans cette valeur, le collecteur se connecte au nom de la ressource
Hôte Linux—ip et ssh_port (22 par défaut) ; sans ip, le collecteur se connecte au nom de la ressource
Serveur PostgreSQL—host, port
Locataire Entra ID / services de domaine—tenant_id, domain ; contient les vérifications d'identité
Plateforme de surveillance elle-même—heartbeat_url ; contient les vérifications à l'échelle de la plateforme, comme les flux de mises à jour et la posture cloud
Ressources Azure—resource_id ; généralement ajoutées par la source Azure Monitor

Tester la connexion​

Sur la page de la ressource, sélectionnez Test connection. Le collecteur prend en charge le test en 10 secondes environ et se connecte avec les informations d'identification de la ressource.

TypeUn test réussi affiche
Instance SQL Server, groupe de disponibilitéLe nom du serveur, la version, l'édition et la latence, les autorisations de la connexion avec celles qui manquent, et un avertissement lorsque la connexion est sysadmin
Serveur de rapports, point de terminaison webL'adresse, le statut HTTP et la version, ainsi que la latence

Un test qui échoue affiche le type d'erreur avec une indication :

Type d'erreurÀ vérifier
authLa connexion et le mot de passe, et que l'instance accepte les connexions SQL
unreachableLe nom d'hôte, le port et le pare-feu entre le serveur Excubius et le système
timeoutLe chemin réseau ; le système n'a pas répondu à temps
queryUne autorisation manquante de la connexion
configUn élément à corriger dans Excubius : l'hôte, les informations d'identification ou un secret stocké

Lorsque le test reste à l'état waiting for the collector et se termine par No collector picked it up, le collecteur ne s'exécute pas, n'a pas de jeton ou ne propose pas ce transport. Consultez Erreurs du collecteur.

Découvrir ce qui s'exécute sur une instance​

Sur une instance SQL Server, sélectionnez Discover. La découverte lit le serveur, ses groupes de disponibilité avec leurs réplicas, leurs rôles et leur écouteur, ses bases de données, ses serveurs liés et un résumé de SQL Agent. Elle les ajoute, ou les met à jour, en tant que ressources enfants avec leurs propres vérifications, et indique combien ont été créées, mises à jour ou ne sont plus trouvées.

  • Relancez la découverte chaque fois que la topologie change.
  • Une ressource enfant qui n'est plus trouvée est marquée missing et conservée avec son historique. La découverte ne la supprime jamais ; supprimez-la vous-même lorsqu'elle a définitivement disparu.
  • Pour un groupe de disponibilité, ajoutez chaque réplica en tant qu'instance et lancez la découverte sur l'un d'eux. Consultez Démarrage rapide : ajouter un groupe de disponibilité.

Modifier ou supprimer une ressource​

  • Edit modifie le nom, la criticité, les étiquettes et les informations d'identification. Les informations de connexion et l'entité se modifient par l'API : PATCH /api/v1/resources/{id} avec attributes ou entity_id.
  • Delete supprime la ressource avec ses ressources enfants découvertes, ses vérifications, ses métriques et ses alertes. Le système surveillé lui-même n'est jamais touché.

Les éditeurs activent ou désactivent des vérifications et modifient leur intervalle et leurs seuils pour une ressource dans son onglet Checks ; consultez Les ressources et la page de ressource.