Versions Compared

Old Version 5

changes.mady.by.user Shinken Trainee

Saved on

compared with

New Version 6

changes.mady.by.user Jroy

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Scroll Ignore
scroll-viewporttrue
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmlfalse
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 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".


Exemple: par défaut, nous livrons un module dont le nom est " named-pipe "Pour l'activer, vous devrez choisir un nom pour le module et creer un fichier de configuration ( voir le chapitre suivant ) :

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


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


Code Block
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
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
module_type 
Texte--- named-pipe Ne peut être modifié.

Configuration du fichier passe-plat

NomTypeUnitéDéfautCommentaire
Code Block
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
Anchor
UtilisationDuModule
UtilisationDuModule

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