Module named-pipe

Sommaire

Description

Le module named-pipe permet à Shinken de récupérer des informations via un fichier "passe plat" ( un pipe ) que l'on peut remplir de la manière de notre choix.

Par exemple, ce module peut envoyer des informations à des hôtes possédant des checks passifs ( checks qui au lieu d'effectuer une vérification régulière, va attendre de recevoir des données, plus d'informations sur les checks passifs ici : Mode actif et mode passif ).

Pour un exemple d'utilisation du module, veuillez vous référer à la section utilisation du module.

Activation du module

Le module named-pipe est un module qui peut être activé sur le démon Receiver et de l'Arbiter.

L'activation du module s'effectue en ajoutant le nom de ce module dans le fichier de configuration du démon Receiver ( ou de l'Arbiter ).
Pour ce faire, ouvrer le fichier de configuration du Receiver à l'emplacement /etc/shinken/receivers/nom_du_receiver.cfg , et ajouter le nom de votre module "named-pipe".

Pour l'activer, vous devrez choisir un nom pour le module et creer un fichier de configuration ( voir le chapitre suivant ) :

define receiver {
    [...]
    modules                   Module 1, Module 2, named-pipe
    [...]
}

Pour prendre en compte le changement de configuration, redémarrer l'Arbiter:

service-shinken-arbiter restart

Configuration

Nous ne livrons pas de configuration par défaut. Vous en trouverez une ici : named-pipe.cfg

Il faut ensuite placer ce fichier avec les autres modules dans /etc/shinken/modules/

Pensez à modifier les droits de lecture du fichier /etc/shinken/modules/named-pipe.cfg et de changer son propriétaire :

Donner les droits d'écriture :

chmod 644 /etc/shinken/modules/named-pipe.cfg

Changer de propriétaire :

chown shinken:shinken /etc/shinken/modules/named-pipe.cfg

## Module:      named-pipe
## Loaded by:   Receiver
# Receive passive host and service results, typically from check_mk plugins.
# No other commands or inputs accepted (Restricted to host and service results)
define module {
    module_name     named-pipe
    module_type     named_pipe
    command_file    /var/lib/shinken/shinken.cmd
}

Détails des sections composant le fichier de configuration

Identification du module

Il est possible de définir plusieurs instances de module de type named-pipe dans votre architecture Shinken .

Chaque instance devra avoir un nom unique.

Nom

Type

Unité

Défaut

Commentaire

module_name

Texte

---

named-pipe

Nous vous conseillons de choisir un nom en fonction de l'utilisation du module pour que votre configuration soit simple à maintenir.

Doit être unique.

module_type

Texte

---

named-pipe

Ne peut être modifié.

Configuration du fichier passe-plat

Nom	Type	Unité	Défaut	Commentaire
command_file	Chemin	---	/var/lib/shinken/shinken.cmd	Endroit où le module ira lire les informations ( comme des traps à envoyer aux éléments concernés).

Utilisation du module

Voir la page d'aide à l'utilisation du module : Script d'interprétation des traps avec le module named-pipe

Page tree