Page History

Fonctionnement

Vous pouvez définir un tagger qui

va utiliser automatiquement le nom pour modifier des propriétés sur les hôtes / clusters qui respectent sa règle de nommage ( une regexp ) sur une propriété.

Typiquement, le cas d'usage classique est de rajouter/modifier des templates d'hôtes/clusters sur les éléments s'ils respectent une règle de nommage sur le nom.

Comment définir une

règle Regexp

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

Vous pouvez copier l'exemple /etc/shinken/modules/ipsync-regexp-tag-dmz.cfg et dans un nouveau fichier pour le modifier

define module{
  module_name    ip   sync-regexp-tag-dc1windows
  module_type    sync_ip_   sync-regexp-tag
  ip_range   matched_prop      host_name
  matched_regexp    192.168.0.0/24*srvwin.*
  method            append
  property          use
  value          dc1   windows
}

Les propriétés sont :

• module_name: le nom du module ( doit être unique ).
• module_type: doit être égal à sync_ip_tag.-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 correspondreip_range: si l'adresse de l'hôte (champ address) est dans la plage IP fourni, on applique la modification ci après.
• method: Comment la modification de la propriété va avoir lieu sur l’élément :
  • replace: si aucune valeur n’était définie dans la propriété à vérifier, le contenu de value sera mis dans la propriété visée, c.a.d. property.
  • append: ajoute le contenu de value à la fin dans la propriété visée, c.a.d. property.
  • prepend: ajoute le contenu de value au début de la propriété visée, c.a.d. property.
  • set: force le contenu de value dans la propriété 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 alors éditer le fichier rexexp-tags pour lier le nouveau tagger dans le fichier /etc/shinken/taggers/ipregexp-tags.cfg:

define tagger {
  tagger_name    ipregexp-tags
  order          1
  modules        ipsync-regexp-tag,sync-dmz,ipregexp-tag-dc1windows
  description     This tagger will tag hostshost based on their ip rangethe host_name
}

define synchronizer {
	[ ... ]

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

	[ ... ]
}

Cas des champs address des hôtes qui sont des noms DNS

Le tagger est fait pour comparer des IP par rapport à des ranges d'IP.

Cas d'exemple: automatiquement assigner au royaume Bordeaux les hôtes/clusters dont

le nom commence par bdx

Exemple 1: mettre la valeur du royaume directement dans la valeur du royaume

Exemple 2: plus flexible, rajouter un modèle "bordeaux" ( prioritaire sur les autres modèles )

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.

Un onglet vous permet de visualiser également un résumé des règles qui vont s'appliquer.