Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Code Block
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 définie dans la propriété à vérifier, le contenu de value sera mis dans la propriété visévisée, c.a.d. property.
    • append: ajoute le contenu de value à la fin dans la propriété visévisée, c.a.d. property.
    • prepend: ajoute le contenu de value au début de la propriété visévisée, c.a.d. property.
    • set: force le contenu de value dans la propriété visévisée, 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:

Code Block
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
}


Info

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 )

Code Block
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 :


Panel


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.