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'agent logiciel, 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.

Menu Management → Configuration → Templates → Remote components.

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

Pour créer un composant de réseau, utilisez le menu Configuration → Templates → Remote components, et en bas de la page, dans le menu déroulant, sélectionnez un composant réseau parmi les quatre possibles (Network, Plugin, Wizard, WMI) puis le bouton Create.

Parce qu'il s'agit d'un composant générique certains paramètres tels que snmp community, user, password peuvent être différentes en fonction des agents auxquels le module est ensuite appliqué ; dans ce cas, elles peuvent être laissées vides. Si une politique d'utilisation commune est disponible pour les systèmes, les modules peuvent être entièrement configurés en saisissant les noms d'utilisateur, les mots de passe et d'autres données communes à tous les agents.

Le même processus est effectué pour les composants de type plugin, en sélectionnant dans la liste Plugin l'interface affichera les champs définis dans les macros du plugin sélectionné.

Menu Management → Configuration → Templates → Local components.

Les composants locaux sont des composants qui peuvent être appliqués aux agents logiciels. 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.

Pour appliquer l'un des modèles de module de monitoring existants ou déjà créés, rendez-vous dans la configuration d'un agent via le menu Management → Resources → Manage agents. Dans la liste des agents, un agent est sélectionné via le lien Modules correspondant. Une fois que vous avez accédé à cet écran, cliquez sur l'onglet « Modèles », Module templates, en haut de la page.

Les modules que l'agent possède déjà et les modèles de modules existants sont affichés. Vous sélectionnez un modèle et cliquez sur le bouton Assign. Les modules contenus dans le modèle seront automatiquement ajoutés. Une fois le modèle appliqué, certains modules peuvent être supprimés en cliquant sur l'icône de la poubelle, ou ils peuvent être édités en cliquant sur l'icône de l'outil correspondant. Les modules ajoutés auront une description automatique basée sur le nom du modèle.

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