Documentations

Utiliser le modèle de service Global-Plugin-Execution

Sur la page

Besoin d'aide ?

Avertissement :

La sortie de ce nouveau modèle de service est accompagnée de nouvelles conditions d’utilisation du produit ServiceNav disponibles ici : https://coservit.com/servicenav/fr/cgv/ . Voir notamment les articles 8 et 4.5 pour les plateformes SaaS et article 6.7 des conditions de support pour les plateformes OnPremise.

L’utilisation de ce modèle de service implique donc les conditions suivantes :

  • Le support assuré par Coservit se limite à l’exécution du code fourni par le client, et Coservit n’assure pas de support sur le code produit par le client
  • Coservit n’assure plus de support sur une ServiceNav Box dont des éléments ont pu être modifiés (en plus du fichier déposé par le client) notamment en cas d’installation ou de mise à jour de logiciels complémentaires (paquets) ou du système d’exploitation de la ServiceNav Box
  • En cas de demande support et/ou d’activité anormale au niveau de la plateforme et en cas de doute raisonnable du technicien support, Coservit se réserve le droit de déplacer/modifier le code produit par le client et d’arrêter son fonctionnement, en informant le client selon les procédures support usuelles.

Fonctionnement du modèle de service Global-Plugin-Execution

Préparation et pré-requis du programme client

L’objectif du modèle de service Global-Plugin-Execution est de permettre d’exécuter un programme personnalisé par le client et déposé sur la ServiceNav Box.

Pour fonctionner ce programme doit répondre à différentes obligations :

  • Encodage du fichier : LATIN
  • Le programme doit avoir un code retour selon le tableau ci-dessous
Valeur Statut interprété dans ServiceNav
0 OK (vert)
1 Alerte (orange)
2 Critique (rouge)
3 Inconnu (gris)
  • Retour du programme sur une seule ligne
  • Le retour peut contenir des données de performance. Dans ce cas, le retour doit être de la forme :

texte affiché dans le champ détail ServiceNav| ‘nommetrique’=valeur[unité];[seuil alerte];[seuil critique];[valeur min];[valeur max]

    • liste de nom de métriques / valeur séparées par des espaces
    • le nom de la métrique peut contenir n’importe quel caractère sauf le signe égal ou le signe quote (‘)
    • les guillemets simples pour le nom de la métrique sont facultatifs. Obligatoire si nommétrique contient des espaces
    • le nom de la métrique est libre. Il doit être inférieur à 19 caractères et unique dans la ligne de retour et ne pas contenir le signe quote (‘)
    • [seuil alerte];[seuil critique];[valeur min];[valeur max] peuvent être nuls (par exemple, si le seuil n’est pas défini ou si min et max ne s’appliquent pas). Les points-virgules non remplis peuvent être supprimés. Min et max ne sont pas requis si l’unité est %
    • valeur, seuil alerte, seuil critique, min et max sont dans la classe [-0-9] et doivent tous être de la même unité pour une métrique donnée.
    • Unité est une chaîne d’un ou plusieurs caractères. Les caractères suivants sont exclus : nombres, points-virgules, guillemets simples ou doubles.
      • Quelques exemples:
        • aucune unité spécifiée – Indique un certain nombre (int ou float) d’entités (par exemple, utilisateurs, processus, moyennes de charge)
        • s – secondes (aussi min, ms, …)
        • % – pourcentage
        • B – octets (également KB, MB, TB)

Si votre programme répond aux pré-requis ci-dessus, vous pouvez le mettre en place sur les ServiceNav Box.

Si vous disposez de plusieurs ServiceNav Box, il convient de le déployer sur l’ensemble de votre parc de ServiceNav Box.

Déposez votre fichier dans le dossier de la ServiceNav Box :

/usr/local/nagios/libexec/custom_plugin

Il est ensuite nécessaire de lui attribuer les bons droits d’exécution et d’appartenance avec les lignes de commande ci dessous :

chown nagios:nagios /usr/local/nagios/libexec/custom_plugin/<MonPlugin.pl>
chmod 755 /usr/local/nagios/libexec/custom_plugin/<MonPlugin.pl>

Mise en supervision

Se rendre dans l’interface ServiceNav et ajouter un service :

Global-Plugin-Execution

Global-Plugin-ExecutionLe champ Fichier de plugin à exécuter doit contenir le nom de votre fichier (déposé dans le répertoire comme indiqué ci-dessus)

Le champ Arguments du plugin contient tous les arguments du plugin avec les contraintes suivantes :

  • Les arguments sont passés sous la forme -H ‘valeur’ ou –host ‘valeur’   (exemple -c ‘public’ ou bien –url ‘https://myurl.com’ )
  • Pour entourer les valeurs des arguments il convient d’utiliser le signe doubles quotes (« ) ou le signe simples quotes (‘)
  • Si la valeur d’un argument entouré de double quotes contient un double quote il est nécessaire de l’échapper avec  » (antislash double quote)
  • Si la valeur d’un argument entouré de simple quotes contient un simple quote il est nécessaire de l’échapper avec ‘ »‘ »‘ (quote double quote quote double quote quote)

Exemple : -h $HOSTADDRESS$ –URI ‘mylogin.php’ –pwd ‘eyi »kim58’ –text ‘Rue de l' »‘ »‘alma’

Exemple : -h $HOSTADDRESS$ –URI ‘mylogin.php’ –pwd « eyi »kim58 » –text « Rue de l’alma »

Il est possible d’utiliser les variables suivantes :

  • $_SERVICEHOSTALIAS$ retourne le nom de l’équipement de rattachement du service tel qu’indiqué dans ServiceNav
  • $HOSTADDRESS$ retourne l’adresse IP de l’équipement de rattachement du service tel qu’indiqué dans ServiceNav
  • $_SERVICEDISPLAYNAME$ retourne le nom du service tel qu’indiqué dans ServiceNav
  • $_SERVICEIDSERVICE$ retourne l’identifiant unique ServiceNav du service
  • $_HOSTCOMPANYNAME$ retourne le nom de la société de rattachement de l’équipement de rattachement du service
  • $_HOSTHOST_CATEGORY_NAME$ retourne le nom de la catégorie d’équipement ServiceNav de rattachement du service

Il n’est pas possible d’utiliser les variables de compte indiquées au niveau de la société et/ou de l’équipement dans ServiceNav. Si le programme nécessite des informations d’identification, il convient de les indiquer dans le champ Argument du plugin.

Ces informations sont stockées de façon chiffrées en base de données ServiceNav mais restent visibles à toute personne ayant accès à la page de configuration du service unitaire.

Ceci pourrait aussi vous intéresser

ps 1

Utiliser les modèles génériques PowerShell – GLOBAL-PS-Values

Configurer la box pour recevoir les traps

trap1

2 – Créer un fichier de définition Trap

fr_FR

Bienvenue sur ServiceNav !

Vous avez besoin d’aide ? Plus d’informations sur nos produits ? Ecrivez-nous !
Vous avez pris connaissance de notre politique de confidentialité.

[COVID - 19 ] – TÉLÉTRAVAIL, OBJECTIF DISPONIBILITÉ 100% !

Pendant la durée de l'épidémie, assurez la disponibilité et la performance de vos services IT de télétravail, avec ServiceNav !

Suite à l’appel du gouvernement à la mobilisation pour aider les entreprises à surmonter le contexte sanitaire et économique actuel, nous vous aidons gratuitement à assurer la surveillance complète de vos environnements de télétravail : VPN, VDI, Teams, Skype Entreprise, Citrix… Objectifs : collecte, indicateurs de disponibilité et d’utilisation, tableaux de bord pour appuyer votre communication.
Nous utilisons des cookies pour vous garantir la meilleure expérience sur notre site. Si vous continuez à utiliser ce site, nous supposerons que vous en êtes satisfait.

Réservez votre place

Vous avez pris connaissance de notre politique de confidentialité.