Ajouter une ressource
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
- Vous devez disposer du rôle Entity admin sur l'entité qui contiendra la ressource.
- Les informations d'identification dont la ressource a besoin sont stockées, ou vous êtes prêt à les créer dans l'Assistant. Consultez Stocker des informations d'identification pour le collecteur.
- Le serveur Excubius atteint le système sur le bon port. Consultez Chemins réseau.
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
- Console
- API
- Ouvrez Resources et sélectionnez Add resource.
- 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.
- 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. - Connection : saisissez les informations propres au type, en commençant par les informations obligatoires. Elles sont vérifiées avant que vous puissiez continuer.
- Tags : ajoutez des paires
key:value, au moinsenv,roleetclient, ainsi qu'une Criticality de 1 (faible) à 5 (critique). - 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.
- Review : vérifiez ce que vous avez saisi, puis sélectionnez Create resource.
curl -s "${H[@]}" -X POST "$BASE/resources" -d "{
\"entity_id\": \"$PROD\", \"type\": \"web_endpoint\", \"name\": \"portal-ventas\",
\"attributes\": {\"url\": \"https://ventas.ciguapa.example/\", \"domain\": \"ciguapa.example\"},
\"tags\": {\"env\": \"prod\", \"role\": \"web\", \"client\": \"ciguapa\"}, \"criticality\": 4
}" | jq '{id, name, checks_provisioned}'
$BASE vaut https://<your server>/api/v1 et H contient votre jeton du porteur ; consultez la référence de l'API.
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
| Type | Obligatoire | Autres informations |
|---|---|---|
| Instance SQL Server | host | port (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 On | ag_name | Généralement créé par la découverte, avec son écouteur, ses réplicas et ses bases de données |
| SQL Server Reporting Services | portal_url | test_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 / portail | url | expect_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.
| Type | Un 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 web | L'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 |
|---|---|
auth | La connexion et le mot de passe, et que l'instance accepte les connexions SQL |
unreachable | Le nom d'hôte, le port et le pare-feu entre le serveur Excubius et le système |
timeout | Le chemin réseau ; le système n'a pas répondu à temps |
query | Une autorisation manquante de la connexion |
config | Un é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}avecattributesouentity_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.