Grafana et son intégration avec Pandora FMS

Grafana est une plateforme open source pour la visualisation et la supervision des données en temps réel L’une de ses fonctions est la création de panneaux interactifs et personnalisables qui facilitent l’analyse des métriques provenant de diverses sources, telles que les bases de données, les systèmes de supervision et les plates-formes cloud.

Sa flexibilité et sa compatibilité avec plusieurs fournisseurs de données en font un outil essentiel pour l’observabilité et la prise de décision dans les environnements informatiques.

Quels avantages offre-t-il pour votre infrastructure ?

• Supervision en temps réel des métriques et des journaux.
• Prise en charge de plusieurs sources de données, telles que Prometheus, InfluxDB, MySQL, AWS CloudWatch, etc.
• Alertes et notifications personnalisables pour une réponse proactive.
• Interface intuitive et hautement personnalisable pour une analyse visuelle efficace.
• Évolutivité et extensibilité grâce à des plugins et des tableaux personnalisés.

Grafana est idéal pour les organisations qui cherchent à améliorer la visibilité de leurs systèmes, à optimiser la supervision et à faciliter la prise de décision basée sur les données.

Intégration de Grafana et Pandora FMS

Grafana dispose d’une intégration dans Pandora FMS, qui permet d’unifier les deux plates-formes de supervision. Pour pouvoir utiliser cette intégration, seules quelques conditions préalables minimales sont nécessaires :

• Extension API chargée sur Pandora.
• Accès depuis Grafana à la machine Pandora à partir de laquelle vous allez recevoir les données et qui a chargé l’extension API.
• Activer l’ID du plugin dans le fichier de configuration de Grafana.

Ces configurations peuvent être effectuées rapidement en suivant les étapes suivantes :

1. Ajouter l’extension Pandora FMS

La première chose à faire est de charger dans notre console Pandora FMS l’extension qui nous permettra d’obtenir les données à représenter dans les tableaux de bord Grafana.
Pour ce faire, il vous suffit de télécharger le pack zip que vous trouverez dans notre librairie et de le télécharger sur la console Pandora FMS depuis le menu : Admin tools > Extension manager > Extension uploader:

Il est important de ne pas cocher l’option «Upload enterprise extension ».

En bref, ce que nous faisons est de localiser le contenu du fichier zip dans le répertoire des extensions de la console Pandora FMS, ce qui entraînera la création du répertoire :
/var/www/html/pandora_console/extensions/grafana

Si, comme dans notre cas, l’installation part d’une ISO de Pandora FMS, il faudra également modifier un paramètre de la configuration du serveur Apache.

Il suffit d’éditer le fichier /etc/httpd/conf/httpd.conf, et d’entrer le paramètre « AllowOverride none » comme « AllowOverride All », dans les directives du bloc «» car c’est là que se trouve la console Pandora FMS. Il faudrait donc que ça se passe comme suit :

Nous ajouterons également un paramètre dans la configuration de PHP. Ajoutez la ligne suivante à la fin du fichier /etc/php.ini: serialize_precision = -1

Et pour que ces changements prennent effet, redémarrez le service Apache :

2. Charger le plugin Pandora FMS pour Grafana

Télécharger le fichier ZIP avec tous les fichiers du plugin sur le serveur de Grafana et le placer dans le chemin «/var/lib/grafana/plugins ». Décompressez le fichier dans ce chemin avec la commande « unzip » et redémarrez le service de Grafana pour le charger :

3. Configurer Pandora FMS comme source de données pour les tableaux de bord Grafana

Ajouter les lignes suivantes à la fin du fichier de configuration de Grafana (/etc/grafana/grafana.ini) :

Après ce changement, le service de Grafana doit être redémarré à l’aide de la commande suivante : service grafana-server restart

À ce stade, configurez le plugin téléchargé dans Grafana pour qu’il se connecte à l’extension chargée dans Pandora FMS et vous permette d’utiliser vos données dans les tableaux de bord de Grafana.
Accédez dans Grafana au menu « Configuration > Datasources » et cliquez sur le bouton « Add datasource » : “Add datasource”:

Différents plugins que vous pouvez configurer apparaîtront, et au bas de la liste, vous verrez le plugin que vous venez de télécharger pour Pandora FMS. Cliquez dessus :

Cela vous mènera à un formulaire où vous n’aurez qu’à remplir 3 champs pour la connexion avec l’extension Pandora FMS :

• URL de l’extension, qui selon la suggestion que nous verrons sera (par défaut) « http://x.x.x.x/pandora_console/extensions/grafana », « x.x.x.x » étant l’adresse IP ou le nom DNS de votre console Pandora FMS.
• Utilisateur de Pandora FMS, qui vous permettra d’obtenir les données pour les tableaux de bord de Grafana. Cet utilisateur doit avoir au moins des autorisations de lecture des agents (AR) et ne peut obtenir les données que des agents sur lesquels il a des autorisations.
• Mot de passe de l’utilisateur Pandora FMS.

Avec ces champs remplis, vous pourrez cliquer sur le bouton « Save & Test » pour vérifier le fonctionnement de votre nouvelle source de données :

Que se passe-t-il si cela ne fonctionne pas correctement ?

Dans la configuration, vous pourriez voir de différentes erreurs, telles que :

• HTTP Error Bad Gateway → Si Grafana ne peut pas se connecter à Pandora FMS ou si l’adresse IP indiquée est incorrecte.
• HTTP Error Not Found → Si l’URL indiquée n’est pas correcte, par exemple parce que l’extension Pandora FMS n’a pas été chargée correctement ou simplement à cause d’une erreur lors de la saisie de l’URL dans le formulaire.
• Datasource connection error : Unauthorized → Si l’utilisateur et/ou le mot de passe indiqués n’étaient pas corrects ou si l’utilisateur n’avait pas les autorisations minimales de lecture des agents (AR).

Créez votre premier tableau de bord sur Grafana

Tout d’abord, veuillez vous rendre au menu « Create > Dashboard », et dans le panneau qui apparaîtra, cliquez sur le bouton « Add visualization »:

Cela vous mènera à un formulaire où, dans le menu déroulant « Query », vous choisirez votre source de données « Pandora FMS ». Cela fera basculer la partie inférieure du formulaire et vous verrez une requête pour choisir un module à partir duquel afficher les données dans le tableau de bord :

• Label : Cela vous permettra d’indiquer l’étiquette que vous voulez que les données soient représentées pour cette requête.
• Group : Utilisez-le pour filtrer l’agent dont les données doivent être représentées. Il est nécessaire d’indiquer un groupe.
• Agent : Utilisez-le pour filtrer l’agent dont les données doivent être représentées. Il est nécessaire d’indiquer un agent.
• Module : Utilisez-le pour filtrer le module dont les données doivent être représentées.
• TIP : Il s’agit d’un champ qui vous permettra d’indiquer si les données à représenter seront compactées ou non. Si elle n’est pas cochée, les données seront compactées, ce qui se traduira par des graphiques plus faciles à interpréter et plus rapides à charger, bien que l’échantillon de données ne sera pas le réel mais plutôt une moyenne de celui-ci.

Et avec cela, nous aurions déjà nos premières données Pandora FMS sur Grafana.

Vous pouvez inclure plus d’une requête dans un même tableau de bord, ce qui vous permet de comparer les données de différents modules :

Et vous pouvez également ajouter plus de panneaux dans un même tableau de bord Grafana, de sorte que vous avez toutes les informations nécessaires sur un seul écran.

Créez votre première alarme sur Grafana

Vous pouvez créer une alerte depuis le menu « Alerte » , dans l’affichage du tableau de bord (une fois le tableau de bord enregistré).

Dans ce menu, vous devrez ajuster quelques règles, pour configurer votre alerte :
1 . Définir le nom de la règle d’alerte.

2. Définir la requête et la condition d’alerte.

3. Définir le comportement d’évaluation des alertes.

4. Ajouter des annotations.

5. Configurer les notifications.

Una vez configurada y guardada la alerta, podremos verla en el dashboard: