Aller au contenu

Moteur engine-dynamic-infos (Pro)

Info

Disponible uniquement en édition Pro.

Le moteur engine-dynamic-infos permet d'ajouter des informations aux alarmes. Ces informations sont définies avec des règles indiquant dans quelles conditions une information doit être présente sur une alarme.

Utilisation

Options du moteur

La commande engine-dynamic-infos -help liste toutes les options acceptées par le moteur.

Fonctionnement

Règles

Les règles sont définies dans la collection MongoDB dynamic-infos.

Une règle est représentée par un document JSON de la forme suivante :

{
    // Un identifiant unique :
    "_id": "dynamic_infos_1",

    // Un nom et une description, qui sont affichés dans la vue d'exploitation :
    "name": "...",
    "description": "...",

    // Des patterns indiquant dans quelles conditions les informations doivent
    // être ajoutées, par exemple :
    "entity_patterns": [{
        "type": "resource",
    }],
    "alarm_patterns": [{
        "v": {
            "state": {
                "val": 3
            }
        }
    }],

    // une liste d'informations à ajouter, par exemple :
    "infos": [
        {"name": "type", "value": "url"},
        {"name": "url", "value": "http://help.local/zabbix-critical"}
    ]
}

Les informations définies dans infos sont ajoutées aux alarmes correspondant aux patterns entity_patterns et alarm_patterns, dans v.infos.<rule_id>. Par exemple, si la règle ci-dessus est définie, le champ v.infos.dynamic_infos_1 des alarmes critiques sur des ressources contiendra :

{
    "type": "url",
    "url": "http://help.local/zabbix-critical"
}

Ces informations seront présentes dans l'alarme tant qu'elle correspondra aux patterns entity_patterns et alarm_patterns. Dans l'exemple précédent, si une alarme passe d'une criticité critique à majeure, l'information v.infos.dynamic_infos_1 est supprimée.

Templates

Les champs value sont personnalisables grâce aux templates. Les templates permettent de générer du texte en fonction de la criticité de l'alarme ou de l'entité.
Pour plus d'informations, vous pouvez consulter la documentation sur les templates Golang.

Seules les fonctions suivantes sont disponibles dans les templates dynamic-infos :

  • lowercase
  • uppercase
  • split
  • trim

Un exemple concret d'utilisation du moteur engine-dynamic-infos pour l'affichage de consignes techniques dans le bac à alarmes est disponible dans le guide d'utilisation.

Pré remplissage des attributs

Lorsque vous devez saisir des règles d'informations dynamiques similaires, vous avez la possibilité de pré remplir les attributs de celles-ci pour ne plus avoir que la saisie des valeurs à réaliser.

Pour cela, vous devez

  • Ajouter un modèle depuis l'interface graphique :

Ajouter un modèle

  • Appuyer sur le bouton +

Ajouter un modèle

  • Saisir un titre puis des attributs puis cliquer sur "Soumettre"

Ajouter un modèle

À ce stade, il vous reste à instancier le modèle avec vos valeurs

Instancier un modèle

Dernière mise à jour: 2021-09-02