Principe
Les commandes sont des éléments de configuration permettant de décrire l'utilisation d'un plugin.
Elle précise ou trouver le plugin, comment l'utiliser avec les bons arguments et comment remplacer ces arguments par des données
...
Par exemple, check_ping est un plugin utiliser pour pinguer un hôte et collecter ses données de connexion :
...
| Code Block |
|---|
check_ping -H <host_address> -w <wrta>,<wpl>% -c <crta>,<cpl>% |
L'aide du plugin nous précise quels arguments passer pour utiliser la commande ::
- -H : adresse de l'hôte
- -w : wrta,wpl (Warning Round Trip Average, Warning Packet Loss)
- -c : crta, cpl (Critical Round Trip Average, Critical Packet Loss)
La commande correspondante devrait alors être :
| Code Block |
|---|
check_ping -H $HOSTADDRESS$ -w $ARG1$ -c $ARG2$ |
De cette façon, Shinken Enterprise pourra remplacer les arguments par les valeurs correspondantes en fonction de HOSTADDRESS (adresse de l'hôte) et des arguments fournis dans la commande
...
Accéder à la configuration des commandes
L'accès se fait par l'onglet "Commandes" dans le menu principal
...
En accédant à la page de configuration, une liste apparaît précisant tous les objets commandes .
En haut de la table,un barre d'outils permet de :
- Activer, désactiver, supprimer ou dupliquer la commande sélectionnée
- Filtrer la liste par nom
...
Cette table contient les informations suivantes:
...
Cette page propose également à gauche un menu action permettant de :
- Ajouter une nouvelle commande
- Montrer les commandes détectées par les modules de découverte automatique
- Accepter les différences sur les éléments sélectionnés
...
Créer une nouvelle commande
Pour créer une nouvelle commande,,utiliser le bouton "Add new [Command]" situé dans le menu d'action
.
Afin d'avoir des commandes génériques, il convient d'utiliser Utilisation des Données en tant que Variable d'accès aux données.
Onglet générique
- Command Name
- Cette propriété est utilisée pour définir un nom court permettant d'identifier une commande.
- Command
- Cette propriété est utilisée pour définir la commande à lancer.
- Command Running Timeout
- Cette propriété est utilisée pour définir le temps maximum d'exécution d'une commande. Si paramétrée à -1, le temps maximum d'exécution d'une commande sera récupéré, dans l'ordre, par l'élément Check, par l'élément Hôte, ou par la valeur par défaut (shinken.cfg:check_running_timeout).
- Enabled
- Cette propriété est utilisée pour définir si la commande est activée ou non dans la configuration.
- Pack
- Cette propriété est utilisée pour définir dans quel Pack la commande appartient.
Onglet avancé
- Poller Tag
- Cette propriété est utilisée pour définir dans quels Pollers la commande devrait être exécutée.
- Module type
- Cette propriété est utilisée pour définir si cette commande devrait être exécutée par un module spécifique de vos pollers ou reactionners.
- Run in a shell
- Cette propriété est utilisée pour définir si la commande doit être exécutée dans un shell.
Vrai:
La commande sera exécutée dans un shell (/bin/sh) et vous pourrez donc utiliser les fonctionnalités spéciales du shell comme | ; ou &&.Warning Si vos utilisateurs peuvent changer les paramètres de commandes, cela peut être un risque de sécurité qui résultera en une exécution shell d'une commande utilisateur.
- Faux:
La commande ne sera pas exécutée dans un shell et donc vous ne pourrez pas utiliser les fonctionnalités spéciales du shell comme | ; ou && mais votre sécurité sera augmentée car vous serez certain que les utilisateurs ne pourront pas exploiter vos commandes pour lancer une autre commande shell
- Cette propriété est utilisée pour définir si la commande doit être exécutée dans un shell.
...
Le formulaire de création apparaît
Ce formulaire est composé d'onglet correspondant à des catégories de propriétés :
Générique
Avancé
...
Le menu de gauche permet de :
- Valider la nouvelle commande
- Supprimer l'action
- Supprimer le commande
...
Générique
...
Les propriétés génériques contiennent les propriétés minimum réclamées pour créer une commande :
- Nom
nom de la commande
ce champs est obligatoire
- Commande
- configuration du plugin
- champs texte définissant la syntaxe du plugin
...
Avancé
...
Les propriétés avancées permettent de définir :
- Supervisé depuis
- précise le the poller tag depuis lequel la commande est lancée
- Type de Module
- précise le module que la commande doit exécuter dans le poller
...
Modifier une commande
...
Pour modifier les propriétés d'une commande, accéder à la page "Commande" depuis le menu principale puis cliquer sur le nom de la commande que vous souhaitez modifier.
...
...
Le formulaire est le même que celui de la création.
...
Une fois les changements réalisés, il faut sauvegarder. Le bouton supprimer permet de revenir à l'état prcéédent sans prise en compte ds modifications.
...
Supprimer une commande
...
Depuis le formulaire
Allez sur la page commande, puis cliquer sur le nom de la commande à supprimer .
Cliquer ensuite sur le bouton "supprimer", une fenêtre de confirmation va alors apparaître.
...
Depuis la page principale
Allez dans la page commande du menu principal, puis cliquer sur la boîte de choix placée dans la 1ère colonne à gauche.
Utilisez le menu Action et sélectionner Supprimer, puis cliquer sur le bouton Lancer.
Une fenêtre de confirmation apparaître.
Passer par le menu principal permet d'en supprimer plusieurs d'un coup.
...
Dupliquer une commande
...
Allez dans la page commande du menu principal, puis cliquer sur la boîte de choix placée dans la 1ère colonne à gauche.
...
Utilisez le menu Action et sélectionner Dupliquer, puis cliquer sur le bouton Lancer.
...
Toutes les propriétés et données sont conservées lors de la duplication.
...
La duplication n'a rien à voir avec le clonage de commande car il n'y a aucun lien entre les 2 commandes.
...
- .