Discovery

Discovery PFMS fournit un ensemble d'outils pour simplifier la surveillance via des assistants.

• Task list: L'outil Pandora FMS Discovery vous permet de voir une liste de toutes les tâches planifiées dans notre environnement tant au niveau de la console qu'au niveau du serveur.
• Host & devices: inclut les outils nécessaires pour découvrir ou importer des appareils et des ordinateurs sur le réseau.
• Console Tasks: inclut les outils nécessaires pour exécuter les tâches planifiées à partir de la console Pandora FMS, telles que: - Sauvegardes de la base de données Pandora FMS. - Exécuter des fonctions PHP. - Exécutez des scripts personnalisés. - Enregistrez des rapports personnalisés. - Envoyez des rapports personnalisés (à partir d'un modèle) par email. - Envoyez des rapports personnalisés par e-mail.
• Applications: Comprend les outils nécessaires pour surveiller différentes applications à partir de plugins chargés sur le système, tels que MySQL®, Oracle® ou VMware®.
• Cloud: inclut les outils nécessaires pour surveiller différents environnements cloud en fonction des plugins chargés sur le système, tels qu'Amazon Web Services® ou Azure Microsoft Compute®.
• Custom: Comprend les outils nécessaires pour surveiller différents environnements ou des applications personnalisées basées sur des plugins chargés sur le système.
• Manage disco packages: L'outil Pandora FMS Discovery vous permet de charger des plugins à partir de packages .disco qui peuvent être utilisés pour surveiller des environnements ou des applications. Voir .Disco development.

L'outil Discovery Pandora FMS vous permet de voir une liste de toutes les tâches planifiées dans l'environnement tant au niveau de la console Web qu'au niveau du serveur. Ces tâches sont réparties en onglet, selon le type de tâche configuré.

• Console tasks.
• Host & devices tasks.
• Application tasks.
• Cloud tasks.
• Custom tasks.

Chaque onglet comporte un bouton pour le filtrage, ainsi qu'un bouton pour recharger les filtres et effacer les paramètres .

Pour chaque tâche de console répertoriée:

• User: Qui a créé la tâche.
• Task: Résumé de la tâche.
• Scheduled: Planification du calendrier.
• Next Execution: Spécifie la prochaine exécution.
• Last Execution: Indique la date de sa dernière exécution.
• Console ID: Para balancear la carga en la ejecución de tareas, podrá declarar y agregar consolas en la sección config.php. Utilice el Console ID para identificar y asignar dichas consolas al crear o editar Console Tasks.
• Group: Le groupe auquel il appartient.
• Operations: Pour équilibrer la charge dans l'exécution des tâches, vous pouvez déclarer et ajouter des consoles dans la section config.php. Utilisez l'ID de console pour identifier et attribuer ces consoles lors de la création ou de la modification de tâches de console.

Pour créer une tâche console, allez dans le menu Management → Discovery → New console task.

Pour modifier une tâche de console, accédez au menu Management → Discovery → Task list et cliquez sur l'icône en forme de crayon correspondant à chaque tâche.

Dans les deux cas, l'interface est la même à l'exception du bouton correspondant pour créer (Create) ou modifier (Update) et enregistrer les modifications.

Les champs communs à chaque tâche sont:

1. Scheduled: Fréquence de la tâche, quotidiennement (Daily), toutes les heures (Hourly), mensuellement (Monthly), une fois (Not scheduled, voir point suivant), hebdomadaire (Weekly) et annuelle (Yearly).
2. Next execution: Prochaine exécution de la tâche, sélectionnez la date dans le premier champ et l'heure dans le deuxième champ (menu contextuel en cliquant sur chacun).
3. Group: Groupe auquel appartiendra la tâche.

Les paramètres à renseigner changent en fonction de la tâche vous choisissez dans la liste déroulante Task:

• Backup Pandora FMS database Tâche de sauvegarde de la base de données Pandora FMS:

Save to disk in path: chemin dans lequel les informations de sauvegarde seront stockées.

Active backups: nombre spécifique de sauvegardes à maintenir pour conserver l'espace de stockage.

• Call PHP function Tâche d'exécution de fonction écrite en langage PHP:

Function name: Nom de la fonction PHP à exécuter une fois ou périodiquement.

• Execute custom script Tâche d'exécution de script:

Custom script: Nom du script à exécuter.

• Save custom report to disk Tâche de génération et de sauvegarde de rapports personnalisés:.

Report pending to be created: Rapport personnalisé (liste déroulante) à partir duquel ce rapport sera généré. Voir «Création d'un rapport (personnalisé)».

Save to disk in path: Chemin où le rapport créé sera stocké (l'utilisateur apache doit avoir les droits de lecture et d'écriture sur ce répertoire)

File name prefix: Préfixe du nom des rapports successifs.

Report Type: À enregistrer au format XML, PDF, JSON ou CSV.

• Send CSV log Tâche d'envoi des journaux d'événements (logs) au format CSV, par e-mail.

Send to e-mail: Boîte aux lettres à laquelle envoyer les enregistrements d'événements (logs) au format CSV.

• Send custom report (from template) by email Rapports (créés à partir d'un modèle) à envoyer par email:

1. Modèle personnalisé pour la création du rapport, Template pending to be created informations sur l'agent pour le rapport, Agents; Si vous souhaitez générer des rapports distincts pour chaque rapport, Report per agent.
2. Adresses e-mail (séparées par des virgules) pour envoyer le rapport, Send to email addresses.
3. Objet de l'email à envoyer, Subject.
4. Corps du message avec lequel les rapports seront envoyés, Message.

Type de rapport qui sera envoyé, Report Type.

• Send custom report by email Rapports à envoyer par email:

1. Rapport personnalisé (voir « Création d'un rapport ») pour la création de rapport, Report pending to be created.
2. Informations sur l'agent pour le rapport, Agents; Si vous souhaitez générer des rapports distincts pour chaque rapport, Report per agent.
3. Adresses e-mail (séparées par des virgules) pour envoyer le rapport, Send to email addresses.
4. Objet de l'email à envoyer, Subject.
5. Corps du message avec lequel les rapports seront envoyés, Message.
6. Type de rapport qui sera envoyé, Report Type.

Pour chaque tâche répertoriée:

• Force: forcer l'exécution.
• Task name: Nom.
• Server name: Serveur qui l'exécutera.
• Interval: Intervalle de temps dans lequel il sera effectué.
• Network: Réseau où seront effectués les contrôles.
• Status: Statut de la tâche planifiée.
• Task type: Type
• Progress: progression, si elle est en cours d'exécution.
• Updated at: Dernière mise à jour.
• Operations: Les icônes vous permettent d'effectuer des actions telles que modifier ou supprimer la tâche, entre autres. À partir de la version NG 752, une icône est disponible qui permet d'activer ou de désactiver chaque tâche dans la vue des tâches.

Pour chaque tâche répertoriée:

• Forcer: forcer l'exécution.
• Nom de la tâche: Nom.
• Nom du serveur: Serveur qui l'exécutera.
• Intervalle: Intervalle de temps dans lequel il sera effectué.
• Statut: Statut de la tâche planifiée.
• Type de tâche: Tapez.
• Progression: progression, si elle est en cours d'exécution.
• Mis à jour à: Dernière mise à jour.
• Opérations: Les icônes vous permettent d'effectuer des actions telles que modifier ou supprimer la tâche, entre autres.

Le NetScan vous permet de découvrir des appareils sur un ou plusieurs réseaux, d'obtenir leur topologie et de les superviser automatiquement.

Cette découverte peut être configurée de deux manières:

1. Mode simple: Le serveur Pandora FMS essaiera automatiquement de découvrir autant de réseaux qu'il en est capable.
2. Mode avancé: L'utilisateur doit remplir le formulaire avec les détails des réseaux à découvrir par la tâche. Cette deuxième option permet à l'utilisateur de définir spécifiquement la manière dont la découverte sera effectuée.

Les options suivantes sont configurables en mode simple et en mode avancé:

1. Review results: L'utilisateur doit valider les résultats en sélectionnant les agents qui seront créés à partir de ceux trouvés par la tâche de découverte. L'utilisateur peut également décider, au moment de l'examen des résultats, de créer ou non une carte du réseau de la tâche.
2. Create network map: La tâche créera automatiquement une carte de réseau avec les hosts découverts. Cette option permet également à la tâche d'ajouter de nouveaux hosts à toutes les cartes de réseau dont la source de données est cette tâche de découverte.
3. Apply autoconfiguration rules: Il applique les règles de configuration automatique définies précédemment aux agents détectés.

Les options suivantes ne sont disponibles que dans la configuration du mode avancé:

1. Networks: Liste des adresses réseau à analyser. Seuls les réseaux ayant un format CIDR valide, par exemple 192.168.10.0/24, doivent être analysés. La liste des réseaux peut être chargée à partir d'un fichier CSV, où chaque ligne du fichier doit être un réseau valide.
2. Blacklist of IPs and networks: Liste des adresses IP ou des réseaux à exclure de l'analyse. Les adresses avec ou sans masque de réseau au format CIDR, par exemple 192.168.10.150 ou 192.168.20.0/24, sont valables. La liste peut être chargée à partir d'un fichier CSV, où chaque ligne du fichier doit être une adresse IP ou un réseau valide.
3. Scan SNMP network interfaces: Il active l'analyse des interfaces SNMP des appareils découverts. Cela permet à l'analyse d'ajouter des modules de supervision pour les interfaces réseau et d'effectuer une analyse topologique de niveau 3 pour les cartes réseau. En mode simple, cette option est activée.
4. Scan SNMP known hardware: Il active le balayage du matériel connu par SNMP pour les appareils découverts. Cela permet à l'analyse d'ajouter des modules SNMP basés sur les fabricants des appareils (enregistrés dans Pandora FMS) en utilisant les composants de l'assistant SNMP de la bibliothèque de la console. En mode simple, cette option est activée.
5. Scan WMI devices: Il permet l'analyse des machines MS Windows® par WMI à distance. Cela permet d'ajouter des modules WMI à l'aide des composants de l'assistant WMI de la bibliothèque de la console. En mode simple, cette option est désactivée.
6. Resolve hosts names: Il active la découverte du nom de l'ordinateur lors de l'analyse du réseau. En mode simple, cette option est activée.
7. Guess hosts OS : Il active la découverte du système d'exploitation pour les appareils trouvés dans l'analyse du réseau. Cette option peut prendre beaucoup de temps, en fonction du nombre d'appareils trouvés. En mode simple, cette option est désactivée.
8. Scan additional information: Il permet la découverte d'informations supplémentaires pour les appareils trouvés lors de l'analyse du réseau. Ces informations seront visibles dans la description des agents créés par la tâche. Cette option peut prendre beaucoup de temps, en fonction du nombre de périphériques trouvés. En mode simple, cette option est désactivée.
9. SNMP credentials to try: Set d'informations d'identification SNMP provenant du magasin d'informations d'identification à tester pour les appareils dont le protocole SNMP est activé. Le set d'informations d'identification de la communauté version 1 et public est toujours testé, même s'il n'est pas trouvé dans le magasin d'informations d'identification configuré.
10. WMI credentials to try: Set d'informations d'identification WMI provenant du magasin d'informations d'identification à tester pour les appareils dont l'interface WMI est activée. Ces informations d'identification ne doivent être utilisées que si l'analyse des périphériques WMI est activée.

Une fois l'assistant terminé, Discovery PFMS commencera à fonctionner à chaque intervalle défini.

Une fois la tâche terminée, si vous accédez à Review, vous verrez un résumé des dispositifs trouvés et des autres métriques disponibles via SNMP ou WMI. Toutes les adresses IP seront affichées, chacune dans l'un de ces deux états:

1. Désactivé: Un agent ou un module en cours de supervision existe déjà dans l'environnement et ne sera ni créé ni modifié.
2. Activé: Il s'agit d'un nouvel élément qui n'est pas surveillé ou qui, dans le cadre des mesures obtenues, a répondu par un nouveau module, qui sera affiché dans un menu déroulant. Dans les dispositifs qui sont dans cet état, vous pouvez choisir de l'ajouter à la liste des agents supervisés ou si vous choisissez de l'ajouter à l'une des nouvelles métriques activées.

Pendant la découverte, il sera possible de voir la progression de la tâche à chacune des différentes étapes, ainsi qu'une carte réseau temporaire de la topologie qui a été découverte.

Les étapes pour déployer les EndPoints à partir de la Console sont les suivantes:

• Enregistrez les versions des EndPoints à déployer dans le référentiel des agents: Vous aurez besoin des installateurs des agents à déployer. Vous pouvez également utiliser des agents personnalisés.
• Enregistrez les informations d'identification qui seront utilisées pour se connecter aux cibles dans le gestionnaire d'informations d'identification: Vous devrez spécifier les informations d'identification avec lesquelles l'accès aux cibles trouvées ou spécifiées sera testé.
• Scanner, ajouter ou charger des cibles.
• Déployer des EndPoints avec un élément de Task list.

  Ce système n'effectue pas d'opérations de type PUSH; tous les déploiements sont diffusés en offrant le logiciel et en demandant à la cible de l'installer.

Permet l'exécution de scripts personnalisés pour exécuter des tâches de reconnaissance du réseau.

Spécifier:

• Nom de la tâche: Nom de la tâche de reconnaissance.
• Commentaire: Permet d'ajouter des commentaires.
• Serveur de découverte: Serveur qui exécutera la tâche.
• Groupe: Groupe auquel il appartient.
• Intervalle: intervalle d'exécution.

Une fois le processus de création de tâche terminé, il faudra préciser le script que vous souhaitez exécuter, ainsi que le fichier de configuration nécessaire à son exécution.

Cette section présente les différents scripts créés pour les tâches de reconnaissance personnalisées. Une vue s'affiche dans laquelle le nom et la description de la tâche sont définis.

Pandora FMS vous permet d'ajouter des scripts supplémentaires pour faciliter la surveillance et la reconnaissance des réseaux requis.

Paramètres à définir:

• Nom: Nom du script.
• Chemin complet du script: Chemin où se trouve le script.
• Description: Description du script. Des descriptions des différents champs peuvent être définies, ainsi que des valeurs par défaut pour ceux-ci.
• Masquer la valeur: Si vous souhaitez masquer la valeur d'un champ.
• Aide: champs d'aide.

La création de scripts permet d'ajouter des macros avec lesquelles définir tous les paramètres nécessaires à la bonne exécution du script.

Si vous souhaitez enregistrer des cibles en masse, téléchargez un fichier CSV au format suivant:

Agent alias, IP address, OS id, Interval, Group id, Description

• Agent alias: Alias du futur agent, si vous sélectionnez l'option Alias as name le nom sera le même que à l'alias.
• IP address: Adresse IP de l'ordinateur sur lequel l'agent sera installé.
• OS id: Le numéro d'identification du système d'exploitation, AIX, BSD, HP-UX, GNU/Linux, Solaris, MS Windows® sont pris en charge.
• Interval: Temps en secondes entre chaque vérification.
• Group id: Numéro d'identification du groupe auquel l'agent appartiendra.

Le système créera les objectifs sur la base de ce qui est défini dans le CSV.

Avec Pandora FMS, il est possible de superviser les applications et les environnements cloud à distance à l'aide de Discovery PFMS.

Pour cela il nécessitera le chargement des plugins que vous souhaitez utiliser pour la supervision, qui peuvent être des plugins Pandora FMS personnalisés ou officiels.

Ces plugins sont chargés dans des packages ''.disco'' qui comprendront leur propre interface de configuration et les exécutables nécessaires à leur bon fonctionnement.

Lors de la création ou de l'édition d'une tâche pour des Applications, Cloud ou Custom, le formulaire que nous devons remplir sera ajusté en fonction du plugin utilisé dans la tâche. Cela signifie que, par exemple, le formulaire des tâches VMware® sera différent de celui des tâches XenServer®.

Cependant, pour toutes les tâches, les informations minimales nécessaires doivent être indiquées:

• Task name: Nom de la tâche (obligatoire).
• Group: Groupe assigné à la tâche (obligatoire).

Une fois ces informations minimales renseignées, les étapes suivantes du formulaire seront ajustées en fonction du plugin utilisé, et pourront comporter des tâches avec plus d'étapes de configuration que d'autres:

Lors de la définition de la tâche, nous pouvons passer d'une étape à la suivante en utilisant le bouton Next, qui mettra à jour les paramètres de chaque étape de la tâche.

Nous pouvons également terminer la définition de la tâche à l'aide du bouton Complete setup, qui mettra à jour les paramètres de l'étape dans laquelle nous nous trouvons et marquera la tâche comme complètement configurée afin que le serveur puisse l'exécuter.

Lorsqu'une tâche n'est pas entièrement configurée, elle sera affichée dans la liste des tâches avec une icône l'indiquant:

Toutes les tâches sont associées à un statut:

• Done: Le serveur a terminé la tâche sans rencontrer d'erreurs pendant son exécution.
• Failed: Le serveur a rencontré au moins une erreur pendant l'exécution de la tâche.
• Not started: Le serveur n'a pas encore commencé la tâche.

Pour toute tâche, il est possible de consulter son résumé d'exécution (échec ou réussite) qui, selon la définition du plugin utilisé pour la tâche, s'affichera avec différentes informations:

Grâce au menu Management → Marketplace → Start, vous pouvez accéder directement à la bibliothèque officielle de Pandora FMS pour obtenir à la fois paquets .disco et plugins. Selon le type d'élément, il peut être installé directement (tant que le serveur PFMS a accès à internet), ou un utilisateur peut télécharger les paquets sur son ordinateur puis les télécharger et les installer un par un. Si l'installation en ligne a été utilisée, le menu Marketplace → Downloads affichera une liste des paquets installés avec leur lien web d'origine et la possibilité de réinstaller chaque élément. Si vous décidez de supprimer un téléchargement, cela ne désinstallera pas le paquet respectif ni n'affectera la fonctionnalité Manage Disco packages.

Cette section vous permet de charger des plugins à partir de packages .disco qui peuvent être utilisés pour surveiller des environnements ou des applications.

Depuis la console, vous pouvez voir la liste des plugins disponibles pour Discovery PFMS et vous pouvez en charger de nouveaux (Load DISCO), qu'ils soient Pandora FMS officiels ou personnalisés.

Pour chaque plugin répertorié:

• Name: Nom du plugin accompagné d'une icône permettant de le distinguer. Ce nom et cette icône sont ce que le plugin affichera lors de la création de nouvelles tâches.
• Short name: Nom de l'identifiant du plugin. Ce nom est un identifiant unique qui permet de distinguer le plugin des autres, il ne peut donc pas y avoir plus d'un plugin avec le même nom court chargé dans le système. Les noms courts commençant par pandorafms. sont utilisés par Pandora FMS pour distinguer les plugins officiels, donc les noms courts commençant ainsi ne doivent jamais être utilisés pour les plugins personnalisés. De plus, ces noms courts sont utilisés pour nommer le répertoire qui contiendra tous les fichiers nécessaires à la fois à la console et au serveur Pandora FMS.
• Section: Section de l'interface Découverte dans laquelle sera affiché le plugin pour créer et lister des tâches. Il peut s'agir de app, cloud ou custom afin que les tâches du plug-in se trouvent respectivement dans Applications, Cloud ou Custom.
• Version: Version du plugin chargée.
• Actions: Vous pouvez supprimer un plugin de la liste (ainsi que toutes les tâches qui l'utilisent) ou synchroniser manuellement les fichiers du plugin trouvés dans la console avec les serveurs Pandora FMS de l'environnement.

Pour que les tâches d'un plugin fonctionnent, il est nécessaire que la console et le serveur Pandora FMS aient le contenu du package .disco dans un répertoire accessible.

C'est pourquoi le bouton d'action pour synchroniser les fichiers avec le serveur est inclus dans chaque plugin dans la liste des plugins.

Puisque la console se charge de télécharger les nouveaux fichiers .disco, c'est la même console qui se charge de synchroniser les fichiers nécessaires avec le serveur.

Lorsqu'un fichier .disco est chargé, la console synchronise automatiquement les fichiers avec le serveur. Cependant, si nécessaire, le bouton de synchronisation des fichiers du plugin forcera la synchronisation à être effectuée au moment où il sera enfoncé.

En guise de point d'entrée, la console stocke les fichiers de chaque plugin dans un répertoire contenant le nom court du plugin:

pandora_console/attachment/discovery

Par exemple, le répertoire de l'application pandorafms.vmware serait:

/var/www/html/pandora_console/attachment/discovery/pandorafms.vmware

Si les fichiers minimum nécessaires ne sont pas trouvés pour un plugin dans son répertoire, l'icône suivante s'affichera, empêchant la synchronisation des fichiers avec le serveur, et il sera nécessaire de télécharger à nouveau son package .disco pour résoudre le problème.

Afin d'exécuter les tâches définies pour un plugin, le serveur Pandora FMS doit disposer des fichiers du plugin.

Pour y parvenir, la console synchronise les fichiers de chaque plugin chargé avec un répertoire accessible à la fois à la console et au serveur.

Ce répertoire, appelé discovery, se trouve au sein de celui configuré dans la configuration générale de la console Pandora FMS, dans le champ Remote configuration directory.

Par défaut, le chemin dans lequel la console synchroniserait les fichiers avec le serveur serait:

/var/spool/pandora/data_in/discovery

Dans ce répertoire, un sera créé pour chaque plugin, en utilisant leurs noms courts, et à l'intérieur vous trouverez les fichiers de plugin dont le serveur pourrait avoir besoin.

Par exemple, le répertoire de l'application pandorafms.vmware serait:

/var/spool/pandora/data_in/discovery/pandorafms.vmware

Voir «.Disco development».

Revenir à l'index de la documentation Pandora FMS