Page History

Scroll Ignore

scroll-viewport	true
scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbook	true
scroll-eclipsehelp	true
scroll-epub	true
scroll-html	truefalse

Panel

title	Sommaire

Table of Contents

style	none

Fonctionnement

Vous pouvez définir un tagger qui utilise les plages IP pour qualifier automatiquement des hôtes et leur appliquer une règle suivant la valeur de leur IP ( propriété address )

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 (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 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:

<
>
"
'

Concept

Un Tagger utilisant un module basé sur les plages IP ( de type sync_ip_tag ) s'applique sur les hôtes, issus de l'import des sources.

Il permet de modifier un hôte, si son adresse est comprise dans la plage d’adresses IP définie par son module.

Info

Ce Tagger résout les noms DNS dans l'adresse des hôtes avant de vérifier si l'adresse est comprise dans la plage d’adresses IP.

Ce qui permet à ce Tagger de fonctionner avec une définition d'une plage IP, ce que ne peut pas faire un Tagger basé sur des expressions régulières.

Définir ou configurer un Tagger

Regarder :

La page Les modules taggers, pour mettre en place un Tagger ou en modifier un.
La page Module de type sync_ip_tag, pour créer ou modifier l'action faite, par le module, sur les hôtes.

Exemple

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
Image Removed

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.

Si le champ address d'un hôte est rempli avec un nom DNS, alors le tagger va tenter de le résoudre via une résolution DNS système classique, et prendra comme valeur l'IP ainsi récupérée.

Cas d'exemple

: automatiquement assigner au royaume Bordeaux les hôtes/clusters dont l'

ip

IP est dans

le range

la plage 192.168.0.1/24

Exemple 1 :

mettre la valeur

ip-tag-bordeaux - mettre le nom du royaume directement dans la

valeur du

propriété définissant le royaume

Si nous savons que les serveurs dans le range la plage IP 192.168.0.1/24 sont à se trouvent dans le datacenter de Bordeaux, il est intéressant pertinent de le les assigner automatiquement au royaume Bordeaux, ce qui permettra de les superviser au plus proche possible ( et donc avoir les bonnes règles de firewall par exemple pour lancer les sondes vers les serveurs ).

Nous pouvons donc définir le module suivant que nous accrochons au tagger ( comme indiqué précédemment ).

Il va fonctionner ainsi:

. Cela permet une supervision plus efficace, par exemple en utilisant le Poller du royaume Bordeaux, autorisé par les pare-feux de ces serveurs.

Le module de type sync_ip_tag suivant permet ce comportement :

Si l’adresse IP définie dans la propriété address de l’hôte appartient à la plage SI l'ip correspondant au champ address de l'hôte/cluster est dans le range 192.168.0.0/24
- ALORS, on va écraser ( paramètre method =set ) le champ realm ( property à la valeur "set" ) la propriété realm ( paramètre "property" ) avec la valeur Bordeaux ( paramètre "value" ) .

Code Block

language	js
theme	Confluence

define module{

  module_name    ip-tag-bordeaux-basic
  module_type    sync_ip_tag

  # La rangeplage IP de l'hotehôte (champ propriété address )
  ip_range       192.168.0.0/24

  
# Liste #des onnoms vad'hôte appliquerqui laseront regexpignorés surpar le nomTagger de l'hote/cluster
  matched_prop      host_name( propriété host_name )
  # ignore_hosts    


  # On va alors ecraserécraser la proprietepropriété realm avec la valeur Bordeaux
  property          realm
  method            set
  value             Bordeaux

}

Warning

title	IMPORTANT

À noter que cette méthode est facile à appréhender, mais n'est pas une bonne pratique sur le long terme :

en effet, il pourra être nécessaire de modifier d'autres propriétés liées, en lien avec le datacenter de bordeaux dans le futur ( ajout d'utilisateur à notifier sur l'hôte, dépendances réseaux ... ),
cela nécessitera d'ajouter des modules de taggers de type sync_ip_tag pour chaque nouvelle édition de propriété.

La bonne pratique est de définir un modèle d'hôte et de l'accrocher systématiquement aux équipements de ce datacenter.

Ainsi, vous pourrez avoir un modèle où mettre les futures spécificités du datacenter de bordeaux.
le prochain exemple en explique la mise en place.

Exemple 2 : ajouter

Exemple 2: plus flexible, rajouter

un modèle "bordeaux", mis en premier dans la liste des modèles ( pour être prioritaire sur les autres modèles )

Si la méthode 1 précédente fonctionne, elle n'est pas optimale :

en effet, changer le royaume par Bordeaux est utile, mais d'autres éditions de propriétés seront peut-être nécessaires dans le futur

la localisation à Bordeaux va peu être demander à ce qu'une équipe locale ait les droits d'accès et de notifications sur la machine par exemple.Il faudrait alors faire un second module, ce n'est pas l'idéal

( ajout d'utilisateur à notifier sur l'hôte, dépendances réseaux ... ).
Or la méthode précédente impose de créer un nouveau Tagger avec un nouveau module de type sync_ip_tag pour chaque nouvelle édition de propriété.

Il est donc fortement recommandé de ne pas modifier les propriétés directement, mais plutôt de passer par des modèles d'hôtes/cluster.

Il sera ainsi facile de faire des changements

en masse

sur toutes les machines situées à Bordeaux, en modifiant juste le modèle Bordeaux.

Nous pouvons donc définir le module suivant que nous accrochons au tagger ( comme indiqué au dessus ).

Il va:

Le module de type sync_ip_tag suivant permet ce comportement.

SI l’adresse IP définie dans la propriété address de l’hôte appartient à la plage SI l'ip correspondant au champ address de l'hôte/cluster est dans le range 192.168.0.0/24
- ALORS on va , on va rajouter au début ( paramètre method= à la valeur "prepend" ) le champ de la propriété use ( paramètre "property" ) avec la valeur bordeaux ( paramètre "value" ).

Code Block

language	js
theme	Confluence

define module{

  module_name    ip-tag-bordeaux-advanced
  module_type    sync_ip_tag

  # La rangeplage IP de l'hotehôte (champ propriété address )
  ip_range       192.168.0.0/24

  
# Liste #des onnoms vad'hôte appliquerqui laseront regexpignorés surpar le nomTagger de l'hote/cluster
  matched_prop      host_name( propriété host_name )
  # ignore_hosts    


  # On va alors rajouterécraser lela templatepropriété bordeauxrealm auavec debutla de use (prioritaire)valeur Bordeaux
  property          use
  method            prepend
  value             bordeauxBordeaux

}

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

Sur l'Interface de Configuration, les noms des Taggers listés sont des liens cliquables.

Panel
Image Added

Ces liens redirigent sur leurs configurations.

Panel
Image RemovedImage Added

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

Panel
Image RemovedImage Added

Page tree

Versions Compared

Old Version 5

New Version Current

Key