This is a translation of the original English documentation page. Help us make it better.

3 Scripts d'alerte personnalisés

Aperçu

Si vous n'êtes pas satisfait des types de médias existants pour l'envoi d'alertes, il existe une autre façon de le faire. Vous pouvez créer un script qui gérera la notification à votre façon.

Les scripts d'alerte sont exécutés sur le serveur Zabbix. Ces scripts sont situés dans le répertoire défini dans la variable AlertScriptsPath du fichier de configuration serveur.

Voici un exemple de script d'alerte :

#!/bin/bash
       
       to=$1
       subject=$2
       body=$3
       
       cat <<EOF | mail -s "$subject" "$to"
       $body
       EOF

À partir de la version 3.4, Zabbix vérifie le code de sortie des commandes et des scripts exécutés. Tout code de sortie différent de 0 est considéré comme une erreur d'exécution de commande. Dans ce cas, Zabbix essaiera de répéter l'exécution en échec.

Les variables d'environnement ne sont pas conservées ou créées pour le script, elles doivent donc être gérées explicitement.

Configuration

Pour configurer des scripts d'alerte personnalisés comme type de média :

  • Allez dans Administration → Types de média
  • Cliquez sur Créer un type de média

L'onglet Type de média contient les attributs généraux du type de média :

Tous les champs de saisie obligatoires sont marqués d'un astérisque rouge.

Les paramètres suivants sont spécifiques au type de média de script :

Paramètre Description
Nom du script Entrez le nom du script.
Paramètres de script Ajouter des paramètres de ligne de commande au script.
Les macros {ALERT.SENDTO}, {ALERT.SUBJECT} et {ALERT.MESSAGE} sont pris en charge dans les paramètres de script.
La personnalisation des paramètres de script est prise en charge depuis Zabbix 3.0.

Voir les paramètres de type de média communs pour plus de détails sur la façon de configurer les messages par défaut et les options de traitement des alertes.

Même si un script d'alerte n'utilise pas de messages par défaut, les modèles de message pour les types d'opérations utilisés par ce type de média doivent toujours être définis, sinon aucune notification ne sera envoyée.

Comme le traitement parallèle des types de médias est implémenté depuis Zabbix 3.4.0, il est important de noter qu'avec plus d'un type de média de script configuré, ces scripts peuvent être traités en parallèle par les processus alerteurs. Le nombre total de processus d'alerte est limité par le paramètre StartAlerters.

Media type testing

To test a configured script media type:

  • Locate the relevant script in the list of media types.
  • Click on Test in the last column of the list (a testing window will open).
  • Edit the script parameter values, if needed (editing affects the test procedure only, the actual values will not be changed).
  • Click on Test.

Média utilisateur

Une fois le type de média configuré, allez dans la section Administration → Utilisateurs et modifiez le profil de l'utilisateur pour attribuer un média de ce type à l'utilisateur. Les étapes de configuration des médias utilisateur, communes à tous les types de médias, sont décrites sur la page Types de médias.

Notez que lors de la définition d'un média utilisateur, un champ Envoyer vers ne peut pas être vide. Si ce champ n'est pas utilisé dans un script d'alerte, entrez n'importe quelle combinaison de caractères pris en charge pour contourner les exigences de validation.