Page History

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 de type sync_ip_tag	Module permettant de modifier n'importe quelle propriété en fonction d'une plage d’adresses IP définie.
    Module de type sync-regexp-tag	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.

• 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/taggerMY-exampleTAGGER.cfg

Exemple de fichier de configuration

Définition d'un tagger

Pour définir le tagger Tagger :

• Copiez le fichier d'exemple dans le répertoire /etc/shinken/taggers/
  
  

  Code Block
  language text theme Emacs
  cp /etc/shinken-user-example/configuration/daemons/synchronizers/taggers/taggerMY-TAGGER-example.cfg /etc/shinken/taggers/MY-TAGGER.cfg

• Modifiez le paramètre tagger_name en y plaçant votre le nom de tagger.
  
  

  Code Block
  language js theme Confluence
  [...] 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.
        
        
    • 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.
        
        

• Complettez la configuration du tagger avec une description dans le paramètre description.
  
  

  Code Block
  language js theme Confluence
  [...] 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.

tagger_name

order

modules 

description

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 ).
  
  

  Code Block
  language js theme Confluence
  define synchronizer { [...] #======== Taggers ========= taggers           TAGGER-1,TAGGER-2,MY-TAGGER   [...] }

  
  
  

• Pour prendre en compte le changement de configuration, il faut redémarrer le Synchronizer :
  

  Code Block

  language	text
  theme	Emacs

  service shinken-synchronizer restart

  
  

  Excerpt Include
  Configuration ( Synchronizer ) Configuration ( Synchronizer ) page DefaultLink[destination=Optional[PageResourceIdentifier[spaceKey=<null>,title=Configuration ( Synchronizer )]],body=Optional.empty,tooltip=Optional.empty,anchor=Optional.empty,target=Optional.empty] nopanel true

Affichage des Taggers sur l'interface de Configuration

SCREEN À MODIFIER pour voir apparaitre "MY-TAGGER" => ne pas mettre des 2 taggers actuelles ( ip-tags et regex-tags ).

Les Taggers apparaissent sur la page Principale de l'Interface de Configuration ( voir la page Page Principale ). Excerpt IncludePage PrincipalePage Principalenopaneltrue