Description

Les Taggers sont des outils qui lisent les hôtes détectés (automatiquement ou manuellement) et leur appliquent des règles. Si un hôte correspond à une règle, celle-ci sera appliquée et modifiera la définition de l'hôte.

Activation du module

Le module ip-tag-dmz est un module qui peut être activé seulement sur le démon Synchronizer.

  • L'activation du module s'effectue en ajoutant le nom de ce module dans le fichier de configuration du démon Synchronizer.
  • Pour ce faire, ouvrer le fichier de configuration du Synchronizer à l'emplacement /etc/shinken/synchronizers/synchronizer-master.cfg, et ajouter le nom de votre module "ip-tag-dmz".


Exemple: par défaut, nous livrons un module dont le nom est "ip-tag-dmz":

Modifiez le DEMON-TYPE, la liste des module et le MODULE-NAME

define synchronizer {
    [...]
    modules             Cfg_password, synchronizer-module-database-backup, ip-tag-dmz
    [...]
}


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

service shinken-synchronizer restart


Configuration

La configuration du module se trouve par défaut dans le fichier  /etc/shinken/modules/ip-tag-dmz.cfg

  • Vous trouverez aussi systématiquement un exemple dans /etc/shinken-user-example/configuration/daemons/synchronizers/taggers/ip-tag-dmz.cfg


Exemple de fichier de configuration


#===============================================================================
# ip-tag-*
#===============================================================================
# Daemons that can load this module:
# - synchronizer (into a tagger object)
# This module add new templates into hosts objects based on their IP range. For example to set a DMZ template is an host is in a DMZ ip range.
#===============================================================================


define module{

    #======== Module identity =========
    # Module name. Must be unique
    module_name            ip-tag-dmz

    # Module type (to load module code). Do not edit.
    module_type            sync_ip_tag




    #======== Ip range definiton, and objects edition =========
    # IP range to detect. Should looks like:   XXX.XXX.XXX.XXX/YY
    ip_range               172.20.0.0/30

    # property: which property to edit on the hosts. Default: use   (templates definitions)
    property               use

    # method: how to edit the host "property". Several methods are available:
    # - replace = put the value if not another one is in place
    # - append  = add the value at the END
    # - prepend = add the value at the BEGINING
    # - set     = just the value, erase the previous value set by other tagger or source.
    method                 append

    # value:  which value to set on the property
    value                  DMZ

}  


Détails des sections composant le fichier de configuration

Identification du module

Il est possible de définir plusieurs instances de module de type sync_ip_tag dans votre architecture Shinken.

  • Chaque instance devra avoir un nom unique.


NomTypeUnitéDéfautCommentaire


module_name


Texte---ip-tag-dmz

Nous vous conseillons de choisir un nom en fonction de l'utilisation du module pour que votre configuration soit simple à maintenir.

Doit être unique.


module_type 


Texte---sync_ip_tagNe peut être modifié.


Configuration du tagger

Ces paramètres vous permettront de définir un tagger basé sur les plages IP


	...
    #======== Ip range definiton, and objects edition =========
    # IP range to detect. Should looks like:   XXX.XXX.XXX.XXX/YY
    ip_range               172.20.0.0/30

    # property: which property to edit on the hosts. Default: use   (templates definitions)
    property               use

    # method: how to edit the host "property". Several methods are available:
    # - replace = put the value if not another one is in place
    # - append  = add the value at the END
    # - prepend = add the value at the BEGINING
    # - set     = just the value, erase the previous value set by other tagger or source.
    method                 append

    # value:  which value to set on the property
    value                  DMZ
	...  



NomTypeUnitéDéfautCommentaire


ip_range


TexteIP/MASK172.20.0.0/30Rang d'IP à détecter


property


Texte---useQuelle propriété modifier sur l'hôte


method


Texte---append
  • replace : mettre la valeur si aucun autre n’est en place
  • append  : ajoute la valeur à la FIN
  • prepend : ajoute la valeur au DÉBUT
  • set : juste la valeur, effacer la valeur précédente définie par un autre tagger ou source


value


Texte---DMZValeur à définir sur la propriété


Mise en place du tagger

Vous devez éditer la définition du tagger pour la lier au nouveau module dans le fichier /etc/shinken/taggers/ip-tags.cfg:


define tagger {
  tagger_name    ip-tags
  order          1
  modules        ip-tag-dmz,ip-tag-dc1
  description    This tagger will tag hosts based on their ip range
}


La propriété tagger_name ne doit pas contenir les caractères suivants:

  • <
  • >
  • "
  • '

Pour que les modifications soient prises en compte, vous devez redémarrer le Synchronizer.


Si votre configuration est correcte, vous devriez retrouver votre tagger en bas de page de l'interface de configuration :