Modèles et composants

Pandora FMS effectue toutes les vérifications par le biais de modules, ce qui permet de traiter différents types de données en fonction de l'élément à superviser. La liste complète des modules par défaut contenus dans Pandora FMS peut être consultée dans la section Management → Resources → Module types.

Dans Pandora FMS, il existe différents types de modules :

• async : Données asynchrones.
• generic : Données génériques.
• keep_alive : Module spécial « keep online », utilisé pour contrôler l'état du dernier contact avec un agent.
• icmp : Contrôle ICMP (ping).
• snmp : Vérification SNMP.
• tcp : Vérification du TCP.
• web : Vérification sur le web.

Ces types de modules peuvent stocker différents types de données, par exemple :

• data : Données numériques.
• proc : Valeur boolean, 1 est vrai et 0 faux.
• string : Chaîne de texte.
• inc : Incrémental incrémental données par unité de temps.
• inc_abs : Données absolues incrémentales indiquant uniquement la valeur incrémentale depuis la dernière lecture.

Un composant est un Module générique qui peut être appliqué de manière répétée sur un agent, comme s'il s'agissait d'une « copie maîtresse » d'un module, générant un module associé à un agent. Avec cet outil, vous pouvez créer et maintenir une liste des composants les plus utilisés pour les appliquer à de nouveaux agents.

• Composants du réseau : Regroupement de tous les modules de type distant (WMI, TCP, SNMP, ICMP, plugin, etc).
• Composants locaux : Ils comprennent la définition des modules de l'EndPoint, sous forme de « bribes » de texte à incorporer dans le fichier de configuration de l'agent dont la configuration à distance est activée.

Les composants de réseau peuvent être regroupés en templates, de sorte que plusieurs composants de réseau peuvent être appliqués directement à un agent. Plusieurs modules peuvent alors être créés simultanément à travers les composants de réseau associés à un modèle.

Le Recon server applique les composants réseau associés à un modèle sur les hosts détectés, en ajoutant automatiquement les modules spécifiés, ce qui permet un déploiement automatique de la supervision.

Dans cette liste, vous pouvez rechercher les composants existants (en filtrant par groupes ou par texte de recherche libre), voir leur configuration en détail, les modifier ou créer de nouveaux composants. Pour éditer les propriétés d’un module, cliquez sur son nom.

Pour créer un composant réseau, utilisez le menu Management → Configuration → Templates → Remote components, et en bas de la page, dans le menu déroulant, sélectionnez un composant réseau puis cliquez sur le bouton Create.

Les composants réseau partagent des groupes de champs communs, dont certains sont importants :

• Information : Description et instructions selon l'état (avertissement, critique, inconnu).
• Thresholds : Seuils et toutes leurs combinaisons possibles.
• Data : Valeurs de nouvelles tentatives, délai d'attente, valeurs maximales et minimales attendues, enregistrer les valeurs historiques (désactivé par défaut), certaines unités de mesure.
• Categorization : Permet de choisir le groupe de modules auquel appartiendront les futurs modules, choisir une catégorie personnalisée (Management → Resources → Module categories), et attribuer étiquettes de modules.
• Macros : Autant que nécessaire, en spécifiant le nom et la valeur, un par un.

Il permet de réaliser deux vérifications de base de la surveillance distante dans le champ déroulant Module type :

• Remote ICMP network agent, boolean data : Vérification oui ou non, vrai ou faux, pour savoir si un dispositif est en ligne.
• Remote ICMP network agent (latency) : Temps utilisé pour effectuer la requête précédente.

L'étape suivante de la surveillance distante est l'utilisation du TCP pour envoyer essentiellement une série d'instructions (champ TCP send, type de module Remote TCP network agent) à un port spécifique, avec l'adresse IP ou l'URL configurée dans l'agent respectif.

La réponse attendue peut être :

• Valeur vraie ou fausse, utiliser boolean data dans Module type.
• Toute valeur numérique (utiliser numeric data) ou une valeur numérique qui augmente par rapport à la réponse précédente (utiliser incremental data).
• Valeur alphanumérique, chiffres et lettres (utiliser alphanumeric data) et pouvant être comparée avec ce qui est configuré dans le champ TCP receive pour déterminer son état (normal, avertissement, critique).

Dans la surveillance SNMP, il est extrêmement important de connaître l'OID (Object IDentifier) ou les Identifiants d'objets. Pour cela, il existe un explorateur SNMP (bouton SNMP Walk) où vous devrez entrer les identifiants (SNMP version 3), l'adresse IP et le port pour obtenir les OID disponibles selon la communauté SNMP de l'appareil à surveiller.

Une fois l'SNMP OID configuré, en fonction de sa réponse, vous devrez sélectionner le type de module (numérique, incrémental, vrai/faux ou alphanumérique) et définir les seuils pour déterminer son état (normal, avertissement, critique).

Pandora FMS possède des requêtes WMI (WMI query) prédéfinies et classées dans la liste Using network component. Une fois l'option souhaitée sélectionnée, une deuxième liste avec ses options disponibles apparaîtra, et en sélectionnant l'une d'elles, le module futur sera nommé et la WMI query sera assignée. Le type de module changera également en conséquence.

Lors de la création de ce type de composant distant, manuellement ou via l’assistant décrit, il est recommandé de sélectionner dans l'onglet Basic → Group le groupe ou sous-groupe en fonction de la nature du composant. Cela permettra de faire des recherches futures de composants distants.

En fonction de la commande entrée et de sa réponse lors de son exécution, vous devrez sélectionner le type de module approprié (numérique, booléen, alphanumérique, données incrémentales).

En fonction des plugins enregistrés, dans l'onglet Basic → Plugin, vous devez en sélectionner un et le remplir selon les instructions personnalisées de chaque cas.

Il permet deux types, selon le protocole du module : SNMP et WMI.

SNMP :

Tout d'abord, vous devez avoir enregistré le fabricant (Manufacturer ID) et, avec Execution type → Network sélectionné, vous pourrez ajouter la Value OID. Ce sont les champs les plus importants, bien qu'il y en ait d'autres à remplir (type de module, unité à utiliser, seuils, etc.).

Menu Management → Configuration → Templates → Local components.

Les composants locaux sont des composants qui peuvent être appliqués aux EndPoints. Ces composants peuvent être appliqués automatiquement à tous les agents par le biais des politiques ou manuellement (un par un) dans l'éditeur de configuration à distance de l'agent. Pandora FMS dispose de dizaines de modules locaux à appliquer aux politiques et aux agents de manière automatique, classés par catégories.

La liste des modules locaux existants peut être filtrée en fonction de divers paramètres (groupe, système d'exploitation, requête en texte libre) et vous pouvez également visualiser, modifier et créer de nouveaux composants. Pour modifier un module, cliquez sur son nom.

Pour créer un nouveau composant local, allez à la page principale de l'administration des composants locaux, menu Management → Configuration → Templates → Local components et cliquez sur Create en bas à droite de la page.

La page contenant le formulaire de création de la nouvelle composante locale s'affiche. Remplissez le formulaire avec les informations mentionnées ci-dessus et cliquez à nouveau sur le bouton Create pour sauvegarder.

Il est possible de définir des macros dans les composants locaux. Ces macros seront utilisées dans les module_exec et a la structure suivante _field1_ , _field2_ … _fieldN_.

Les macros apparaissent dans le formulaire d'édition des modules comme des champs normaux, transparents pour l'utilisateur.

Si un composant du module possède des macros, les données de configuration seront cachées par défaut pour simplifier l'affichage, mais il est possible de les afficher et de les modifier. Si une chaîne de caractères est définie dans le champ Help, un conseil apparaîtra à côté du champ contenant cette chaîne.

Les modèles de modules sont des modèles qui contiennent des modules de contrôle réseau. Une fois créés, ces modèles peuvent être appliqués directement aux agents, ce qui évite d'ajouter les modules un par une tâche de reconnaissance du réseau.

Menu Management → Configuration → Templates → Module templates.

Dans la liste affichée, cliquez sur le nom de l'un des modèles pour le modifier, et cliquez sur l'icône de la corbeille dans la colonne de droite pour le supprimer.

Avec le bouton Create un nouveau modèle est ajouté. Les champs sont remplis Name y PEN et est sauvegardé en cliquant Create à nouveau. Le bouton Add components où vous pouvez filtrer par groupe, sélectionner les composants nécessaires et cliquez sur OK. Pour finaliser la création, cliquez sur le bouton Update.

Tous les appareils SNMP ont une chaîne d'identification (OID), qui est unique pour chaque marque et modèle d'appareil. Ces chaînes contiennent un numéro en septième position qui détermine le fabricant auquel l'appareil appartient.

Ce numéro est le Private Enterprise Number (PEN) d'un fabricant et il est enregistré dans l'IANA. Ces PEN peuvent être configurés dans le Pandora FMS afin de les utiliser avec les modèles de modules et d'ajouter un suivi de manière dynamique.

Dans le menu Management → Configuration → Templates → Private Enterprise Numbers vous avez accès à la liste des PEN enregistrés. Vous pouvez modifier et/ou supprimer chacun des PEN enregistrés en cliquant sur les icônes correspondantes dans la colonne Options.

Pour enregistrer un nouveau fabricant, vous cliquez sur le bouton Register manufacturer. Il suffira d'insérer le PEN du fabricant correspondant, d'indiquer son nom et une description. Il sera alors ajouté à la liste existante.

Dans les modèles de module, un ou plusieurs PEN seront indiqués de sorte que lorsqu'une tâche de découverte est effectuée, Pandora FMS pourra obtenir le nom du fabricant de l'appareil et y ajouter la supervision appropriée.

Dans les capacités de l'assistant SNMP et de l'assistant WMI, il existe un type de composants distants appelés Composants de wizard .

Ces composants permettent d'établir une configuration de base pour les modules qui seront générés dans les agents lors de l'exécution de l'un des wizard (SNMP ou WMI). Ils offrent également la possibilité de générer plusieurs modules de manière dynamique avec un seul composant. Par exemple, un composant permettant d'explorer les différentes unités de stockage d'un appareil ou les processus en cours d'exécution.

Ces composants peuvent être créés à partir du menu Management → Configuration → Templates → Remote components.

Pour faciliter le tri et la classification des composants, il existe des groupes de composants. Les composants sont associés à des groupes de composants lors de leur création.

Pour visualiser les groupes de composants existants, utilisez le menu Management → Resources → Component groups. L'écran affiche les groupes existants et leur description. Vous pouvez voir les détails des groupes en cliquant sur leur nom, les supprimer en cliquant sur l'icône de la corbeille à droite, dans la colonne Action, et en créer de nouveaux en cliquant sur le bouton ci-dessous Create. Vous pouvez également sélectionner plusieurs d'entre eux à l'aide de leurs cases à cocher respectives et les supprimer en bloc à l'aide du bouton Delete.

Avec le bouton Create un nouveau groupe de composants peut être créé. Remplissez les champs du formulaire, donnez un nom au groupe et indiquez s'il a un parent parmi les groupes existants. Cliquez ensuite à nouveau sur le bouton Create. De nouveaux composants peuvent maintenant être ajoutés au groupe de composants nouvellement créé.

Retour à l'index de la documentation de Pandora FMS