Concept
Cette modulation permet de modifier le statut retourné par un Check, en fonction de la période de temps, de son statut, et de sa sortie.
Un cas d'usage peut être, par exemple, d'éliminer des faux positifs ou négatifs identifiés, sur des sondes particulières, sans avoir à modifier le code de la sonde.
Un autre cas d'usage est de transformer certains status comme le Warning ou Unknown en un Critique dans le but de simplifier leur interprétation.
Onglet générique
Edition depuis l'interface de Configuration
- Nom de la modulation de résultatsName
- Cette propriété définit le nom de la modulation de résultatrésultats.
- Période de Modulation Period
- Cette propriété définit la période de temps durant laquelle la modulation de résultat résultats sera effective.
- ActivéEnabled
- Cette propriété permet de définir si la modulation de résultat résultats est activée ou non.
- Pack
- Cette propriété permet de définir dans quel pack se trouve la Modulation de Résultat.
- Règle de sortie
- Cette propriété permet de définir les règles d'application de la modulation.
- Une règle peut définir un statut et/ou une expression régulière qui détermine si elle sera appliquée. Si les deux sont renseignés, les deux doivent être vérifiés pour que la règle s'applique.
- Les règles sont interprétées dans l'ordre. La première règle vérifiée changera la sortie de la sonde.
- Les règles sont basées sur :
- la période de temps (période de temps durant laquelle la modulation de résultats sera effective)
- le statut actuel du check (OK, WARNING, CRITIQUE, UNKNOWN ou n'importe quel statut)
- la sortie du check (optionnel, via l'utilisation d'une expression régulière)
- La première règle qui coïncide sera utilisée et l'évaluation des règles suivantes ne sera pas effectuée.
Un cas d'usage peut être, par exemple, d'éliminer des faux positifs ou négatifs identifiés, sur des sondes particulières, sans avoir à modifier le code de la sonde. Un autre cas d'usage est de transformer certains statuts comme le Warning ou Unknown en un Critique dans le but de simplifier leur interprétation.
- Cette propriété permet de définir les règles d'application de la modulation.
Edition depuis un fichier Cfg
Les modulations de résultats possèdent une syntaxe particulière dans Shinken Entreprise.
La règle de sortie est en effet un champ qui doit respecter une syntaxe particulière. Cette syntaxe se présente comme suivant:
| Code Block |
|---|
define resultmodulation {
...
output_rules regle_1|regle_2|...|regle_n
...
} |
La règle de sortie est constituée d'une succession de règles, qui seront evaluées les unes après les autres. La première règle satisfaite arrête l'évaluation de la règle de sortie.
Les règles suivent le format suivant: