Page History

Fonctionnement

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-regexp-tag
• matched_prop: la propriété que l'on va regarder pour vérifier qu'elle correspond à ce que l'on recherche.
  • Par défaut, la propriété est le host_name ( Nom de l'objet hôte/cluster )
• _ip_tag.
• ip_range: si l'adresse de l'hôte est dans la plage IP fourni, les modèles seront ajoutés.matched_regexp: Regexp auquel la propriété doit correspondre
• method: Comment la modification des modèles va avoir lieu sur l’élément :
  • replace: remplace liste des modèles actuelles par une nouvelle, seulement 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 une liste le contenu de modèle à la fin de liste des modèles déjà existante value à la fin dans la propriété visé, c.a.d. property.
  • prepend: ajoute une liste le contenu de modèle value au début de liste des modèles déjà existantela propriété visé, c.a.d. property.
  • set:  juste la valeur, en écrasant la valeur précédenteforce 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
}

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.