Aller au contenu principal

Gestionnaire d'évènements (auto-remédiation)

Introduction​

Les gestionnaires d'évènements sont des commandes système facultatives (scripts ou exécutables) qui sont exécutées chaque fois qu'un changement d'état d'un hôte ou d'un service se produit.

Une utilisation évidente du gestionnaire d'évènements est la possibilité pour Centreon de résoudre proactivement les problèmes avant que quiconque ne soit averti.

Quand le gestionnaire d'évènements est-il exécuté ?​

Le gestionnaire d'évènements est exécuté lorsqu'un service ou un hôte :

  • Est dans un état problématique SOFT
  • Entre initialement dans un état problématique HARD
  • Récupère initialement d'un état problématique SOFT ou HARD.

Les états SOFT et HARD sont décrits ici.

Configuration​

Étape 1 : Créer une commande​

Les commandes du gestionnaire d'évènements seront en général des scripts shell ou perl, mais il peut s'agir de n'importe quel type d'exécutable pouvant être exécuté à partir d'un invite de commandes. Au minimum, les scripts doivent prendre les macros suivantes comme arguments :

  • Pour les services : $SERVICESTATE$, $SERVICESTATETYPE$, $SERVICEATTEMPT$
  • Pour les hôtes : $HOSTSTATE$, $HOSTSTATETYPE$, $HOSTATTEMPT$

Les commandes de gestion d'évènements sont généralement exécutées avec les mêmes permissions que l'utilisateur exécutant Centreon Engine (l'utilisateur centreon-engine) sur votre machine. Cela signifie que le fichier exécuté doit disposer des permissions d'exécution appropriées pour cet utilisateur. Si une commande doit redémarrer des services système, soyez prudent, car ces actions nécessitent généralement des privilèges root, et une mauvaise gestion pourrait entraîner des risques de sécurité ou des échecs d'exécution.

Idéalement, vous devez évaluer les types de gestionnaires d'évènements que vous allez implémenter et accorder juste assez de permissions à l'utilisateur Centreon Engine pour exécuter les commandes système nécessaires. Vous voudrez peut-être essayer d'utiliser sudo pour ce faire.

  1. Pour créer une commande, allez à la page Configuration > Commandes > Divers.
  2. Créez votre command comme décrit ici.
  3. Ajoutez votre nouvelle commande à la liste blanche des commandes du collecteur qui supervisera les ressources désirées.

Étape 2 : Configurer les gestionnaires d'évènements​

  1. Allez à la page Configuration > Hôtes > Hôtes ou à la page Configuration > Services > Services par hôte et éditez vos hôtes ou vos services.

  2. Dans l'onglet Traitement des données, dans le champ Gestionnaire d'évènements, sélectionnez l'une des commandes créées à l'étape 1.

  3. Cliquez sur Sauvegarder.

Vous pouvez également configurer cette commande sur les modèles d'hôtes ou les modèles de services.

Exemple​

L'exemple ci-dessous suppose que vous supervisez un serveur HTTP sur la machine locale. Nous supposerons que l'option Max Check Attempts pour le service a une valeur de 4 ou plus (c'est-à-dire que le service est vérifié 4 fois avant qu'il ne soit considéré comme ayant un réel problème).

  1. On stocke le script du gestionnaire d'évènements dans /usr/lib/centreon/plugins/eventhandlers/restart-httpd.
#!/bin/sh
#
# Event handler script for restarting the web server on the local machine
#
# Note: This script will only restart the web server if the service is
#       retried 3 times (in a "soft" state) or if the web service somehow
#       manages to fall into a "hard" error state.
#

# What state is the HTTP service in?
case "$1" in
OK)
	# The service just came back up, so don't do anything...
	;;
WARNING)
	# We don't really care about warning states, since the service is probably still running...
	;;
UNKNOWN)
	# We don't know what might be causing an unknown error, so don't do anything...
	;;
CRITICAL)
	# Aha!  The HTTP service appears to have a problem - perhaps we should restart the server...
	# Is this a "soft" or a "hard" state?
	case "$2" in

	# We're in a "soft" state, meaning that Centreon is in the middle of retrying the
	# check before it turns into a "hard" state and contacts get notified...
	SOFT)

		# What check attempt are we on?  We don't want to restart the web server on the first
		# check, because it may just be a fluke!
		case "$3" in

		# Wait until the check has been tried 3 times before restarting the web server.
		# If the check fails on the 4th time (after we restart the web server), the state
		# type will turn to "hard" and contacts will be notified of the problem.
		# Hopefully this will restart the web server successfully, so the 4th check will
		# result in a "soft" recovery.  If that happens no one gets notified because we
		# fixed the problem!
		3)
			echo -n "Restarting HTTP service (3rd soft critical state)..."
			# Call the init script to restart the HTTPD server
			/etc/rc.d/init.d/httpd restart
			;;
			esac
		;;

	# The HTTP service somehow managed to turn into a hard error without getting fixed.
	# It should have been restarted by the code above, but for some reason it didn't.
	# Let's give it one last try, shall we?  
	# Note: Contacts have already been notified of a problem with the service at this
	# point (unless you disabled notifications for this service)
	HARD)
		echo -n "Restarting HTTP service..."
		# Call the init script to restart the HTTPD server
		/etc/rc.d/init.d/httpd restart
		;;
	esac
	;;
esac
exit 0

L'exemple de script fourni ci-dessus tentera de redémarrer le serveur web sur la machine locale :

  • Une fois que le service a été revérifié pour la troisième fois et est dans un état SOFT CRITICAL
  • Une fois que le service passe pour la première fois dans un état HARD CRITICAL.

Le script devrait théoriquement redémarrer le serveur web et résoudre le problème avant que le service ne passe dans un état de problème HARD, mais nous incluons un cas de secours dans le cas où cela ne fonctionne pas la première fois. Dans ce cas, le gestionnaire d'évènements ne sera exécuté que la première fois que le service tombe dans un état de problème HARD. Cela empêche Centreon d'exécuter en continu le script pour redémarrer le serveur web si le service reste dans un état de problème HARD.

  1. À la page Configuration > Commandes > Divers, on crée une commande avec les caractéristiques suivantes :
  • Nom : restart-httpd
  • Ligne de commande : $CENTREONPLUGINS$/eventhandlers/restart-httpd $SERVICESTATE$ $SERVICESTATETYPE$ $SERVICEATTEMPT$
  1. On édite le service désiré, puis on sélectionne la commande restart-httpd dans le champ Gestionnaire d'évènements.