Modifier les seuils et désactiver des vérifications
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.
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 :
| Partie | Valeurs |
|---|---|
| Operator | >, >=, <, <=, ==, !=, in, not_in, matches |
| Value | Un nombre dans l'unité de la vérification, affichée à côté du champ, ou une liste pour in et not_in |
| For | Facultatif. 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
- Ouvrez la ressource et sélectionnez l'onglet Checks. Utilisez Search checks ou Only problems pour trouver la vérification.
- 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.
- 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) sursql-ventas-01, définissez Warning level sur<900pendant10m. - 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é
- Ouvrez Settings › Entities.
- 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.
- Sous Set a default for a check, choisissez la vérification, par exemple CPU utilization (SQL process) (
sqlserver.cpu_percent), puis sélectionnez Add. - Pour chaque niveau, choisissez :
- Inherit : conserver ce qui vient d'au-dessus.
- Set here : saisir l'Operator, la Value et For, par exemple
>75pendant15m. - Turn off here : ce niveau ne déclenche aucune alerte sur cette entité ni en dessous.
- 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âche | Requête |
|---|---|
| Voir les niveaux effectifs et l'origine de chacun | GET /resources/{id}/checks |
| Définir des niveaux sur une ressource | PATCH /resources/{id}/checks/{check_id} avec thresholds |
| Revenir aux niveaux hérités | Le même PATCH avec "thresholds": null |
| Désactiver ou activer une vérification | Le même PATCH avec "enabled": false ou true |
| Modifier l'intervalle | Le 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}'