2 Commandes à distance

Aperçu

Avec les commandes à distance, vous pouvez définir qu'une certaine commande prédéfinie est exécutée automatiquement sur l'hôte surveillé lorsqu'une condition donnée se produit.

Les commandes à distance constituent donc un mécanisme puissant pour une surveillance proactive intelligente.

Dans les utilisations les plus évidentes de cette fonctionnalité, vous pouvez essayer de :

• Redémarrer automatiquement une application (serveur web, middleware, CRM) si elle ne répond pas
• Utiliser la commande IPMI 'reboot' pour redémarrer un serveur distant s'il ne répond pas aux requêtes
• Libérer automatiquement de l'espace disque (suppression des fichiers anciens, nettoyage de /tmp) en cas de manque d'espace disque
• Migrer une VM d'une machine physique vers une autre en fonction de la charge CPU
• Ajouter de nouveaux nœuds à un environnement cloud en cas de ressources CPU (disque, mémoire, etc.) insuffisantes

La configuration d'une action pour les commandes à distance est similaire à celle de l'envoi d'un message, la seule différence étant que Zabbix exécutera une commande au lieu d'envoyer un message.

Les commandes à distance peuvent être exécutées par le serveur Zabbix, le proxy ou l'agent. Les commandes à distance sur l'agent Zabbix peuvent être exécutées directement par le serveur Zabbix ou via le proxy Zabbix. Sur l'agent Zabbix comme sur le proxy Zabbix, les commandes à distance sont désactivées par défaut. Elles peuvent être activées en :

• ajoutant un paramètre AllowKey=system.run[*] dans la configuration de l'agent ;
• définissant le paramètre EnableRemoteCommands sur 1 dans la configuration du proxy.

Les commandes à distance exécutées par le serveur Zabbix sont lancées comme décrit dans Exécution des commandes, y compris la vérification du code de sortie.

Les commandes à distance sont exécutées même si l'hôte cible est en maintenance.

Limite des commandes distantes

La limite des commandes distantes après résolution de toutes les macros dépend du type de base de données et du jeu de caractères (les caractères non ASCII nécessitent plus d’un octet pour être stockés) :

La sortie de l’exécution d’une commande distante (valeur de retour) est limitée à 16 Mo (y compris les espaces de fin qui sont tronqués). La limite des commandes distantes IPMI dépend de la bibliothèque IPMI installée. Notez que les limites de la base de données s’appliquent à toutes les commandes distantes.

Configuration

Ces commandes à distance exécutées sur l'agent Zabbix (scripts personnalisés) doivent d'abord être activées dans la configuration de l'agent.

Assurez-vous que le paramètre AllowKey=system.run[<command>,*] est ajouté pour chaque commande autorisée dans la configuration de l'agent afin d'autoriser une commande spécifique en mode nowait. Redémarrez le démon de l'agent si vous modifiez ce paramètre.

Ensuite, lors de la configuration d'une nouvelle action dans Alerts > Actions > Trigger actions :

1. Définissez les conditions appropriées, par exemple, indiquez que l'action est activée en cas de problèmes de gravité Disaster sur l'une des applications Apache.

2. Dans l'onglet Operations, cliquez sur Add dans le bloc Operations, Recovery operations ou Update operations.

3. Sélectionnez l'un des scripts prédéfinis dans la liste déroulante Operation et définissez la Target list pour le script.

Scripts prédéfinis

Les scripts disponibles pour les opérations d'action (webhook, script, SSH, Telnet, IPMI) sont définis dans les scripts globaux avec Action operation sélectionné comme portée.

Par exemple :

sudo /etc/init.d/apache restart 

Dans ce cas, Zabbix tentera de redémarrer un processus Apache. Avec cette commande, assurez-vous que la commande est exécutée sur l'agent Zabbix (cliquez sur le bouton Zabbix agent en regard de Execute on).

Les commandes distantes sur Zabbix agent sont exécutées sans délai d'attente par la clé system.run[,nowait] et ne sont pas vérifiées pour les résultats d'exécution. Sur Zabbix serveur et Zabbix proxy, les commandes distantes sont exécutées avec le délai d'attente défini dans le paramètre TrapperTimeout du fichier zabbix_server.conf ou zabbix_proxy.conf et sont vérifiées pour les résultats d'exécution. Pour plus d'informations, voir Script timeout.

Permissions d'accès

Assurez-vous que l'utilisateur zabbix dispose des permissions d'exécution pour les commandes configurées. Il peut être utile d'utiliser sudo pour donner accès à des commandes privilégiées. Pour configurer l'accès, exécutez en tant que root :

visudo

Exemples de lignes pouvant être utilisées dans le fichier sudoers :

# permet à l'utilisateur 'zabbix' d'exécuter toutes les commandes sans mot de passe.
zabbix ALL=NOPASSWD: ALL

# permet à l'utilisateur 'zabbix' de redémarrer apache sans mot de passe.
zabbix ALL=NOPASSWD: /etc/init.d/apache restart

Commandes distantes avec plusieurs interfaces

Si le système cible possède plusieurs interfaces du type sélectionné (agent Zabbix ou IPMI), les commandes distantes seront exécutées sur l’interface par défaut.

Il est possible d’exécuter des commandes distantes via SSH et Telnet en utilisant une autre interface que celle de l’agent Zabbix. L’interface disponible à utiliser est sélectionnée dans l’ordre suivant :

• Interface par défaut de l’agent Zabbix
• Interface par défaut SNMP
• Interface par défaut JMX
• Interface par défaut IPMI

Commandes à distance IPMI

Pour les commandes distantes IPMI, la syntaxe suivante doit être utilisée :

<command> [<value>]

où

• <command> - une des commandes IPMI sans espaces
• <value> - 'on', 'off' ou tout entier non signé. <valeur> est un paramètre facultatif.

Exemples

Exemples de scripts globaux pouvant être utilisés comme commandes distantes dans les opérations d'action.

Exemple 1

Redémarrage de Windows dans certaines conditions.

Afin de redémarrer automatiquement Windows lorsqu'un problème est détecté par Zabbix, définissez le script suivant :

Exemple 2

Redémarrez l’hôte en utilisant le contrôle IPMI.

Exemple 3

Éteignez l’hôte en utilisant le contrôle IPMI.