Description

Le module écoute des requêtes HTTP pour ensuite effectuer des actions sur les hôtes/clusters ou checks concernés.

Un simple curl ou appel HTTP dans votre programme suffit pour envoyer des actions à Shinken.

Poser ou Enlever une Prise en compte sur un hôte, un cluster ou un check

Paramètres de l'appel

NomObligatoireDescription
user
(tick)Nom de l'utilisateur
password
(tick)Mot de passe de l'utilisateur
Méthode HTTP utilisé
(tick)POST
action

Options disponibles:
  • add : ajoute la prise en compte ( par défaut )
  • delete : supprime la prise en compte
time_stamp

La date d'activation de la prise en compte.
  • Par défaut, la date d'appel de l'API sera utilisée.
host_name
(tick)Nom de l'hôte
service_description

Nom du check ( si la cible un check )
comment

Le commentaire de la prise en compte
notify

Permet de notifier les contacts ( qui sont signalés sur l'élément comme recevant les notifications ).

  • 1 : envoi de notification
  • 0 : pas d'envoi de notification
author

Nom de l'auteur de la prise en compte.

  • Par défaut "anonyme" qui correspond à un utilisateur lambda non déclaré dans Shinken Enterprise.
sticky

Défini le mode de suppression automatique de la prise en compte.

  • 1 : la prise en compte est automatiquement enlevée lorsque le statut change. ( par défaut )

Le statut inconnu est ignoré pour déterminer la suppression
La prise en compte ne s'enlèvera pas dans les cas suivants :

      • si attention ⭢ inconnu

      • si critique ⭢ inconnu

      • si attention ⭢ inconnu ⭢ attention

      • si critique ⭢ inconnu ⭢ critique

  • 2 : la prise en compte est automatiquement enlevée lorsque le statut devient OK.

La valeur par défaut est modifiable dans le fichier shinken.cfg ( voir la page Fichier de configuration ( shinken.cfg ) ).

Attention, si vous modifiez la valeur par défaut dans le fichier shinken.cfg, elle impactera la valeur pour l'UI de Visualisation.

persistent
(minus)
( déprécié )

Défini si la prise en compte sera toujours présente après un redémarrage des services Shinken.

  • 1 : la prise en compte sera toujours présente

Dans Shinken Entreprise, ce comportement est celui par défaut et ne peut pas être changé.
Option présente dans Shinken Framework, dépréciée dans Shinken Entreprise.


Exemple:

curl -u user:password -X POST -d "time_stamp=$(date +%s)&host_name=host-checked&service_description=service-checked&
comment=Nous sommes entrain de corriger le problème&notify=1" http://shinken-srv:7760/acknowledge