Versions Compared

Old Version 19

changes.mady.by.user Benoit ARCIUOLO

Saved on

compared with

New Version Current

changes.mady.by.user benjamin martin

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmltrue
Panel
titleSommaire

Table of Contents
stylenone

Voir la mise en place de la configuration du module : Module receiver-module-webservice

Script interpréteur des traps

Le script va se charger d’interpréter les futurs traps SNMP reçus pour les envoyer à Shinken.

Pour

les hôtes

un hôte

Ajouter le script suivant que l’on appellera submit_host_result_to_receiver dans le dossier des plugins Shinken (/var/lib/shinken-user/libexec/ ) :

Code Block
#!/bin/bash

# get the current date/time in seconds since UNIX epoch
datetime=`date +%s`
 
# Arguments:
# $1 = host_name (Short name of host that the service is associated with)
# $2 = return_code (An integer that determines the state of the service check, 0=OK, 1=WARNING, 2=CRITICAL,3=UNKNOWN).
# $3 = plugin_output (A text string that should be used as the plugin output for the service check)
 
# Beware to update user/password and shinken-srv address
curl -u user:password -X POST -d "time_stamp=$datetime&host_name=$1&return_code=$2&output=$3" http://shinken-srv:7760/push_check_result
Warning
titleImportant

Penser à modifier les valeurs suivantes dans le script :

  • user et password : user et password depuis la configuration de votre module receiver-module-webservice
  • shinken-srv : adresse de votre serveur receiver où se situe le module receiver-module-webservice


On le rend exécutable et on le donne à l’utilisateur Shinken.

Code Block
chown shinken:shinken /var/lib/shinken-user/libexec/submit_host_result_to_receiver
chmod +x /var/lib/shinken-user/libexec/submit_host_result_to_receiver


Pour tester le script et simuler une réception d'un trap translaté au format Shinken, il suffit d’exécuter la commande suivante qui va faire passer l'hôte en état critique :

Code Block
/var/lib/shinken-user/libexec/submit_host_result_to_receiver HÔTE 2 "test envoi trap - CRITIQUE"
Info

Les arguments sont:

  • $1 = Le nom de la machine concerné par la trap
  • $2 = Le code de retour ( 0=OK, 1=WARNING, 2=CRITICAL, 3=UNKNOWN )
  • $3 = Un message texte correspondant à la sortie de la commande.


L'hôte devrait passer en critique, et si au bout de la période du seuil de fraîcheur, aucun nouveau trap n'a été reçu, alors la commande check-host-alive fera repasser le check à OK ( si bien sûr l'hôte est accessible via le réseau ).

Warning
titleAttention

Si vous ne voyez pas votre hôte passer en critique, il est possible que vous n'ayez pas désactivé la vérification active sur votre hôte. Pour modifier cela, rendez-vous dans l'interface de configuration, cliqué sur votre hôte et dans supervision, mettez à Faux l'actif activé comme sur l'image ci-dessous :

Image Added

Pour

les checks

un check

Ajouter le script suivant que l’on appellera submit_check_result_to_receiver dans le dossier des plugins Shinken ( /var/lib/shinken-user/libexec/ ) :

Code Block
#!/bin/bash

# get the current date/time in seconds since UNIX epoch
datetime=`date +%s`
 
# Arguments:
# $1 = host_name (Short name of host that the service is associated with)
# $2 = svc_description (Description of the service)
# $3 = return_code (An integer that determines the state of the service check, 0=OK, 1=WARNING, 2=CRITICAL,3=UNKNOWN).
# $4 = plugin_output (A text string that should be used as the plugin output for the service check)
 
# Beware to update user/password and shinken-srv address
curl -u user:password -X POST -d "time_stamp=$datetime&host_name=$1&service_description=$2&return_code=$3&output=$4" http://shinken-srv:7760/push_check_result
Warning
titleImportant

Penser à modifier les valeurs suivantes dans le script :

  • user et password : user et password depuis la configuration de votre module receiver-module ws-arbiterwebservice
  • shinken-srv : adresse de votre serveur receiver Receiver où se situe le module wsreceiver-module-arbiterwebservice


On le rend exécutable et on le donne à l’utilisateur Shinken.

Code Block
chown shinken:shinken /var/lib/shinken-user/libexec/submit_check_result_to_receiver
chmod +x /var/lib/shinken-user/libexec/submit_check_result_to_receiver


Pour tester le script et simuler une réception d'un trap translaté au format Shinken, il suffit d’exécuter la commande suivante qui va faire passer le service en état critique :

Code Block
/var/lib/shinken-user/libexec/submit_check_result_to_receiver HÔTE CHECK 2 "test envoi trap - CRITIQUE"
Info

Les arguments sont:

  • $1 = Le nom de la machine concerné par la trap
  • $2 = Le nom du check ( doit correspondre au nom donnée dans la définition du check Shinken. dans cet exemple : TRAP )
  • $3 = Le code de retour ( 0=OK, 1=WARNING, 2=CRITICAL, 3=UNKNOWN )
  • $4 = Un message texte correspondant à la sortie de la commande.


Le check devrait passer en critique, et si au bout de la période du seuil de fraîcheur, aucun nouveau trap n'a été reçu, alors la commande check-host-alive fera repasser le check à OK ( si bien sûr l'hôte est accessible via le réseau ).

Warning
titleAttention

Si vous ne voyez pas votre check passer en critique, il est possible que vous n'ayez pas désactivé la vérification active sur votre check. Pour modifier cela, rendez-vous dans l'interface de configuration, cliqué sur votre check et dans supervision, mettez à Faux l'actif activé comme sur l'image ci-dessous :

Image Added