Fonctionnement

Vous pouvez définir un tagger qui va utiliser automatiquement le nom pour ajouter des modèles aux hôtes / clusters détectés.

Le nom commun du tagger est regexp-tags et peut charger de nouvelles règles de nommage.

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 )
• 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.
  • append: ajoute une liste de modèle à la fin de liste des modèles déjà existante.
  • prepend: ajoute une liste de modèle au début de liste des modèles déjà existante.
  • set: juste la valeur, en écrasant la valeur précédente.
• 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.