Fonctionnement

Vous pouvez définir un tagger qui utilise les plages IP pour détecter automatiquement des hôtes et leur appliquer une règle.

Comment définir une nouvelle règle

Pour chaque règle, vous devez définir un nouveau module et l'ajouter dans la configuration ip-tags .

Vous pouvez copier l'exemple /etc/shinken/modules/ip-tag-dmz.cfg et le modifier

define module{
  module_name    ip-tag-dc1
  module_type    sync_ip_tag
  ip_range       192.168.0.0/24
  method         append
  property       use
  value          dc1
}

Les propriétés sont :

  • module_name: le nom du module ( doit être unique ).
  • module_type: doit être égal à sync_ip_tag.
  • ip_range: si l'adresse de l'hôte est dans la plage IP fourni, les modèles seront ajoutés.
  • method: Comment la modification des modèles va avoir lieu sur l’élément :
    • replace: si aucune valeur n’était défini dans la propriété à vérifier, le contenu de value sera mis dans la propriété visé, c.a.d. property.
    • append: ajoute le contenu de value à la fin dans la propriété visé, c.a.d. property.
    • prepend: ajoute le contenu de value au début de la propriété visé, c.a.d. property.
    • set: force le contenu de value dans la propriété visé, c.a.d. property.
  • property: quelle propriété modifier
  • value: la liste des modèles qui seront ajoutés.

Vous devez ensuite é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:

  • <
  • >
  • "
  • '


Une fois votre fichier sauvegardé, vous devez l'ajouter dans la liste des taggers du Synchronizer concerné ( par exemple /etc/shinken/synchronizers/synchronizer-master.cfg )

define synchronizer {
	[ ... ]

    # Taggers:
    #  ip-tags
    #  regexp-tags
    taggers           ip-tags, regexp-tags, my-new-tagger

	[ ... ]
}


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


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



Visualisation dans l'interface de configuration

Vous pouvez consulter la configuration des différents taggers sur nom d'hôtes présent sur le Synchronizer sur la page d'accueil en cliquant sur regexp-tags.