Documentations

Utilisation des modèles d’action

Besoin d'aide ?

Objectif

Objectif : Comprendre le fonctionnement et l’utilisation des modèles d’actions.

Le modèle d’action

Définition

Un modèle d’action est une commande prédéfinie qui pourra être utilisée dans la configuration d’un service utilisateur, d’un équipement ou d’un service unitaire.

Cette commande s’exécutera uniquement lors d’un changement d’état confirmé OK vers CRITIQUE.

Sa mise en œuvre est liée à la résolution de problèmes qui incluent par exemple le redémarrage d’un service (Windows ou Linux) ou l’exécution d’une commande linux.

Ce catalogue de modèle sera enrichi en fonction des besoins de nos clients.

Les commandes d’actions prédéfinies

Les modèles d’actions prennent en charge les commandes suivantes :

Applicable A	Description	Commande d’action
Service Utilisateur	Ecriture d’une variable dans l’application externe PCvue	write_arcinfo_pcvue_variable
Equipement	Ecriture dans le fichier journal syslog de l’équipement Linux associé à l’action.	write_syslog_host
	Exécution d’une commande Dos ou Powershell sur un équipement Windows quelconque via winexe on winrm.	launch_command_windows_host
	Appel d’une URL en GET ou POST en passant des variables produit dans l’URL ou le contenu.	call_url_host
Service Unitaire	Exécution d’une commande via SSH sur tout port, sur l’équipement associé au service	launch_command_linux_debian
	Exécution d’une commande Dos ou Powershell sur un équipement Windows quelconque via winexe on winrm.	launch_command_windows_service
	Redémarrage d’un service sur OS Linux Debian, via SSH, et sur l’équipement associé au service.	restart_service_linux_debian
	Redémarrage d’un service sur OS Windows, via SSH, et sur l’équipement associé au service.	restart_service_windows
	Ecriture dans le fichier journal syslog de l’équipement Linux associé à l’action. Possibilité de ne pas exécuter cette action si l’équipement est en état CRITICAL ou INCONNU. Possibilité de ne pas exécuter cette action si l’équipement ou le service est en maintenance.	write_syslog_service
	Appel d’une URL en GET ou POST en passant des variables produit dans l’URL ou le contenu.	call_url_service

Variables Produit

Les variables produit (macro Nagios) pouvant être utilisées dans les paramètres des modèles d’actions sont les suivantes :

Pour les équipements :

$_HOSTCOMPANYNAME$
$_HOSTDOCUMENTATION$
$_HOSTHOST_CATEGORY_NAME$
$_HOSTIDHOST$
$_HOSTINSTRUCTIONS$
$HOSTADDRESS$
$HOSTALIAS$
$HOSTDOWNTIME$
$HOSTOUTPUT$
$HOSTSTATE$
$HOSTSTATETYPE$
$_HOSTCRITICALITY$

Pour les services unitaires :

$_HOSTCOMPANYNAME$
$_HOSTHOST_CATEGORY_NAME$
$_SERVICEDISPLAYNAME$
$_SERVICEDOCUMENTATION$
$_SERVICEHOSTALIAS$
$_SERVICEIDSERVICE$
$_SERVICEINSTRUCTIONS$
$HOSTADDRESS$
$HOSTDOWNTIME$
$HOSTSTATE$
$SERVICEDOWNTIME$
$SERVICEOUTPUT$
$SERVICESTATE$
$SERVICESTATETYPE$
$_HOSTCRITICALITY$
$_SERVICECRITICALITY$

Configuration

Création du modèle d’action

Pour ajouter un modèle d’action, placez-vous dans la section Configuration puis dans le menu Général > Modèles d’actions.

Cliquez sur «Ajouter» : une fenêtre de configuration s’ouvre.

Renseignez les informations générales puis cliquez sur « Valider ».

Vous pouvez ajouter des modèles d’actions pour un service utilisateur, un équipement ou un service unitaire.

Modification d’un modèle d’action

Vous pouvez modifier un modèle d’action. Pour cela, cliquez sur le nom du modèle à modifier.

Suppression d’un modèle d’action

Sélectionnez le modèle d’action à supprimer puis cliquez sur le bouton « Supprimer ».

Confirmez la suppression du modèle d’action.

Utilisation du modèle d’action

Affectation du modèle à un service utilisateur, un équipement ou un service unitaire

Pour affecter un modèle d’action sur un service unitaire, placez-vous dans la section Supervision puis dans le menu Exploitation Technique.

Exemple : Je souhaite redémarrer automatiquement le service Windows Update si celui-ci s’arrête sur mon serveur COPCGRE61.

Sélectionnez le service unitaire à configurer. La fenêtre de configuration s’ouvre. Se positionner sur l’onglet Action et choisir le modèle d’action.

Renseigner le service à redémarrer et cliquez sur Valider.

Remarque : La configuration est la même pour un service utilisateur ou un équipement.

Modification de l’affectation d’un modèle d’action

Pour modifier un modèle d’action, procéder comme pour l’affectation. Choisir dans la liste des modèles d’action la commande à utiliser.

Suppression de l’affectation d’un modèle d’action

Pour supprimer un modèle d’action d’un service unitaire, placez-vous dans la section Supervision puis dans le menu Exploitation Technique.

Sélectionnez le service unitaire à modifier. La fenêtre de configuration s’ouvre. Se positionner au niveau de l’onglet Action puis sélectionner le champ vide dans la liste Modèle.