Configuration de la Console

Menu Management → Settings → System Settings.






Dans cette section, vous pouvez modifier et ajuster les paramètres de fonctionnement de la Console web de Pandora FMS, ce qui affectera son fonctionnement général.

Paramètres système

Configuration générale

La section principale et la plus dense est répartie en sept sections :

  1. Basic: Langues, date et heure, etc.
  2. Security: Les points liés au renforcement de la Console web et de l'API.
  3. Behavior: Comportements de la console de rapports, des agents et des modules, des événements, et enfin, des éléments divers tels que les opérations massives, les collections et NCM.
  4. Features: Activer ou désactiver des fonctionnalités importantes de PFMS.
  5. Network: De la plus haute importance pour accéder à la Console web.
  6. Directories: Les chemins absolus les plus importants et essentiels des fonctionnalités PFMS (pièces jointes, RMM, etc.).
  7. Alerts configuration: Le courrier électronique reste un outil valable pour garder les gens connectés, ici sont incluses les instructions pour que PFMS fonctionne comme client de messagerie uniquement pour l'envoi de messages.

Paramètres de base

Menu Management → Settings → System settings → General Setup →
Basic
.







  • Language code: Par défaut, l'anglais (English (UK)) est utilisé et définit la langue pour les utilisateurs ayant la langue par défaut définie. Chaque utilisateur pourra choisir sa propre langue et cette valeur générale sera ignorée pour cet utilisateur.
  • Time source: Liste permettant de choisir l'origine de la date et de l'heure à utiliser. Cela peut être le système local (System par défaut) ou la base de données (Database). La première est généralement utilisée lorsque la base de données est sur un système différent avec un fuseau horaire différent de celui de la Console web.
  • Server timezone setup: Définit le fuseau horaire dans lequel se trouve la Console web. Contrairement aux codes et abréviations des pays (norme ISO 3166), la liste des fuseaux horaires suit des règles complexes (IANA Time Zone Database) et c'est pourquoi une première liste est incluse avec les continents et leurs pays, et en sélectionnant une option dans cette liste, la deuxième liste sera mise à jour où vous pourrez choisir un pays, une ville ou une région avec précision. À partir de la version 785, le bouton Change timezone n'a plus d'effet, il suffit d'utiliser les deux listes décrites et d'enregistrer les modifications effectuées.
  • Enable update manager: Active ou désactive l'option du Warp Update Manager.
  • Automatically check for updates: Active ou désactive la vérification automatique des mises à jour dans le Warp Update. Cela fait en sorte que la Console web contacte le fournisseur de mises à jour de Pandora FMS chaque fois que vous vous connectez, en envoyant des informations anonymes sur l'utilisation de Pandora FMS (nombre d'agents).
  • Enable console log: En raison de la grande quantité de données de débogage générées, il est recommandé de désactiver ce log, comme cela est configuré par défaut. Si activé, le fichier suivant est utilisé pour l'enregistrement des événements de la Console :
/var/log/php-fpm/error.log

Si vous utilisez EL8 (Enterprise Linux 8), en plus d'activer Enable console log, il faut modifier le fichier :

/etc/php-fpm.d/www.conf

Et commenter avec un point-virgule le paramètre suivant :

;php_admin_value[error_log] = /var/log/php-fpm/www-error.log

Ainsi, les données seront enregistrées dans …/pandora_console/log/console.log.


  • Tutorial mode: Par défaut en mode d'assistance complète, il permet d'afficher des messages et des accès d'aide dans les différentes sections et/ou fonctionnalités de la Console web.
  • Enable Feedback: Activé par défaut, il permet un accès direct dans l'en-tête de la Console web pour notifier une erreur à l'équipe de Pandora FMS, y compris les données d'installation dans un fichier PDF.
  • SSH server port for reverse SSH tunnels: Utilisé pour les tunnels SSH inversés, il s'agit du numéro de port sur lequel le serveur SSH écoute sur le PFMS Server.

Sécurité

Menu Management → Settings → System settings → General Setup →
Sécurité
.







  • Enable audit log: En l'activant, le fichier …/pandora_console/log/audit.log est également utilisé pour enregistrer l'audit.
  • Use SSL certificate: Permet d'indiquer un certificat numérique pour chiffrer la communication entre la Console web et les utilisateurs. Chaque serveur PFMS doit utiliser un certificat unique, le chemin indiqué par défaut montre le répertoire où il doit être stocké et le nom du fichier est simplement une suggestion.
  • Enforce https: Force la redirection vers HTTPS. Si activé, vous devrez absolument activer l'utilisation de Pandora FMS avec HTTPS sur le serveur WEB.

Si ce champ est activé et qu'Apache n'a pas été configuré pour utiliser HTTPS, vous ne pourrez pas accéder à la Console web et devrez désactiver cette option en accédant directement à la base de données via MySQL et en insérant la commande suivante :

UPDATE tconfig  SET `value` = 0 WHERE `token` = 'https';

Avant de recharger la page, vous devrez de nouveau modifier http://… dans la barre d'adresses du navigateur web.

  • Referer security: Lorsqu'il est activé, pour des raisons de sécurité, il vérifie que l'utilisateur provient d'une URL de Pandora FMS et que le lien n'est pas externe et donc ne pose pas de problème de sécurité. Par défaut, ce paramètre est désactivé. Les sites vérifiés par sécurité sont :
  1. Extension du gestionnaire de base de données.
  2. Configuration de l'utilisateur.
  3. Configuration des scripts du Serveur de Reconnaissance.
  • API password: Méthode d'authentification pour accéder à la API 1.0 de Pandora FMS.
  • IP list with API access: Liste des adresses IP qui auront accès au service web API de Pandora FMS (par défaut 127.0.0.1, accès uniquement local). L'astérisque peut être utilisé comme caractère générique, par exemple, en mettant * on donne accès à toutes les adresses IP, ou par exemple 125.56.24.* pour donner accès à tout le sous-réseau 125.56.24.

Comportement

Menu Management → Settings → System settings → General Setup →
Behavior
.







Dans cette section, vous contrôlez les comportements console de rapports et connectivité, détails des agents et modules (y compris API et traps SNMP), les événements PFMS, et divers comme les opérations massives, les collections et NCM.

Console

Menu Management → Settings → System settings → General Setup →
Behavior → Console
.







  • Enable console dedicated to report generation: La Console dédiée pour la génération de rapports a pour mission critique, à partir des données extraites des bases de données PFMS (principale et historique), de préparer, convertir en informations utiles, générer, enregistrer et envoyer des rapports pour des centaines d'agents et EndPoints. Pour ce faire, elle est préconfigurée avec des aspects spéciaux tant pour le logiciel que pour le matériel :
  1. La mémoire (RAM, virtuelle ou réelle) pour PHP doit pouvoir utiliser, si nécessaire, la quantité maximale disponible sur la machine. Sinon, un avertissement sera donné sur cette insuffisance. Consultez la documentation d'installation pour plus de détails sur la configuration.
  2. Seuls les utilisateurs administrateurs peuvent se connecter à la Console dédiée pour les rapports.
  3. Les options du menu sont limitées aux fonctions essentielles, en particulier pour la mise à jour du logiciel PFMS. Tout le reste doit être configuré via une autre Console web connectée aux mêmes bases de données. Consultez la section pour la configuration de l'envoi de courriels.
  4. Pour utiliser la Console dédiée pour les rapports, il faut ajouter dans le fichier config.php le paramètre suivant :
$config["reporting_console_node"] = true;
  • Check connection interval: Intervalle de temps (en secondes) pour vérifier la connexion au serveur de base de données. Par défaut 180, valeur minimale 60.

Agents & modules

Menu Management → Settings → System settings → General Setup →
Behavior → Agent & modules
.







  • Set alias as name by default in agent creation: En activant ce paramètre pour la création d'agents via la Console web, l'option par défaut Use alias as name sera activée, ce qui permet de faire en sorte que le nom et l'alias du nouvel agent soient identiques. Désactivé par défaut.
  • Unique IP: En activant ce paramètre, le bouton Unique IP sera activé automatiquement lors de la création et de l'édition des agents, afin de détecter si les adresses IP attribuées à un agent sont disponibles ou si elles sont déjà utilisées par le même agent ou un autre agent. Désactivé par défaut.
  • Forward SNMP traps to an agent (if it exists): Configuration permettant d'associer des traps SNMP et des agents. Lorsque cette option est activée, lorsqu'un trap avec la même adresse IP qu'un agent est reçu, un module sera créé dans cet agent avec le nom SNMPTrap et le type async_string. La valeur du module sera celle du dernier OID reçu, c'est-à-dire qu'il sera mis à jour avec l'arrivée de nouveaux traps. Si l'option Yes, and change status est sélectionnée, le module passera en état CRITICAL après la mise à jour avec le trap. Pour qu'il revienne à l'état NORMAL, il faut valider ou supprimer tous les traps associés à cet agent depuis la console SNMP. Si l'option Yes, but do not change status est sélectionnée, seule la valeur du module sera mise à jour. Par défaut, les traps SNMP ne sont pas redirigés (bouton No, do not forward).
  • Include manually disabled agents: Permet d'activer ou de désactiver l'affichage des agents manuellement désactivés dans certaines vues de la Console web.
  • Enable module custom ID read-only: En activant ce paramètre, l'édition de l'ID personnalisé du module d'un agent depuis la Console sera bloquée, mais l'édition sera toujours possible via la CLI et l'API. Cela est utile pour des intégrations automatisées de tiers, afin que l'utilisateur ne puisse pas modifier cette valeur.
  • Command line snapshot: Les modules de chaîne qui renvoient plusieurs lignes afficheront leur contenu sous forme de texte formaté comme une console de commandes.
  • Change remote config encoding: En activant ce paramètre, l'encodage des caractères (encoding) pour l'écriture des modules dans les fichiers de configuration distante sera changé de UTF-8 par défaut à l'encodage configuré dans les fichiers de configuration.
  • Number of modules in queue: Définit le nombre maximum de modules dans la file d'attente (500 par défaut), et si ce nombre est dépassé, un icône d'avertissement sera affiché pour chaque élément dans la gestion des serveurs.
  • API interval for module (seconds): Valeur par défaut 300 secondes, minimum 60.

Événements

Menu Management → Settings → System settings → General Setup →
Behavior → Events
.







  • Event storm protection: Si cette option est activée, les données continueront à être reçues sans générer d'événements ou d'alertes.
  • Keep in process status for new events with extra ID: Si activée et si un événement “En processus” (In process) avec un identifiant supplémentaire spécifique (ID Extra) existe et qu'un nouvel événement avec ce même ID Extra est reçu, il sera créé comme In process à la place. Les nouveaux événements héritent aussi de ID Extra de l'événement.

Max. hours old events comments: Lorsque les événements sont affichés sous forme groupée, les commentaires des événements identiques regroupés seront limités à la dernière quantité d'heures spécifiée ici.

  • Inventory change blacklist: Les modules d'inventaire inclus dans la liste noire ne généreront pas d'événements lorsqu'ils changeront. Par défaut, pour Linux® et MS Windows®, les suivants sont inclus : CPU, Process, Security.

Autres

Menu Management → Settings → System settings → General Setup →
Behavior → Other
.







  • Allow create scheduled downtimes in the past: Active ou désactive la possibilité de créer des arrêts planifiés dans le passé. Cela permet de modifier les informations pour les rapports SLA.
  • Limit for bulk operations: Limite du nombre d'éléments pouvant être modifiés par des opérations massives en une seule fois, par défaut 500 (minimum 100), afin d'éviter des problèmes de mémoire.
  • Log size limit in system logs viewer extension: Définit la taille maximale, en kilooctets, des fichiers de logs.
  • Collection size (Bytes): Taille maximale en octets pour les Collections.
  • IPAM critical threshold for occupied addresses: Seuil critique pour la carte du super-réseau de l'extension IPAM, indiquant une plage critique d'adresses occupées.
  • IPAM warning threshold for occupied addresses: Seuil d'avertissement pour la carte du super-réseau de l'extension IPAM dans la plage d'adresses occupées.
  • NCM configuration FTP server IP: Adresse IP du serveur FTP dans les modèles de dispositifs réseau. Cette valeur sera utilisée par la macro TFTP_SERVER_IP dans les scripts NCM.

Fonctionnalités

Menu Management → Settings → System settings → General Setup →
Features
.







Lors de l'installation de PFMS, ces fonctionnalités sont désactivées par défaut (sauf l'exploration des vulnérabilités) :

  • Show experimental features: L'équipe de Pandora FMS travaille sur le développement continu et peut ajouter ici de nouvelles améliorations que les utilisateurs peuvent explorer initialement.
  • Use Advanced ACL System: Cela activera le Système ACL Avancé qui est plus flexible que le système ACL standard.
  • Enable GIS features: Activer ou désactiver les fonctionnalités GIS pour la Console web de Pandora FMS.
  • Enable NetFlow: Activer ou désactiver la surveillance de NetFlow®.
  • Enable IOT Server: L'intégration Pandora IOT a pour objectif de superviser les messages reçus d'un serveur broker MQTT.
  • Enable agent vulnerability scanning: Les EndPoints de Pandora FMS et le moteur de découverte à distance chercheront des informations sur les logiciels installés sur le système pour trouver des vulnérabilités possibles. Cela ne s'applique qu'aux agents ayant la configuration de scan de vulnérabilités avec l'option Use global settings sélectionnée.

Réseau

Menu Management → Settings → System settings → General Setup →
Network
.







  • Public URL: Vous pouvez enregistrer une URL publique. Il est utile de remplir ce champ lorsque vous avez un proxy inverse ou, par exemple, avec le mode mod_proxy du serveur web Apache.

Les deux token suivants ne seront pris en compte que si une URL a été définie dans le champ précédent.

  • Force use Public URL: Utiliser uniquement et exclusivement l'Public URL pour naviguer vers la Console web (tous les liens et références seront construits en fonction de l'URL publique).

Si ce champ est activé et que l'URL publique n'est pas configurée, vous ne pourrez pas accéder à la Console web et vous devrez désactiver cette option en accédant directement à la base de données via MySQL et en insérant l'instruction suivante :

UPDATE tconfig  SET `value` = 0 WHERE `token` = 'force_public_url';


  • Public URL host exclusions: Les adresses IP ajoutées ici utiliseront leur propre adresse IP pour construire leurs liens et références, même si le token Force use Public URL est activé. Elles peuvent être séparées par des virgules et/ou sur des lignes distinctes. Pour ajouter des commentaires sur une ligne, elle doit commencer par le symbole #.

Répertoires

Menu Management → Settings → System settings → General Setup →
Directories
.







  • Attachment directory: Répertoire de fichiers de la Console web Pandora FMS. Utilisé pour héberger les collections, les pièces jointes d'incidents et d'autres séries de fichiers. Il doit avoir des permissions d'écriture pour le serveur web et est situé par défaut dans :
    /var/www/html/pandora_console/attachment

    Si le chemin par défaut est modifié pour un autre emplacement personnalisé, vous devrez contacter l'administrateur (root) du système d'exploitation où le PFMS Server est exécuté car aucun répertoire ni fichier hébergé ne sera déplacé automatiquement. Il est recommandé, après avoir sauvegardé les données et téléchargé les éléments stockés (collections, pièces jointes d'incidents et référentiel de fichiers), de supprimer ces contenus via la Console web, de modifier le chemin, d'enregistrer les modifications et de tout télécharger à nouveau vers le nouvel emplacement.


  • Remote configuration directory: Champ où le répertoire qui conserve la configuration distante de la fonctionnalité RMM est identifié, par défaut situé à :
/var/spool/pandora/data_in
  • RMM remote config directory: Champ où le répertoire qui garde la configuration distante des agents est identifié, par défaut situé à :
/var/spool/pandora/rmm_server
  • General network path: Répertoire où seront également stockés les répertoires netflow et sflow pour les données correspondantes. Valeur par défaut :
/var/spool/pandora/data_in/
  • Chromium path: Chromium est un composant spécial utilisé pour générer dynamiquement des graphiques au format PDF. Vous devez entrer le chemin ou PATH où ce composant est installé, par défaut :
/usr/bin/chromium-browser
  • Server log directory: Répertoire où sont stockés les fichiers de logs du serveur.

Configuration des alertes

Menu Management → Settings → System settings → General Setup →
Alerts configuration
.







Cette section vous permet de configurer l'envoi d'alertes par e-mail et par messagerie instantanée Telegram® :

Les valeurs par défaut lors de l'installation de Pandora FMS sont purement illustratives et doivent être modifiées en fonction du fournisseur de services de messagerie utilisé. Pandora FMS utilise Postfix pour le routage et l'envoi des e-mails, car il est inclus dans de nombreuses distributions GNU/Linux®, ainsi que macOS® et BSD®.

Pandora FMS supporte l'utilisation de OAuth 2.0.

Dans les champs From address et From name, vous devez configurer respectivement l'adresse de l'expéditeur et le nom de l'expéditeur qui seront affichés au destinataire.

De nos jours, afin d'éviter les attaques de spam, les serveurs de messagerie exigent généralement un utilisateur (qui peut être différent de From address) et son mot de passe respectif, qui doivent être spécifiés dans les champs utilisateur E-mail user et mot de passe E-mail password.

Il est recommandé de chiffrer le trafic lors de l'envoi de messages électroniques pour éviter les attaques de type man-in-the-middle (MITM). Pour ce faire, utilisez le champ Encryption avec le protocole utilisé par le serveur de messagerie. Résumé des méthodes de chiffrement disponibles dans PFMS :

  • STARTTLS (Start Transport Layer Security): (option recommandée) Ce protocole commence par une connexion SMTP sans chiffrement sur le port standard, puis demande une mise à jour vers une connexion sécurisée utilisant TLS. Le port 587 est le plus couramment utilisé par la plupart des fournisseurs de messagerie. Le port 25 est le port SMTP standard, souvent bloqué par de nombreux fournisseurs d'accès pour éviter le spam (spam) et utilisé uniquement pour le trafic privé entre serveurs.
  • SMTPS (SMTP Secure): La connexion commence directement en utilisant SSL/TLS. Aucune connexion non chiffrée n'est autorisée. Le port 465 est utilisé pour les connexions SMTP sécurisées utilisant SSL/TLS dès le départ. Bien qu'il ait été déprécié à un moment donné, il est toujours supporté par de nombreux fournisseurs de messagerie et reste une option valide pour les connexions chiffrées.

Pour plus de sécurité et de compatibilité, il est recommandé d'utiliser le port 587 avec STARTTLS.

SMTP Server et SMTP Port: Stockent le domaine (ou l'adresse IP) et le numéro de port du serveur de messagerie.

Il convient de vérifier que le serveur Pandora FMS peut résoudre, via le serveur ou les serveurs DNS, l'adresse (mta_address) du serveur de messagerie responsable du domaine de messagerie. Pour cela, vous pouvez utiliser la commande nslookup en remplaçant example.com par le domaine de messagerie à utiliser :

nslookup -type=mx example.com

Il faut également vérifier que ce serveur de messagerie accepte les mails redirigés depuis le serveur Pandora FMS.

Le token mta_auth, par défaut, est configuré en tant que commentaire (et avec l'option LOGIN activée). Si nécessaire, vous pouvez l'activer en modifiant cette ligne et en indiquant le type d'authentification requis.


Configuration de certains fournisseurs de services de messagerie :

Une fois la configuration de la messagerie enregistrée, cliquez sur l'option Email test pour vérifier si la configuration est correcte en envoyant un message généré par Pandora FMS à l'adresse indiquée. Si la configuration sélectionnée est correcte, le message apparaîtra dans la boîte de réception de l'adresse indiquée.

Aruba (aruba.it)®
  • SMTP Server: smtps.aruba.it.
  • SMTP Port: 465.
  • Encryption: SSL.

Amazon Simple Email Service (AWS SES)®
  • SMTP Server: email-smtp.< region >.amazonaws.com< region > doit être remplacé par l'emplacement du serveur (en Espagne, c'est email-smtp.eu-south-2.amazonaws.com ; AWS peut changer ces valeurs à tout moment).
  • SMTP Port: 587.
  • Encryption: STARTTLS.

easyDNS (outbound mail)®
  • SMTP Server: mailout.easydns.com.
  • SMTP Port: 587.
  • Encryption: STARTTLS.

Gmail®

Pour des raisons de sécurité, il est conseillé d'utiliser un compte Gmail® spécifiquement créé pour envoyer des notifications depuis le serveur Pandora FMS. Ne jamais utiliser un compte personnel pour cela.

Gmail® impose des limites strictes d'envoi qui restreignent le nombre croissant de messages à envoyer. Il est recommandé d'utiliser un service transactionnel tel que SendGrid® ou Mailgun® pour les grandes équipes utilisant la configuration SMTP.

Voir aussi Google (OAuth 2.0).

  • SMTP Server: smtp.gmail.com.
  • SMTP Port: 587.
  • Encryption: STARTTLS.

En cas d'erreurs d'authentification, il faut vérifier que :

Mailgun®
  • SMTP Server: smtp.mailgun.org.
  • SMTP Port: 587.
  • Encryption: STARTTLS.

Postmark®
  • SMTP Server: smtp.postmarkapp.com.
  • SMTP Port: 587.
  • Encryption: STARTTLS.

Proton Mail
  • SMTP Server: smtp.protonmail.ch.
  • SMTP Port: 587.
  • Encryption: STARTTLS.

Microsoft 365 Exchange (OAuth 2.0)

Il faut prendre en compte que les versions d'essai de MS 365 Exchange® peuvent donner des erreurs, car elles peuvent être détectées comme des courriers indésirables ou spam. Cela est dû à la configuration réalisée dans le compte Azure®.

Dans ce cas, le client devra contacter Microsoft® afin que les adresses soient ajoutées manuellement à la liste des courriers non suspects.

  • Dans Microsoft Azure®, il faut enregistrer l'application à utiliser :

  • Une fois l'application enregistrée, prenez note du Client ID et du Tenant ID :

  • Créez un Client secret et notez correctement cette valeur :

Le Secret ID ne sera affiché qu'une seule fois lors de la création du token.

  • Donnez des permissions sur l'API pour obtenir les utilisateurs et envoyer des mails :

  • Vérifiez que l'application Office 365 Exchange est enregistrée :

  • Ensuite, il faut activer l'application Office 365 Exchange :

  • Enfin, configurez Pandora FMS avec les informations OAuth2 obtenues :

Menu Management → Settings → System settings → General Setup → Alerts configuration et activez OAuth2 pour que les champs à configurer apparaissent.

Google (OAuth 2.0)

Lorsque vous activez l'option OAuth 2.0, vous devez sélectionner Google comme OAuth 2.0 Mail server, et obtenir les données nécessaires depuis Google Cloud®. Pour cela, créez un nouveau projet :

Une fois le projet créé, allez dans la bibliothèque de Gmail®, sous la section API Library, option Gmail API :

Activez cette option :

Dans la section Data Access, donnez les permissions pour l'envoi de mails :

Dans Service accounts, créez un nouvel élément pour obtenir le CLIENT ID :

Une fois tout cela activé et configuré, l'étape suivante consiste à configurer avec l'administrateur du domaine les identifiants OAuth2 pour obtenir les différentes clés à configurer.

Avec le compte superadmin, ayant copié le CLIENT ID, suivez ces étapes :

  • Allez dans la console d'administration de Google® : admin.google.com.
  • Accédez à Security → Access and data control → API controls.
  • Cliquez sur Manage Domain-Wide Delegation.
  • Cliquez sur Add new.
  • Créez l'enregistrement avec l'ID du Service account créé et son étendue :
https://www.googleapis.com/auth/gmail.send

Documentation de Google sur OAuth 2.0 :

https://support.google.com/a/answer/162106

Command center

Menu Management → Settings → System Settings → Command Center .






Cette section permet d'intégrer un serveur PFMS standalone à un Command center et ainsi le transformer en un de ses nœuds. Les différents champs contiennent l'emplacement, le type de base de données (MySQL toujours par défaut), le nom de la base de données, etc., y compris les options nécessaires pour chiffrer les communications (token Enable SSL).

Dans Command center link status, l'état de la connexion sera toujours visible, y compris les messages d'aide pour chaque cas.

Politiques de mots de passe

Menu Management → Settings → System Settings → Password policy .






Pour activer la politique de mots de passe, vous devez avoir un profil d'administrateur (Pandora administrator) ou être superadmin.

Base de données historique

Menu Management → Settings → System Settings → Historical database → Enable historical database .






Cette fonctionnalité permet de sauvegarder les données ayant une ancienneté spécifiée dans une base de données différente de la principale pour accélérer l'exploitation de cette dernière.

Dans la configuration de la connexion (Configure connection target), les données de base doivent être configurées (adresse et port, nom de la base de données et informations d'identification). À partir de la version 782, MySQL peut être connecté de manière sécurisée (SSL) en définissant les paramètres suivants :

  • Enable SSL: Active ou désactive l'utilisation de SSL pour la connexion à la base de données.
  • SSL server key: Chemin ou emplacement du fichier, au format PEM, contenant la clé SSL du serveur MySQL.
  • SSL server cert: Chemin ou emplacement du fichier, au format PEM, contenant le certificat de la clé SSL du serveur MySQL.
  • SSL CA cert: Chemin ou emplacement du fichier, au format PEM, contenant une liste de certificats SSL émis par une autorité de certification.
  • SSL CA path: Chemin ou emplacement du répertoire contenant les certificats SSL émis par une autorité de certification. Les certificats doivent être au format PEM.
  • SSL verify server cert: Si activé, vérifie la connexion MySQL (CN du certificat SSL), si cela ne correspond pas, la connexion échouera.

Notez qu'à la première connexion à la future base de données historique, l'utilisateur spécifié créera une nouvelle structure de données. Si cela échoue, le bouton Enable historical database sera désactivé. Consultez votre administrateur réseau et/ou administrateur de base de données concernant les privilèges définis pour le compte utilisateur utilisé.

Après une connexion réussie à la base de données historique, vous pouvez configurer les paramètres personnalisés (Customize settings):

Paramètres pour les données actives vers historiques :

  • Advanced options: Active les options avancées :
  1. String data days old to keep in active database: Ancienneté des données de chaîne à maintenir dans la base de données active. Les données de chaîne seront disponibles dans la base de données active pendant le temps et les jours spécifiés ici. Les informations plus anciennes seront envoyées vers la base de données historique. Les données seront purgées de la base de données active après 0 jours (valeur par défaut).
  • Data days old to keep in active database: Après combien de jours les données seront transférées vers la base de données historique. Valeur par défaut : quinze 15 jours.
  • Transference block size (Step): Mécanisme pour le transfert de données (similaire à un buffer de données) vers la base de données historique. Moins le nombre d'enregistrements est élevé, moins cela affectera les performances de la base de données principale. Valeur par défaut : mille cinq cents 1500 enregistrements, valeur recommandée : mille. Voir le point suivant pour configurer la période de temps.
  • Delay between transferences (seconds): Délai en secondes entre les transferts de données entre la base de données principale et la base de données historique. Valeur par défaut : un 1, valeur recommandée : deux 2.

Paramètres pour les données historiques :

  • Maximum historical data age (days): Nombre maximum de jours pour conserver les données numériques. Valeur par défaut : cent quatre-vingts 180.
  • Maximum historical string data age (days): Nombre maximum de jours pour conserver les données de chaîne de texte. Valeur par défaut : cent quatre-vingts 180.
  • Automatic partition of big tables: Pour créer automatiquement des partitions mensuelles dans les fichiers IDB des bases de données spécifiques (tagente_datos, tagente_datos_string, ttrap).

Paramètres pour les événements historiques :

  • En cliquant sur Enable historical events active les tokens suivants :
  1. Events days old to keep in active database: Nombre de jours pour conserver les événements dans la base de données historique. Valeur par défaut : quatre-vingt-dix 90 jours. Notez que dans la base de données principale, les événements sont supprimés (purgés) après sept jours.
  2. Maximum historical events age (days): Nombre de jours avant de supprimer définitivement les événements de la base de données historique. Valeur par défaut : cent quatre-vingts 180 jours.

Paramètres pour les SNMP traps historiques :

  • En activant l'option Enable historical traps, il est possible de stocker les traps SNMP dans la base de données historique :
  1. Days old to keep in active database: Nombre de jours à conserver dans la base de données active. Valeur par défaut : 6 jours.
  2. Maximum historical traps age (days): Nombre de jours à conserver dans la base de données historique. Valeur par défaut : 180 jours.

Collecteur de logs

Menu Management → Settings → System Settings → Log collector .






Il doit être configuré comme expliqué dans “Collecte et surveillance des logs”.

SIEM

Menu Management → Settings → System Settings → SIEM → Activate SIEM .

Pour commencer à effectuer la supervison SIEM, une licence SIEM spécifique doit être installée sur le serveur PFMS, ainsi qu'un serveur OpenSearch pour établir la connexion nécessaire avec Pandora FMS.

Une fois que ce serveur est configuré, son adresse IP ou son URL (l'utilisation de HTTPS est recommandée) et le numéro de port (par défaut 9200) seront renseignés ici, et la connexion sera testée, affichant son succès ou son échec dans la section SIEM status :

Il est important que dans Basic authentication, les identifiants de l'utilisateur à utiliser sur le serveur OpenSearch soient définis.

Pour les valeurs de Index configuration, voir le sujet “Collecte et supervision des journaux”.

Authentication

Menu Management → Settings → System Settings → Authentication .


Dans les processus d'authentification à distance, il est nécessaire de vérifier que les numéros de port sont configurés correctement.

Méthode d'authentification: Local Pandora FMS par défaut, ce qui signifie que l'authentification sera effectuée à l'aide de la base de données interne de Pandora FMS. Les utilisateurs de type superadmin sont toujours authentifiés de cette manière pour des raisons de sécurité, tandis que les autres types d'authentifications ont l'option locale en secours (fallback).
Voir aussi “Système d'authentification avec des tiers”.
Les champs suivants sont communs à toutes les options précédentes :

  • Double authentication: Les utilisateurs peuvent choisir d'activer l'authentification à deux étapes pour leurs comptes. Cette fonctionnalité nécessite que le serveur et les appareils mobiles aient une date et une heure synchronisées et aussi précises que possible.
  • Session timeout based on: Par défaut activé, vérifie s'il n'y a pas eu d'activité de l'utilisateur (ou en prenant en compte la date et l'heure du dernier login) dans la période de temps définie dans Session timeout (mins) pour fermer la session. Valeurs pour ce dernier token :
  1. La valeur par défaut est 90 minutes.
  2. Lorsque cette valeur est définie sur 0 pour un utilisateur, Pandora FMS utilisera la valeur enregistrée dans la configuration générale, section authentification.
  3. Si vous souhaitez que la session n'expire pas, définissez-la sur -1. Un utilisateur connecté à la console Web avec un écran actif sera en auto-rafraîchissement et ne sera pas considéré comme inactif.

Performance

Menu Management → Settings → System Settings → Performance .


La performance de Pandora FMS est affectée par divers facteurs qui doivent être affinés dans les sections suivantes.

Les modules avec des intervalles de moins de 300 secondes ne seront conservés dans la base de données principale que pendant une semaine, après quoi ils seront automatiquement déplacés dans l'archive historique, si cette fonctionnalité est activée.


Database maintenance status

Affiche l'état du maintenance des bases de données :

  • Pandora_db running in active database: Si pandora_db dépasse 12 heures sans exécution, il marquera un état critique.
  • Pandora_db running in historical database: Cela apparaît uniquement si une base de données historique est configurée ; de même, si pandora_db dépasse 12 heures sans exécution sur la base de données historique, un état critique sera marqué.

Les modules avec des intervalles de moins de 300 secondes ne seront conservés dans la base de données principale que pendant une semaine et seront automatiquement déplacés dans l'archive historique après ce temps, si cette fonctionnalité est activée.


Database maintenance options

  • Max. days before events are deleted: Nombre maximal de jours avant de supprimer les événements, sept par défaut.
  • Max. days before traps are deleted: Nombre maximal de jours avant de supprimer les traps SNMP, sept par défaut.
  • Max. days before audited events are deleted: Nombre maximal de jours avant de supprimer les événements d'audit, valeur par défaut : quinze.
  • Max. days before string data is deleted: Nombre maximal de jours avant de supprimer les chaînes de données, sept par défaut.
  • Max. days before GIS data is deleted: Nombre maximal de jours avant de supprimer les données GIS, sept par défaut.
  • Max. days before purge: Nombre maximal de jours avant de supprimer des données, 45 par défaut. Cela spécifie également le nombre maximal de jours pendant lesquels conserver les données historiques d'inventaire.
  • Compact data before moving it to history: Les données peuvent être compressées en effectuant un nombre d'échantillons par heure (Compaction samples per hour) avant de les déplacer dans la base de données historique.
  • Max. days before unknown modules are deleted: Nombre maximal de jours avant de supprimer les modules inconnus sauf s'ils sont dans une politique.
  • Max. days before delete not initialized modules: Nombre maximal de jours avant de supprimer les modules non initialisés.
  • Max. days before autodisabled agents are deleted: Nombre de jours (par défaut 30) à partir duquel les agents auto désactivés seront supprimés.
  • Retention period of past special days: Nombre de jours après lesquels les jours spéciaux passés seront supprimés.
  • Max. macro data fields: Nombre de champs qui peuvent être utilisés pour les commandes d'alertes.
  • Max. days before delete old messages: Nombre de jours après lesquels les messages reçus seront supprimés.
  • Max. days before inventory data is deleted: Nombre de jours après lesquels les données d'inventaire seront supprimées.
  • Max. days before disabled agents are deleted: Nombre de jours après lesquels les agents désactivés seront supprimés (par défaut 0, jamais).
  • Max. days before policy queue is purged: S'applique à la file d'attente des politiques de surveillance déjà appliquées qui seront supprimées une fois que le nombre de jours spécifié ici sera atteint.

Historical database maintenance options

Ces paramètres apparaîtront uniquement si une base de données historique est configurée dans Pandora FMS.

  • Max. days before purge: Nombre maximal de jours (180 par défaut) avant de supprimer des données historiques.
  • Max. days before events are deleted: Nombre maximal de jours (180 par défaut) avant de supprimer les événements historiques.
  • Max. days before string data is deleted: Nombre maximal de jours (180 par défaut) avant de supprimer les chaînes de données historiques.

Others

  • Item limit for real-time reports: Champ où le nombre maximal d'éléments de données à représenter dans le graphique en temps réel est défini, valeur par défaut : 100.
  • Limit of events per query: Pour définir une limite maximale sur le nombre d'événements retournés dans une requête, valeur par défaut : 5000.
  • Default hours for event view: Champ où le champ d'heures du filtre par défaut dans la vue des événements est défini. Ce champ affecte également l'affichage, le comptage et les graphiques des événements dans la vue tactique, la valeur par défaut étant huit heures.
  • Use real-time statistics: Activer ou désactiver l'utilisation des statistiques en temps réel. Si les statistiques en temps réel sont désactivées, le temps de rafraîchissement des statistiques sera défini dans Batch statistics period (secs) (par défaut 60 secondes).
  • Disable unknown status control on software agents modules by default: Par défaut, les modules créés par les points de terminaison PFMS sont désactivés pour la détection des états inconnus en inconnu.
  • Max. recommended number of files in attachment directory: Nombre maximal de fichiers stockés dans le répertoire de pièces jointes (attachment).
  • Delete not initialized modules: Activer ou désactiver la suppression des modules non initialisés.
  • Big Operation Step to purge old data: Nombre de blocs dans lesquels le script pandora_manage divise un intervalle de temps. Une valeur plus grande implique des blocs de temps plus grands, ce qui entraîne davantage d'opérations, mais plus légères. Sur des systèmes surchargés et avec de très grandes bases de données, il peut être recommandé d'augmenter cette valeur même si le nettoyage des données prend plus de temps.
    • Small Operation Step to purge old data: Nombre de lignes que « pandora_manage.pl » traite dans une seule requête ou query SQL. Cela signifie que pour chaque bloc de temps défini par le paramètre Big Operation Step to purgue old data, un maximum de 1000 enregistrements seront purgés à chaque requête (en utilisant la valeur par défaut). Une valeur plus élevée implique des requêtes plus importantes, ce qui signifie moins d'opérations mais plus lourdes. Dans les systèmes surchargés, il peut être recommandé de réduire cette valeur, même si la purge des données prend plus de temps. La valeur par défaut et recommandée est 1000.
  • Graph container - Max. Items: Champ permettant de définir le nombre maximal d'éléments dans la vue graph container.
  • Events response max. execution: Champ dans lequel est défini le nombre maximal d'événements pouvant effectuer l'opération massive Event Responses.
  • Row limit in csv log: Limite de lignes pour le log au format CSV.
  • SNMP walk binary et SNMP walk binary (fallback): Lorsque SNMP bulk walk n'est pas en mesure de demander V1 SNMP, cette option sera utilisée à la place (par défaut « snmpwalk », plus lent).
  • WMI binary: Fichier exécutable à utiliser dans les requêtes WMI, par défaut pandorawmic.
  • Rows limit for SQL report item PDF: Limite par défaut à un maximum de cinq mille lignes afin d'éviter de surcharger les capacités matérielles où est exécuté le PFMS Server. Si la valeur zéro est saisie, aucune limite n'est définie. À utiliser avec précaution. Dans le cas du Command Center, la somme des valeurs configurées dans chaque nœud s'affiche.

Agent SNMP Interface Wizard defaults

Pour compléter la configuration SNMP de la section précédente, vous pouvez définir les valeurs par défaut à utiliser pour les différents modules dans l'SNMP interface wizard.

Visual styles

Menu Management → Settings → System Settings → Visual styles .


Dans cette section, vous pouvez configurer tous les éléments visuels de Pandora FMS.

Style

Menu Management → Settings → System Settings → Visual styles → Style.


Configuration du style pour les éléments graphiques :

Depuis la version 784, il est possible de sélectionner des modèles visuels au niveau de l'utilisateur et/ou du groupe et/ou globalement (dans cet ordre hiérarchique d'application). Cette section décrit cela au niveau général, et cette interface graphique (non les valeurs de configuration) est partagée avec d'autres niveaux.

Notes importantes :

  • Style template: Pour ajouter de nouveaux thèmes, vous devez ajouter un fichier CSS dans le répertoire :
    …/pandora_console/include/styles
  • Edit custom css: Pandora FMS est installé sans le fichier custom.css, qui (si il existe) est le dernier à se charger parmi tous les fichiers CSS. Pour changer les classes CSS (par défaut dans la Console Web PFMS), ce fichier, s'il n'existe pas, sera automatiquement créé par un utilisateur administrateur (en cliquant sur le bouton) et restera inchangé lors de chaque mise à jour de version PFMS. Une utilisation pratique consiste à redéfinir chaque classe CSS :
.message-welcome {
     font-size: 40px;
     font-weight: bold;
     color: #4CAF50;
     text-transform: uppercase;
     font-family: Arial, sans-serif;
}

Cela produira le changement suivant dans le message de bienvenue :

  • Status icon set: Dans le cas des utilisateurs daltoniens, ces icônes peuvent être remplacées par d'autres icônes conceptuelles qui permettent de différencier les états autrement.
  • Custom favicon: Il doit être au format .ico et ses dimensions doivent être de 16 par 16 pixels pour fonctionner correctement. Vous pouvez ajouter des icônes à choisir dans le dossier :
    …/pandora_console/images/custom_favicon
  • Custom documentation logo et Custom support logo: Icône pour le lien vers la documentation et le support à l'écran de connexion. Si laissé vide, aucune icône ne sera affichée. Le chemin pour télécharger plus d'icônes est :
    …/pandora_console/enterprise/images/custom_general_logos/
  • Product name et Copyright notice: Par défaut, le nom du produit est Pandora FMS, cependant l'utilisateur peut effectuer un rebranding et le changer par une autre chaîne de texte afin d'avoir une version personnalisée.
  • Background opacity % (login): Permet de spécifier un pourcentage d'opacité (par défaut 30 %) à l'écran de connexion.
  • Disable helps: Désactive les icônes d'aide (liens vers cette documentation). Les conseils (aide rapide) sont toujours maintenus.
  • Fixed header: L'header est toujours affiché, c'est-à-dire qu'il ne se cache pas lors du défilement (déplacement vertical de la fenêtre).
  • Automatically hide submenu: Lorsque cette option est activée, le menu latéral est minimisé.
  • Random background (login): Si aucun fond d'écran n'est configuré pour l'écran de connexion (voir Custom background logo), lorsque cette option est activée, un des fichiers graphiques stockés dans :
    …/pandora_console/images/backgrounds/random_backgrounds

    sera affiché de manière aléatoire.

Les tokens suivants pour la configuration alternative pour rebranding sont stockés sous forme de commentaires (commentés) dans le fichier config.php
pour conserver la configuration en cas de défaillance de la base de données :

//
 ----------Rebranding--------------------
// Décommentez ces lignes et ajoutez vos textes et chemins personnalisés.
// $config["custom_logo_login_alt"] ="login_logo.png";
// $config["custom_splash_login_alt"] = "splash_image_default.png";
// $config["custom_title1_login_alt"] = "WELCOME TO Pandora FMS";
// $config["custom_title2_login_alt"] = "NEXT GENERATION";
// $config["rb_product_name_alt"] = "Pandora FMS";
// $config["custom_docs_url_alt"] = "http://pandorafms.com/manual/";
// $config["custom_support_url_alt"] = "https://support.pandorafms.com";

Comportement

Menu Management → Settings → System Settings → Visual styles → Behaviour.

  • Block size for pagination: Champ où la taille de la pagination des éléments (événements, alertes, etc.) est choisie. Valeur par défaut : 20.
  • Click to display lateral menus: Ce paramètre configure si le menu latéral est affiché lorsqu'on clique (bouton gauche de la souris) dessus ou lorsqu'on survole le menu.
  • Paginated module view: Active la pagination dans la liste des modules.
  • Display data of proc modules in other format: Les données de type proc représentent les états binaires d'un module. Elles sont enregistrées sous forme de nombres dans la base de données, mais peuvent aussi être représentées de manière descriptive avec un identifiant pour chacun des deux états. L'activation de cette option utilise cette seconde méthode de représentation.
  1. Display text when proc modules are in OK status: Lorsque l'option Display data of proc modules in other format est activée, ce texte apparaît à la place du nombre lorsque le module est en état OK.
  2. Display text when proc modules are in critical status: Lorsque l'option Display data of proc modules in other format est activée, ce texte apparaît à la place du nombre lorsque le module est en état critique.
  • Service label font size: Taille de la police par défaut pour les services.
  • Space between items in Service maps: Distance (en pixels) entre deux éléments dans les cartes de services. Pour éviter les chevauchements, cette valeur doit être supérieure à 80 pixels.
  • Tabs menu: Par défaut, affiche les icônes et le menu contextuel pour la vue principale des agents dans la Console Web. Les deux autres options (icônes seulement ou menu contextuel seulement) combinent les deux options si l'espace à l'écran est insuffisant.
  • Keyboard shortcut filter menu: Permet de modifier le raccourci clavier pour les filtres latéraux dans les vues, si applicable. Fonctionne uniquement avec des lettres minuscules.

GIS

Menu Gestion → Paramètres → Paramètres système → Styles visuels → GIS.

  • GIS Labels : Activez les étiquettes ou labels avec le nom de l'agent dans les cartes GIS. Il est conseillé de désactiver cette option lorsque vous avez beaucoup d'agents sur une carte, afin d'améliorer la lisibilité.
  • Default icon in GIS : Ensemble d'icônes par défaut pour les agents sur les cartes GIS.

Graphiques

Menu Management → Settings → System Settings → Visual styles → Charts.


Configuration des graphiques :

Notes importantes :

  • Value to interface graphics: Nom des unités pour les graphiques d'interface, par défaut Bytes.
  • Data precision: Nombre de décimales à afficher dans les rapports et les consoles visuelles. Il doit être compris entre 0 et 5.
  • Data precision in graphs: Nombre de décimales à afficher dans les graphiques. Il doit être compris entre 0 et 20.
  • Number of elements in custom graph: Pour limiter le nombre de légendes dans les graphiques combinés. Considérez également réduire la largeur des légendes, les rendre plus concises et aussi courtes que possible. Les graphiques combinés qui répondent à ce token sont de type :
  1. Ligne.
  2. Aire.
  3. Barres verticales.
  4. Barres horizontales.
  5. Empilées ou stacked.
  • Chart fit to content: Il existe des graphiques dont les valeurs sont des pourcentages et dont le sommet du graphique dépasse la valeur maximale de cent. Vous pouvez configurer les graphiques pour qu'ils cessent d'ajouter une marge supérieure proportionnelle en activant cette option.
  • Percentile: Affiche une ligne avec le percentile indiqué dans les graphiques. La valeur par défaut est 95.
  • Le paramètre Graph TIP view indique si des graphiques TIP seront affichés :
  1. None (Aucun) : L'option TIP de la configuration des graphiques sera désactivée (option par défaut).
  2. All (Tous) : L'option TIP du menu des graphiques sera activée.
  3. On Boolean graphs (Graphiques booléens) : L'option TIP sera activée uniquement dans le menu des graphiques de type vrai ou faux.

Police et texte

Menu Management → Settings → System Settings → Visual styles → Font and text.



Configuration des polices de texte et du texte :

  • Graphs font size: Champ où la taille de la police utilisée par PFMS pour les graphiques est sélectionnée.
  • Show unit along with value in reports: Affiche les unités en plus de la valeur du module dans les rapports.
  • Truncate agent text at end et Truncate module text at end: Lorsqu'ils sont activés, ils tronquent le nom des agents et des modules à la fin et ajoutent des points de suspension (le comportement par défaut est de tronquer au milieu) pour la section Operation → Monitoring → Views.
  • Agent text size: Lorsque le nom de l'agent est trop long, dans certaines sections de Pandora FMS, le texte est tronqué pour n'afficher que les premiers caractères (valeurs par défaut : 18 caractères pour une petite police et 50 caractères pour une taille normale).
  • Module text size: Lorsque le nom des modules est trop long, dans certaines sections de Pandora FMS, le texte est tronqué pour n'afficher que les premiers caractères (valeurs par défaut : 25 caractères pour une petite police et 50 caractères pour une taille normale).
  • Description text size: Lorsque la description est trop longue, dans certaines sections de Pandora FMS, le texte est tronqué pour n'afficher que les premiers caractères (valeur par défaut : 60 caractères).
  • Item title text size: Lorsque le titre est trop long, dans certaines sections de Pandora FMS, le texte est tronqué pour n'afficher que les premiers caractères (valeur par défaut : 45 caractères).

Consoles visuelles

Menu Management → Settings → System Settings → Visual styles → Visual consoles.



Configuration des consoles visuelles :

  • Default cache expiration: Cette section définit la fréquence à laquelle la cache de l'état des éléments est effacée, et donc à quelle fréquence l'état de chacun est recalculé individuellement.
  • Default interval for Visual Console to refresh: Cet intervalle n'affectera que les pages des consoles visuelles, définissant la fréquence de leur rafraîchissement automatique.
  • Type of view of visual consoles: Menu déroulant pour indiquer si vous souhaitez afficher les consoles visuelles favorites dans le menu.
  • Number of favourite visual consoles to show in the menu: Pour éviter les chevauchements et améliorer les performances de la console Web, ce token limite le nombre de consoles favorites à afficher dans le menu latéral.
  • Default line width for the Visual Console: Largeur de ligne dans les consoles visuelles. Bien que cette option puisse être modifiée individuellement pour chaque ligne dans la console visuelle, la valeur par défaut ici est 2.
  • Visual console default text margin (em): Par défaut 1 em, permet d'agrandir ou de réduire la marge de texte pour les éléments des Consoles visuelles qui l'utilisent (Static image, etc.).
  • Lock screen orientation when viewing on mobile devices: Dans la console mobile, empêche l'écran d'être tourné selon le capteur de mouvement.
  • Display item frame on alert triggered: Permet de cacher un cadre orange lorsque les éléments Static image, Simple value, Icon, Group des Consoles visuelles ont une alerte déclenchée. Activé par défaut.

Rapports

Menu Management → Settings → System Settings → Visual styles → Reports.



Configuration des rapports :

  • Show report info with description: Description des informations de rapports personnalisés. S'applique à tous les rapports et modèles par défaut.
  • Front page for custom reports: Page de couverture pour les rapports personnalisés. S'applique à tous les rapports et modèles par défaut.
  • PDF font size (px): Taille de la police, en pixels, pour les fichiers PDF.
  • HTML font size for SLA (em): Taille de la police pour les rapports SLA (uniquement HTML). Il s'agit d'une mesure relative appelée em, qui correspond au nombre de fois où la taille de la police en pixels choisie.
  • Graph image height for HTML reports: Hauteur, en pixels, des graphiques de module ou des graphiques personnalisés dans les rapports (uniquement HTML).
  • Interval description: Affiche la description de l'intervalle de temps sous forme abrégée ou non. Une description longue (Long) est, par exemple, “10 heures, 20 minutes, 33 secondes” ; une description courte (Short) est “10h 20m 33s”.

Les autres champs permettent de choisir un logo personnalisé et de modifier l'en-tête, le pied de page et la couverture (les macros peuvent être incluses) macros.

Services

Menu Management → Settings → System Settings → Visual styles → Services.

  • Number of favorite services to show in the menu: Nombre maximal (entre 1 et 25) de services favoris pouvant être affichés dans le sous-menu respectif.

Autres

Menu Management → Settings → System Settings → Visual styles → Other.



Autres paramètres :

  • Show only the name of the group: Affichera le nom du groupe au lieu de son icône.
  • Date format string: Champ où le format de date et heure selon PHP est défini ; pour ajouter le timezone il faut utiliser T.
  • Show empty groups in group view: Permet d'afficher les groupes vides dans la vue des groupes.
  • Visible time of successful notifications: Temps à attendre, en secondes, pour afficher les notifications.
  • Decimal separator: Séparateur décimal à utiliser dans les rapports.
  • Interval values: Permet de personnaliser les valeurs de temps (secondes, minutes, etc.) que le champ Interval prendra dans les formulaires de Pandora FMS (excepté pour la vue des commentaires d'événements).
  • Timestamp, time comparison, or compact mode: Définit la date et l'heure utilisées, le timestamp du système (Timestamp in rollover), une comparaison avec la base de données (Rollover comparison) ou en mode compact (Compact mode). Cela est utile lorsque la base de données se trouve sur un autre système que la console Web.
  • Custom value post processing: Valeurs de conversion personnalisées pour le post-traitement. Met à jour une table dans la base de données pour avoir des conversions personnalisées d'unités. Si vous ajoutez par erreur une valeur numérique incorrecte, sélectionnez-la dans la liste Delete custom values et supprimez-la avec le bouton Delete ci-dessous, puis réajoutez la valeur de conversion personnalisée.
  • Module units: Cette option permet de définir l'unité des données collectées par les modules.
  • CSV divider: Caractère ou jeu de caractères utilisé pour séparer les données lors de l'exportation en CSV.
  • CSV decimal separator: Symbole à utiliser pour le séparateur décimal lors de l'exportation en CSV.
  • Data multiplier to use in graphs/data: Valeur utilisée pour multiplier les données affichées afin de les représenter dans les graphiques. Cela est utile si l'unité de valeur est bytes ; pour d'autres conversions, utilisez Custom value post processing.
  • Hide general stats for non admin users in tactical view: Dans la Vue Tactique, toutes les informations disponibles sont affichées par défaut. En activant cette option, seuls les utilisateurs de type superadmin continueront à avoir accès à toutes les informations, tandis que les autres utilisateurs verront les informations filtrées.

NetFlow

Menu Management → Settings → System Settings → NetFlow .

Cette fonctionnalité doit être activée via le token Enable NetFlow. Pour plus d'informations, consultez le sujet “Surveillance réseau avec NetFlow®”.

IOT Server

Menu Management → Settings → System Settings → IOT Server .

Cette fonctionnalité doit être activée via le token Enable IOT Server. L'intégration Pandora IOT a pour objectif de superviser les messages reçus d'un serveur broker MQTT.

sFlow

Menu Management → Settings → System Settings → sFlow .

Cette fonctionnalité doit être activée via le token Enable NetFlow, puis aller dans cet onglet et activer sFlow® à partir de là. Pour plus d'informations, consultez le sujet “Surveillance réseau avec sFlow®”.

Pandora ITSM

Menu Management → Settings → System Settings → Pandora ITSM .

Permet d'activer la connexion et communication entre Pandora FMS et Pandora ITSM. En activant le bouton Enable Pandora ITSM, il sera possible de le configurer pour être utilisé par tous les utilisateurs (option par défaut activée) ou pour que chaque utilisateur configure sa propre connexion.

Pandora ITSM API settings

Il est nécessaire de configurer à la fois la connexion entrante pour Pandora ITSM et la connexion entrante pour Pandora FMS afin d'assurer une communication bidirectionnelle.

  • URL to Pandora ITSM setup: Adresse web ou adresse IP pour connecter l'API Pandora ITSM, au format suivant :
    http://192.168.1.20/XXX/api/v2
  • URL connect to API Pandora FMS: URL pour connecter à l'API Pandora FMS, par défaut elle prend celle définie dans le token Public URL, et si elle n'est pas définie, elle prendra celle présente dans config.php.
  • Boutons Test: Chacun testera la connexion de Pandora FMS à Pandora ITSM et vice versa.
  • Si les tests de connexion réussissent, Pandora ITSM prendra les agents de PFMS et les convertira en objets d'inventaire, et la gestion des incidents dans PITSM sera disponible depuis PFMS.

Pandora RC

Menu Management → Settings → System Settings → Pandora RC .

En activant la configuration avec le bouton Enable Pandora RC, l'accès à l'intégration avec Pandora RC sera disponible.

Notifications

Menu Management → Settings → System Settings → Notifications .

Dans Pandora FMS, il existe un système de notification et de surveillance de l'état de la console et du système en général. Vous pouvez activer les notifications en suivant les instructions détaillées dans la section “Gestion de la console”.

QuickShell

Menu Management → Settings → System Settings → QuickShell .

Pour le bon fonctionnement de QuickShell, il sera nécessaire d'avoir le binaire pandora_gotty installé dans /usr/bin/.

Cette fonctionnalité est installée par défaut, et la seule configuration supplémentaire requise sera de permettre la connexion dans le pare-feu (firewall) installé et d'ajouter le numéro de port 8080.

QuickShell Configuration

Il faut indiquer l'adresse IP ou simplement l'URL (sans http) de la Console web PFMS et le numéro de port à utiliser, 8080 par défaut (la connexion doit être autorisée dans le firewall correspondant).

Vous pouvez activer la connexion via SSH (Enable SSH method) et/ou Telnet (Enable telnet method). Vous pouvez ensuite tester et vérifier la connexion avec les boutons Test correspondants.

Lors de l'enregistrement des valeurs avec le bouton Update, QuickShell sera exécuté.

Configuration optionnelle de QuickShell avec méthodes sécurisées

Si des certificats SSL sont disponibles, il est recommandé de chiffrer la transmission des connexions pour renforcer la sécurité.

Tout d'abord, vous devez avoir configuré les valeurs de base et vérifié les connexions normales, sans chiffrement.

Ensuite, pour chiffrer les communications (Use SSL pour SSH et/ou Telnet), les configurations suivantes doivent d'abord être réalisées :

  • Des certificats SSL doivent être disponibles dans la Console Web de Pandora FMS.
  • Ces certificats doivent avoir des autorisations de lecture pour le serveur web Apache.
  • Ajoutez les options suivantes de TLS/SSL dans le fichier /etc/pandora_gotty/pandora_gotty.conf (remplacez le chemin et le nom du fichier pour chaque paramètre avec les valeurs à utiliser) :
/etc/pandora_gotty/pandora_gotty.conf
//Pandora GoTTY config file

(…)

// [bool] Enable TLS/SSL
enable_tls = true

// [string] Default TLS certificate file path
tls_crt_file = "/path/.cert.crt"

// [string] Default TLS key file path
tls_key_file = "/path/key.key"

// [bool] Enable cliente certificate authentication
enable_tls_client_auth = false

// [string] Certificate file of CA for client certificates
tls_ca_crt_file = "/path/ca_cert.ca.crt"

(…)

Une fois tout cela prêt, il faut enfin activer Use SSL dans SSH et/ou Telnet, enregistrer avec le bouton Update et revérifier avec les boutons Test correspondants.

Outils externes

Menu Management → Settings → System Settings → External tools .

Dans la section outils externes, vous pouvez configurer les sons d'alarme et les chemins des fichiers exécutables suivants :

  • Graphviz.
  • Snmpget.
  • Traceroute.
  • Ping.
  • Nmap.
  • Dig.

Ces utilitaires sont généralement déjà installés avec les systèmes d'exploitation, mais si nécessaire, ils doivent être installés en supplément (Dig s'installe avec apt install dnsutils sur Ubuntu et dnf install bind-utils dans les environnements RHEL et Rocky Linux). Par défaut, les chemins par défaut du système d'exploitation utilisé sont utilisés (même s'ils ne sont pas affichés), et ils peuvent être modifiés dans cette section de la configuration générale de PFMS.

De plus, des commandes personnalisées peuvent être définies en utilisant des macros pour interagir avec les agents de Pandora FMS. Lors de l'ajout de la macro _address_, l'adresse IP de l'agent sera utilisée lors de l'exécution de la commande.

Astuces de bienvenue

Menu Management → Settings → System Settings → Welcome tips .

Les astuces sont des messages courts, accompagnés ou non d'un lien web pour obtenir plus de détails sur l'astuce affichée lors de la connexion à la Console web PFMS. La langue de chacune d'entre elles peut être définie et un filtre permet de rechercher par mot-clé dans le titre de chaque astuce.

Chaque utilisateur pourra définir sa propre configuration d'utilisateur avec le token Show usage tips at startup.

Grâce à la classification des Profils définie dans PFMS, les astuces de bienvenue dans la liste dans Profile peuvent être configurées, et selon le profil autorisé à chaque utilisateur, elles pourront ou non être visibles.

  • Une ou plusieurs images liées peuvent être ajoutées, à condition que leur taille soit de 464 par 260 pixels.
  • Chaque astuce peut être activée ou non pour être visible.

Connexion à la carte GIS

Menu Management → Settings → System Settings → QuickShell .

Cette fonctionnalité doit être activée via le token Enable GIS features. Toute la documentation sur les cartes GIS se trouve dans le sujet “Pandora FMS GIS”.

Licence

Menu Management → Settings → License.

Une fois Pandora FMS installé, vous pouvez appliquer une licence.

Ensuite, dans cette section, vous pouvez connaître l'état de celle-ci, demander une validation (bouton Validate) en cas de réinstallation d'une instance de Pandora FMS, ou demander une nouvelle licence (bouton Request new license).

En cliquant sur le bouton Show agent usage detail, vous pourrez connaître le nombre total d'agents (avec la possibilité de filtrer par agents activés) ainsi que les sous-totaux classés en trois grandes catégories.

Le serveur est installé avec une licence d'essai valable pour un maximum de 100 agents et un mois d'utilisation. Si vous souhaitez étendre cette licence, contactez votre représentant commercial de confiance ou remplissez le formulaire de contact.

Traduction de chaîne

Menu Management → Settings → Translate String.

Vous pouvez effectuer des traductions personnalisées (colonne Customize translation) même avec des variables macro ; cette extension est complètement décrite dans la section Translate string.

Outils d'administration

Menu Management → Admin tools.

Journal d'audit du système

Menu Management → Admin tools → System audit log.

Pandora FMS conserve un journal ou log de tous les changements et actions importants effectués dans la Console Pandora FMS. Vous pouvez obtenir plus d'informations dans la section Journal d'audit.

Données de démonstration

Menu Management → Admin tools → Demo data.

Cette option permet de générer un minimum de 30 agents avec des données de démonstration et des valeurs par défaut assignées.

Un Heavy Server doit être activé dans l'environnement pour que les données des agents générés soient mises à jour périodiquement.

Il est possible qu'il soit nécessaire d'augmenter la valeur du paramètre plugin_timeout dans la configuration du serveur afin que toutes les données des agents soient mises à jour.

En cliquant sur les options avancées (Advanced options), vous pourrez ajuster les paramètres suivants :

  • Agents interval: Cinq minutes, valeur par défaut.
  • Generate historical data for all agents: Lorsqu'il est activé, des données historiques seront générées pour les agents à créer, avec la quantité de jours spécifiée dans le champ Days of historical data to insert in the agent data (15 jours par défaut).
  • Create services: Permet de créer services.
  • Create network maps: Permet de créer cartes réseau.
  • Create GIS maps: Permet de créer cartes géographiques.
  • Create custom graphs: Permet de créer graphiques personnalisés.
  • Create reports: Permet de créer rapports.
  • Create visual consoles: Permet de créer consoles visuelles.
  • Create dashboards: Permet de créer tableaux de bord.
  • Traps target IP: Adresse IP pour les SNMP traps (127.0.0.1 par défaut). Toutes les SNMP traps de démonstration sont générées avec la version 1.
  • Traps community: Communauté pour les SNMP traps (public par défaut).
  • Tentacle target IP: Adresse IP pour l'envoi de données via le protocole Tentacle (127.0.0.1 par défaut).
  • Tentacle port: Numéro de port pour le protocole Tentacle (41121 par défaut).
  • Tentacle extra options: Paramètres du protocole Tentacle.

En cliquant sur le bouton Create demo data, toutes les options choisies seront appliquées. Pendant que l'environnement de démonstration est généré, vous pourrez voir une barre de progression et l'état de la création de chaque type d'élément une fois terminé. En fonction du nombre d'agents sélectionnés, cela peut prendre plus ou moins de temps.

Vous pourrez ensuite supprimer toutes ces données en cliquant sur le bouton Delete all demo data.

Liens

Menu Management → Admin tools → Links.

Permet d'ajouter, d'éditer ou de supprimer les liens de base pour le fonctionnement de Pandora FMS, ainsi que tous les liens jugés nécessaires pour les autres utilisateurs (menu Operations → Links).

Lors de l'installation de PFMS, les options suivantes seront disponibles :

  • Documentation: Pour accéder à ces documents (https://pandorafms.com/manual).
  • Get support: Pour signaler et obtenir de l'aide sur tout sujet lié à Pandora FMS (https://support.pandorafms.com/itsm). Les suggestions sont les bienvenues.
  • Module library: Lien essentiel pour maintenir les éléments de Discovery PFMS à jour et les plugins (https://marketplace.pandorafms.com/).

Par défaut, les descriptions des liens sont en anglais, mais elles peuvent être traduites manuellement dans votre langue principale à tout moment.

Infos de diagnostic

Menu Management → Admin tools → Diagnostic info.

Outil visuel qui montre l'état actuel du serveur Pandora FMS et de sa console web.

Il est possible d'exporter toutes les informations dans un fichier PDF.

Actualités du site

Menu Management → Admin tools → Site news.

Lorsque des informations importantes doivent être fournies aux utilisateurs, des messages peuvent être créés pour un groupe d'utilisateurs spécifique ou pour tous les utilisateurs. Cela se fait de deux manières :

  • Dans la vue initiale, une section News Board sera ajoutée avec tous les messages en cours, car vous pouvez définir une date d'expiration pour chacun d'entre eux.
  • L'autre manière, réservée aux messages très importants, est une fenêtre modale qui apparaîtra lorsque l'utilisateur se connectera à la Console web et se fermera lorsqu'il cliquera sur le bouton OK. À utiliser avec discrétion, car elle sera affichée à chaque connexion de l'utilisateur.

Pour créer une actualité, cliquez sur Add, écrivez l'objet ou le titre dans Subject, sélectionnez le groupe qui recevra l'annonce et la date limite pour l'affichage. Si vous sélectionnez Modal window, l'actualité s'affichera dans une fenêtre contextuelle que l'utilisateur devra lire et fermer.

Gestionnaire de fichiers

Menu Management → Admin tools → File Manager.

Outil utile pour télécharger des contenus graphiques dans Pandora FMS. Il affichera initialement tout le contenu du dossier images dans l'installation du serveur Pandora FMS.

La taille de chaque image est limitée par la valeur spécifiée dans le token Collection size (Bytes)

  • Téléchargez les fichiers que vous souhaitez en cliquant sur le nom de chacun d'eux.
  • Naviguez à travers les répertoires, ceux-ci sont identifiés par l'icône . Vous pouvez également créer des sous-répertoires dans ceux-ci.
  • Téléchargez des fichiers en cliquant sur l'icône , ces fichiers image seront identifiés par l'icône Fichier (seuls les formats SVG, GIF, PNG et JPG sont autorisés).
  • Vous pouvez également supprimer certains fichiers qui ont l'icône , car les autres sont des fichiers système utilisés par la console PFMS.
  • Un répertoire ne peut être supprimé que s'il est vide.
  • Si vous souhaitez personnaliser les images dans les consoles visuelles, quatre images différentes sont nécessaires, une pour chaque état, en utilisant une nomenclature spéciale pour ces images :
<image_name>_<state>.png

Où chaque état peut être :

  • <image_name>_bad.png critique.
  • <image_name>_ok.png normal.
  • <image_name>_warning.png avertissement.
  • <image_name>.png inconnu.

Pour chaque élément listé, un bouton est disponible, il affiche son chemin exact dans une fenêtre contextuelle.
Si l'élément se trouve dans un sous-répertoire, vous pouvez revenir rapidement au début en cliquant à nouveau sur l'élément de menu File manager.

Importer depuis MINI

Menu Management → Admin tools → Import from MINI.

Pandora MINI est une application de bureau pour MS Windows® et Linux® qui permet de réaliser des vérifications réseau, des analyses et des diagnostics de base sans dépendre de serveurs ni de configurations complexes.

Lorsque son utilisation a atteint son maximum, presque tous ses composants peuvent être exportés et ajoutés à Pandora FMS dans un fichier au format JSON et à l'extension .mini.

Dans ce résumé des agents et modules importés, vous pouvez cliquer sur chacun d'eux, et il s'ouvrira dans une nouvelle fenêtre du navigateur. En cas de problème pendant ce processus, un icône sera affiché, et en cliquant dessus, vous obtiendrez plus de détails.

L'importation d'éléments depuis Pandora MINI est également une des options de l'Assistant Général (menu Management → Configuration → General wizard → Task to perform).

Vérification du schéma DB

Menu Management → Admin tools → DB Schema Check.

C'est une extension qui permet de vérifier les différences structurelles entre la base de données Pandora FMS établie et un schéma de modèle pour comparer d'éventuelles erreurs.

Interface DB

Menu Management → Admin tools → DB Interface.

Permet d'exécuter des commandes directement sur la base de données et de voir les résultats. C'est un outil avancé qui ne doit être utilisé que par des personnes connaissant SQL et le schéma de base de données de Pandora FMS en détail.

Gestionnaire de sauvegarde DB

Menu Management → Admin tools → DB Backup Manager.

Permet de gérer les sauvegardes de la base de données, programmées et effectuées via une tâche de console.

  • Dans la section Filters, vous pouvez choisir dans la liste déroulante Path backups l'emplacement des sauvegardes disponibles. Cliquez sur le bouton Search pour mettre à jour la liste des sauvegardes.
  • Vous pouvez télécharger les sauvegardes sur votre machine locale en cliquant sur le bouton correspondant.
  • Vous pouvez supprimer les sauvegardes en cliquant sur le bouton correspondant.
  • Pour restaurer une sauvegarde, cliquez sur le bouton correspondant.

Configuration de la console acoustique

Menu Management → Admin tools → Acoustic console setup.

Permet de configurer les nouveaux sons par défaut pour les différentes alertes d'événements.

Vérificateur d'API

Menu Management → Admin tools → API checker.

Le Vérificateur d'API permet de vérifier l'API externe de Pandora FMS version 1.0.
Consultez la section API externe.

Gestionnaire d'extensions

Menu Management → Admin tools → Extension manager.

Contient deux options importantes : pour maintenir les extensions enregistrées et pour installer de nouvelles extensions.

Vue du gestionnaire d'extensions

Menu Management → Admin tools → Extension manager → Extension manager view.

Les extensions sont un moyen de développer de nouvelles fonctionnalités pour la console Web de Pandora FMS, ainsi que des plugins. Consultez le sujet “Développement d'extensions de la console” pour plus d'informations.

Remarque : La gestion des extensions visibles ajoute ou supprime des éléments dans le menu latéral gauche de la console Web.

Pour chaque extension listée, il est possible de la désactiver en cliquant sur l'icône correspondant à chaque extension. Une fois désactivée, elle sera déplacée à la fin de la liste.
Il est également possible de supprimer une extension avec le bouton correspondant.

Certaines extensions sont essentielles pour la console PFMS. L'Extension uploader est une extension pour installer de nouvelles extensions, donc la supprimer supprimera cette fonctionnalité.

Téléchargeur d'extensions

Menu Management → Admin tools → Extension manager → Extension uploader.

Permet de télécharger (et d'installer) une extension. Le fichier à télécharger doit être compressé au format .zip.

Si l'extension utilise le composant gpolicies, il faut cocher l'option Upload Enterprise extension. Une fois le fichier sélectionné, cliquez sur le bouton Upload pour terminer le processus. La nouvelle extension sera affichée dans la Extension manager view.

Fichiers journaux système

Menu Management → Admin tools → Extension manager → System logfiles.

Dans cette section, vous pouvez afficher, limité par la taille du token Log size limit in system logs viewer extension, le contenu des fichiers suivants :

/var/www/html/pandora_console/log/console.log
/var/log/pandora/pandora_server.log
/var/log/pandora/pandora_server.error

Importer des groupes avec un fichier CSV

Menu Management → Admin tools → Extension manager → Import groups with CSV file.

Consultez la section Importer des groupes depuis CSV dans le sujet « Gestion et administration de la console ».

Ressources

Menu Management → Resources.

Systèmes d'exploitation

Menu Management → Resources → Operating systems.

Dans cette section, vous pouvez modifier ou créer de nouveaux types de systèmes d'exploitation (SO). Ces groupes sont importants pour le provisionnement automatique des agents.

Si vous avez un nouveau système d'exploitation, vous pouvez l'ajouter à la liste par défaut lors de l'installation de PFMS. Pour ce faire, cliquez sur le bouton Create OS, entrez le nom approprié et choisissez une icône dans la liste. Si vous avez une nouvelle icône au format JPG, JPEG, PNG ou SVG, utilisez le bouton Upload icon, enregistrez-la dans PFMS, puis recherchez-la par son nom.

Terminez le processus de création d'un SO en cliquant sur le bouton Create.

À partir de la version 774, PFMS a activé la fonctionnalité d'obsolescence programmée, qui fonctionne avec l'inventaire pour générer des rapports avec des filtres pour les dispositifs surveillés.

Outils

Menu Management → Tools.

Exporter des données

Menu Management → Tools → Export data.

Permet de choisir un agent (qui peut être filtré par groupe) par son nom, puis de sélectionner un ou plusieurs modules de celui-ci.

Par défaut, la période de temps est de 24 heures et les formats d'exportation disponibles sont :

  • Data Table: Un format spécial du langage PHP qui affiche sur l'écran le nom de l'agent, le nom du module, la valeur des données et la date et l'heure de la collecte des données.
  • Average per hour/day: Si les données sont numériques et susceptibles d'être moyennées, elles seront affichées de manière similaire à l'option Data table.
  • CSV: Format de fichier avec des champs séparés par des virgules.
  • MS Excel: Format de fichier de feuille de calcul pour Microsoft Excel®.

Dépôt de fichiers

Menu Management → Tools → File repository.

Le gestionnaire de dépôt de fichiers permet de placer les ressources nécessaires pour les dispositifs à surveiller quand cela est jugé approprié.

Dans l'onglet Management view, sélectionnez le groupe ou les groupes qui téléchargeront cette ressource et explorez votre stockage local pour télécharger le fichier. Si vous avez besoin que cette ressource soit publique (uniquement pour ceux qui connaissent le lien), cochez la case Public link. Un maximum de 200 caractères peut être ajouté dans la description.

Le jeton Attachment directory définit son chemin d'accès.

Cliquez sur le bouton Add et attendez la fin du processus de téléchargement. Dans l'onglet Operation view, pour chaque élément listé :

  • Pour partager le lien public de chaque fichier, cliquez sur l'icône pour copier le lien web.
  • Si un autre opérateur de la même console PFMS est sur une machine différente, il pourra télécharger une ressource en cliquant sur le bouton .
  • Si le fichier n'est plus nécessaire, il peut être supprimé avec le bouton respectif.

← Retour à l'index de la documentation de Pandora FMS