Aller au contenu principal
Version : 0.4 · actuelle

Modifier les seuils et désactiver des vérifications

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

Chaque vérification part de la base de référence de son entrée dans le catalogue. Vous la modifiez là où c'est pertinent : sur une entité, pour que toutes les ressources situées en dessous suivent, ou sur une seule ressource qui fait exception. Ce guide présente les deux cas, explique comment revenir aux valeurs héritées et comment désactiver une vérification ou l'un de ses niveaux.

Avant de commencer​

  • Pour modifier une vérification sur une ressource, vous devez disposer du rôle Editor ou d'un rôle supérieur sur l'entité de la ressource.
  • Pour définir une valeur par défaut d'entité, vous devez disposer du rôle Entity admin sur cette entité.
  • Sachez d'où viennent les valeurs : la base de référence, puis chaque entité de la racine vers le bas, puis la ressource. La valeur la plus spécifique l'emporte. Consultez Seuils et bases de référence.
astuce

Définissez les valeurs aussi haut que possible dans l'arborescence et ne remplacez que les exceptions. Une valeur par défaut définie une seule fois sur Combray SA › Production couvre chaque serveur ajouté ultérieurement à cet endroit.

Comment un niveau est défini​

Chaque vérification possède un niveau Warning et un niveau Critical. Chaque niveau comprend :

PartieValeurs
Operator>, >=, <, <=, ==, !=, in, not_in, matches
ValueUn nombre dans l'unité de la vérification, affichée à côté du champ, ou une liste pour in et not_in
ForFacultatif. La durée pendant laquelle la condition doit persister avant l'ouverture de l'alerte, par exemple 30s, 15m, 1h ou 1d. Cela absorbe les pics brefs ; le rétablissement est immédiat

Certaines vérifications comparent des états plutôt qu'une valeur à des limites, par exemple l'intégrité d'un réplica de groupe de disponibilité. Leurs règles viennent du catalogue, et l'éditeur l'indique au lieu d'afficher des niveaux.

Modifier un seuil sur une ressource​

  1. Ouvrez la ressource et sélectionnez l'onglet Checks. Utilisez Search checks ou Only problems pour trouver la vérification.
  2. Sélectionnez l'icône de crayon, Edit, sur la ligne de la vérification. La boîte de dialogue affiche l'identifiant de la vérification, sa base de référence et les niveaux actuels.
  3. Pour chaque niveau à modifier, laissez This level raises alerts sélectionné et saisissez l'Operator, la Value et, si nécessaire, For. Par exemple, pour Page life expectancy (sqlserver.ple_seconds) sur sql-ventas-01, définissez Warning level sur < 900 pendant 10m.
  4. Sélectionnez Save.

La ligne affiche maintenant les nouveaux niveaux, marqués (this resource). Les niveaux que vous n'avez pas modifiés conservent leurs valeurs héritées.

Pour revenir aux valeurs héritées, rouvrez la boîte de dialogue et sélectionnez Back to inherited thresholds. Le bouton n'apparaît que lorsque la ressource possède ses propres valeurs.

Définir une valeur par défaut pour une entité​

  1. Ouvrez Settings › Entities.
  2. Ouvrez le menu d'actions de l'entité, par exemple Production, et sélectionnez Threshold defaults. Le panneau répertorie les vérifications que cette entité définit elle-même ; elle hérite de toutes les autres.
  3. Sous Set a default for a check, choisissez la vérification, par exemple CPU utilization (SQL process) (sqlserver.cpu_percent), puis sélectionnez Add.
  4. Pour chaque niveau, choisissez :
    • Inherit : conserver ce qui vient d'au-dessus.
    • Set here : saisir l'Operator, la Value et For, par exemple > 75 pendant 15m.
    • Turn off here : ce niveau ne déclenche aucune alerte sur cette entité ni en dessous.
  5. Sélectionnez Save.

Toutes les ressources situées sous l'entité utilisent désormais cette valeur par défaut, sauf si une entité inférieure ou la ressource la modifie. Dans l'onglet Checks de chaque ressource, le niveau indique l'entité dont il provient.

Pour supprimer une valeur par défaut, sélectionnez l'icône de corbeille à côté de celle-ci, Remove the default of cette vérification. Les ressources situées en dessous héritent alors de nouveau des niveaux supérieurs.

Désactiver une vérification​

Sur une ressource, ouvrez l'onglet Checks et désactivez la vérification dans la colonne On, ou décochez Check runs dans la boîte de dialogue de la vérification. La vérification cesse de s'exécuter sur cette ressource et elle est répertoriée comme Off, afin que personne n'oublie qu'elle existe. Réactivez-la de la même façon.

Pour qu'une vérification ne déclenche plus d'alertes sur toute une entité, ouvrez ses Threshold defaults, ajoutez la vérification et définissez Warning level et Critical level sur Turn off here. La vérification continue de s'exécuter et d'enregistrer des valeurs sur chaque ressource située en dessous, mais elle n'y déclenche aucune alerte. Utilisez cette méthode pour les vérifications qui n'ont pas de sens dans une branche, comme les vérifications de serveur de rapports là où il n'y a pas de serveur de rapports.

Modifier la fréquence d'exécution d'une vérification​

Dans la boîte de dialogue de la vérification, saisissez un Interval compris entre 10s et 7d, par exemple 30s, 5m ou 1h. Laissez-le vide pour utiliser l'intervalle du catalogue, que le champ affiche. La ligne signale un intervalle modifié par la mention changed.

Utiliser l'API​

Toute modification par l'API respecte les mêmes rôles et elle est consignée dans le journal d'audit. $BASE vaut https://<your server>/api/v1 et H contient votre jeton ; consultez Démarrage rapide : ajouter une instance SQL Server avec l'API.

TâcheRequête
Voir les niveaux effectifs et l'origine de chacunGET /resources/{id}/checks
Définir des niveaux sur une ressourcePATCH /resources/{id}/checks/{check_id} avec thresholds
Revenir aux niveaux héritésLe même PATCH avec "thresholds": null
Désactiver ou activer une vérificationLe même PATCH avec "enabled": false ou true
Modifier l'intervalleLe même PATCH avec "interval_seconds", de 10 à 604800
Voir les valeurs par défaut propres à une entitéGET /entities/{id}/thresholds
Définir une valeur par défaut d'entitéPUT /entities/{id}/thresholds/{check_id}
Supprimer une valeur par défaut d'entitéDELETE /entities/{id}/thresholds/{check_id}

Les clés que peut contenir un remplacement de niveau sont warn, crit, expect, window et sigma. Une clé définie sur null désactive cette partie à ce niveau.

# one resource: warn when page life expectancy stays under 900 s for 10 minutes
curl -s "${H[@]}" -X PATCH "$BASE/resources/$SQL01/checks/sqlserver.ple_seconds" \
-d '{"thresholds": {"warn": {"op": "<", "value": 900, "for": "10m"}}}' | jq .thresholds

# the Production entity: CPU warning above 75% for 15 minutes, no critical level
curl -s "${H[@]}" -X PUT "$BASE/entities/$PROD/thresholds/sqlserver.cpu_percent" \
-d '{"warn": {"op": ">", "value": 75, "for": "15m"}, "crit": null}'