Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=clean_macro_parameter


Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmltrue


Panel
titleSommaire

Table of Contents
stylenone



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 exemple d'utilisation.

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 ".


Exemple: par défaut, nous livrons un module dont le nom est " named-pipe ":


Code Block
languagetext
themeEmacsbash
define receiver {
    [...]
    modules                   Module 1, Module 2, named-pipe
    [...]
}


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


Code Block
languagetext
themeEmacs
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/



Note

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 :

Code Block
languagejs
chmod 644 /etc/shinken/modules/named-pipe.cfg


Changer de propriétaire :

Code Block
languagejs
chown shinken:shinken /etc/shinken/modules/named-pipe.cfg




Code Block
languagejs
## 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.
NomTypeUnitéDéfautCommentaire


Code Block
languagetext
themeEmacs
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.


Code Block
languagetext
themeEmacs
module_type 


Texte--- named-pipe Ne peut être modifié.


Configuration du fichier passe-plat


NomTypeUnitéDéfautCommentaire


Code Block
languagetext
themeEmacs
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