Quest-ce qu'un webservice pour les checks passifs 

Le receiver a un module spécial pour les checks passifs. Ce module est appelé ws-arbiter et va ouvrir par défaut le port 7760 TCP/HTTP. Vous pourrez inscrire vos checks dans le receiver grâce à ce module.

Configuration du module 

La configuration de ce module se trouve dans le fichier  /etc/shinken/modules/ws-arbiter.cfg

Par défaut ce sera :

define module {
	module_name ws-arbiter
	module_type ws_arbiter
	host 0.0.0.0
	port 7760
	username anonymous ; If you want auth, set username and password.
	#password secret
}

Les valeurs peuvent être :

• module_name: définit un nom unique pour le module
• module_type: doit être ws_arbiter
• host: l'adresse à écouter IP . 0.0.0.0 signifie  "toutes les interfaces"
• port: port TCP à écouter
• username&password: si mis à "anonymous" aucune accréditation nécessaire. si vous mettez un nom utilisateur/mot de passe,une authentification est nécessaire

Exemple d'un push de check passif :

Pour passer le résultat d'un check d'un hôte:

curl -u user:password -d "host_name=mon-hote&service_description=check-de-mon-hote&return_code=0" --data-urlencode "output=Everything OK" http://ip-du-receiver:7760/push_check_result

• (optionnel) time_stamp= horodatage du check
• host_name= nom de l'hôte auquel vous voulez envoyer le check 
• (si check) service_description = nom du check pour lequel vous voulez pousser un résultat 
• return_code= [ 0,1,2,3 ] valeur pour le code retour. (pour rappel 0 = OK, 1 = WARNING, 2 = CRITIQUE, 3 = UNKNOWN)
• output= texte simple pour le check

• -u user:password  : necessaire que si le module demande une authentification