Concept
Les Taggers permettent de modifier les hôtes et pour certain les clusters suivant leurs fonctionnalités.
- Vous aurez plus de détail sur le fonctionnement général des Taggers et quand ils interviennent dans la page Modules de Sources ( imports ) et de Taggers ( qualification ) .
- Lorsque vous définissez un tagger, vous pouvez lui accrocher des modules.
- Chaque module a une fonction ;
Voici la liste des modules de Taggers existants :
Nom du module Description Module permettant de modifier n'importe quelle propriété en fonction d'une plage d’adresses IP définie.
Module permettant de modifier n'importe quelle propriété en fonction du contenu d'une propriété.
- Le modèle ou les modèles sont ajoutés si le contenu de la propriété choisie correspond à une expression régulière.
- Le modèle ou les modèles sont ajoutés si le contenu de la propriété choisie correspond à une expression régulière.
- Pour une simplicité de lecture dans l'interface, nous vous conseillons de mettre un module par tagger.
Activer un tagger
La configuration des Taggers doit être placée dans le dossier /etc/shinken/taggers/.
- Un exemple de fichier de configuration est disponible : /etc/shinken-user-example/configuration/daemons/synchronizers/taggers/MY-TAGGER.cfg
Exemple de fichier de configuration
define tagger {
tagger_name tagger-example
order 1
modules
description
}
Définition d'un tagger
Pour définir le Tagger :
Copiez le fichier d'exemple dans le répertoire /etc/shinken/taggers/
cp /etc/shinken-user-example/configuration/daemons/synchronizers/taggers/MY-TAGGER-example.cfg /etc/shinken/taggers/MY-TAGGER.cfg
Modifiez le paramètre tagger_name en y plaçant le nom du tagger.
[...] tagger_name MY-TAGGER [...] }- Modifiez le paramètre modules en y plaçant le nom du module que le tagger doit exécuter :
- pour cela, définissez un module en fonction du type d'action souhaitée :
- Soit un module de type sync_ip_tag ( Module permettant de modifier n'importe quelle propriété en fonction d'une plage d’adresses IP définie ).
- Définir ce type de module est détaillé dans la page suivant : Module de type sync_ip_tag.
- Définir ce type de module est détaillé dans la page suivant : Module de type sync_ip_tag.
- Soit un module de type sync-regexp-tag ( Module permettant de modifier n'importe quelle propriété cible si le contenu d'une propriété choisie comme critère de sélection correspond à une expression régulière )
- Définir ce type de module est détaillé dans la page suivant : Module de type sync-regexp-tag.
- Définir ce type de module est détaillé dans la page suivant : Module de type sync-regexp-tag.
- Soit un module de type sync_ip_tag ( Module permettant de modifier n'importe quelle propriété en fonction d'une plage d’adresses IP définie ).
- pour cela, définissez un module en fonction du type d'action souhaitée :
Complettez la configuration du tagger avec une description dans le paramètre description.
[...] description Ce tagger a pour objectif de ... [...] }
Détails des sections composant le fichier de configuration
Il est possible de définir plusieurs instances de Taggers dans l'architecture Shinken .
- Chaque instance devra avoir un nom unique.
| Nom | Type | Unité | Défaut | Description |
|---|---|---|---|---|
tagger_name | Texte | --- | --- | Valeur obligatoire Nom du Tagger. Le nom doit être unique parmi tous les taggers existants. Caractères interdits : |
order | Entier | --- | --- | Valeur obligatoire L'ordre d'application des Taggers. Les Taggers sont exécutés les uns à la suite des autres dans l'ordre croissant de la propriété. Si plusieurs Taggers qui s'enchaînent modifient la même propriété, il est possible qu'un Tagger annule les modifications de précédents Taggers. Attention donc à l'ordre d'exécution des Taggers |
modules | Texte | --- | --- | Valeur obligatoire Nom des modules utilisés par le Tagger. |
description | Texte | --- | --- | Une description du Tagger affichée dans l'Interface de Configuration |
Déclarer le Tagger dans le Synchronizer
L'activation des taggers se fait dans le fichier de configuration du Synchronizer :
Ajoutez le nom du Tagger au paramètre taggers dans le fichier de configuration du démon Synchronizer ( /etc/shinken/synchronizers/synchronizer-master.cfg ).
define synchronizer { [...] #======== Taggers ========= taggers TAGGER-1,TAGGER-2,MY-TAGGER [...] }Pour prendre en compte le changement de configuration, il faut redémarrer le Synchronizer :
service shinken-synchronizer restart
Affichage des Taggers sur l'interface de Configuration
Les Taggers apparaissent sur la page Principale de l'Interface de Configuration ( voir la page Page Principale ).
