Événements

Le système d'événements Pandora FMS vous permet de voir un enregistrement en temps réel de tous les événements qui se produisent dans les systèmes supervisés. Par défaut, dans la vue des événements, vous verrez un instantané de ce qui se passe à ce moment-là.

Les événements sont classés selon leur gravité :

• 0 Maintenance (blanc/gris).
• 1 Informatif (bleu).
• 2 Normal (vert).
• 3 Avertissement (jaune).
• 4 Critique (rouge).
• 5 Minoritaire (rose).
• 6 Majoritaire (brun).

Les actions suivantes peuvent être effectuées sur les événements :

• Modifier l'état (validé ou en cours).
• Changer de propriétaire.
• Éliminer.
• Afficher des informations supplémentaires.
• Ajouter un commentaire.
• Créer des réponses personnalisables.

Les événements sont gérés dans le menu Opérations → Événements → Afficher les événements.

L'observateur d'événements affiche un résumé de chaque événement et parfois d'autres données associées, telles que le module agent qui a généré l'événement, le groupe, les balises associées au module, etc. Vous pouvez également trier les événements par identifiant, état, nom, entre autres champs.

En cliquant sur l'icône en forme de loupe pour chaque élément, vous obtiendrez plus de détails.

Les événements sont présentés par recherche par défaut des huit dernières heures et qui ne sont pas validés (et peuvent également être personnalisés), en plus d'un regroupement pour éviter les redondances. Vous pouvez enregistrer les recherches sous forme de filtres ou appliquer un filtre préalablement créé.

Un événement peut être dans quatre états :

• En procès.
• Nouveau.
• Pas validé.
• Validé.

Auto-validation

Lorsque des événements surviennent du fait de changements d'état dans des modules, il y aura généralement deux événements : un premier événement de passage d'un état normal à un autre état « incorrect », et un événement de retour à un état normal, une fois la situation problématique résolue. Dans ces cas, les événements passés dans un état incorrect (critique ou avertissement) sont automatiquement validés lorsqu'ils reviennent à la normale. C'est ce qu'on appelle l'auto-validation d'événement et c'est une fonctionnalité extrêmement pratique.

Validation manuelle

En travaillant manuellement, un événement peut également être validé : le système mémorisera la date et l'utilisateur qui a validé l'événement, avec la possibilité d'enregistrer un commentaire sur la situation, puis l'écran sera rafraîchi et l'événement validé deviendra invisible.

En procès

Un événement peut être marqué « en cours » dans l'onglet Réponses. De cette façon, l'événement ne sera pas auto-validé et restera en attente.

Processus individuels ou par lots

Les événements peuvent être validés, marqués comme « en cours » ou supprimés individuellement en cliquant sur les icônes correspondantes ou appliqués en masse à une sélection.

Aspects importants de cette fonctionnalité :

• Les filtres peuvent être enregistrés pour être réutilisés une autre fois.
• L'ancienneté maximale (Max. hours old) des événements peut être personnalisée.
• Pandora FMS, par défaut, regroupe les événements répétés (Dupliquer → Grouper les événements), cependant cette préférence peut être modifiée :
  • Tous les événements : affiche tous les événements individuellement.
  • Grouper les agents : regrouper les événements par agent.
  • Événements de groupe : le nom de l'événement, l'ID de l'agent et l'ID du module sont utilisés pour identifier les doublons.
  • Identifiants supplémentaires de groupe : les événements seront regroupés uniquement par Extra ID, classé par Timestamp.
• Vous pouvez filtrer par groupe spécifique. Si vous utilisez l'option Récursion de groupe, elle recherchera également les sous-groupes de ce groupe. De même, si vous sélectionnez Rechercher dans les groupes secondaires, les événements des agents auxquels des groupes secondaires sont attribués seront inclus. Ces deux dernières options peuvent avoir un impact sur le travail sur le serveur PFMS.

Options avancées

• Vous pouvez demander des événements qui se sont produits dans une période donnée en utilisant les champs de date Du (date) et Au (date).
• Dans le champ Free search, vous pouvez utiliser une expression régulière (par exemple, pour rechercher « Connexions » et « Réseau », vous saisissez « (Connexions|Réseau) »). La recherche est effectuée par nom d'agent, nom d'événement, ID supplémentaire, source, données personnalisées et commentaires.
• Vous pouvez filtrer par champs personnalisés à l'aide des champs Filtre de données personnalisé, soit en filtrant le nom du champ (Filtrer les données personnalisées par nom de champ), soit par le contenu du champ personnalisé (Filtrer les données personnalisées données par valeur de champ). Ces champs seront affichés sous forme de colonnes dans la vue des événements.

Les filtres d'événements considérés comme plus fréquemment utilisés peuvent être ajoutés à la section Événements du menu Favoris (menu Opération). Ceci est réalisé en cliquant sur l'icône étoile qui apparaîtra lors du chargement d'un filtre enregistré (Filtre actuel). Un nouveau clic vous permettra de décocher l'icône et de la supprimer du favorite system.

Les événements peuvent être supprimés individuellement (manuellement) et/ou automatiquement : dans le menu Gestion → Setup → Setup → Max. jours avant la suppression des événements, la période à conserver est spécifiée en jours.

Activer Activer l'historique des événements dans Gestion → Configuration → Configuration → Base de données historique, il est possible de les conserver dans le but de créer des rapports spéciaux.

Pour voir les événements sur une chaîne d'information, accédez à Opération → Événements → RSS et avec ce lien, abonnez-vous depuis le lecteur d'actualités de votre choix.

Il permet de diffuser les différentes alertes sonores lorsqu'un événement survient. La mélodie sera entendue en continu jusqu'à ce que vous mettiez l'événement sonore en pause ou que vous appuyiez sur le bouton OK.

Liste des événements qui génèrent du son, par défaut (et personnalisables) :

• Le déclenchement de toute alerte.
• La transition d'un module vers l'état avertissement.
• Le passage d'un module à l'état critique.
• La transition d'un module vers le statut inconnu.

Accédez à l'option Opération → Événements → Console acoustique. Cette action ouvre une fenêtre contextuelle contrôlant tous les événements sonores. Vous devez configurer votre navigateur Web pour autoriser l'ouverture des fenêtres contextuelles.

Les événements sonores sont analysés toutes les 10 secondes de manière asynchrone, lorsqu'un événement se produit, la fenêtre commencera à clignoter en rouge et à vibrer et également, selon la configuration de votre navigateur et/ou système d'exploitation, la fenêtre conservera le focus et sera positionnée en devant le reste des fenêtres ouvertes.

Pour ajouter de nouvelles mélodies, copiez ces fichiers au format WAV, dans le répertoire :

/var/www/pandora_console/include/sounds/

Pour exporter les événements au format CSV, appuyez sur Opération → Événements → Afficher les événements → Exporter vers un fichier CSV.

La API externe Pandora FMS est utilisé en effectuant des appels à distance (via HTTPS) vers le fichier /include/api.php. C'est la méthode qui a été définie dans Pandora FMS pour intégrer des applications tierces à Pandora FMS. Fondamentalement, il s'agit d'un appel avec les paramètres formatés pour recevoir une valeur ou une liste de valeurs que l'application utilisera ensuite pour effectuer des opérations.

Les trois points principaux pour activer l’API PFMS :

1. Activez l'accès à l'IP à partir de laquelle vous exécuterez la commande.
2. Définissez un mot de passe général pour l'API.
3. Définissez un utilisateur spécifique avec son mot de passe qui ne peut se connecter que via API.

L'outil dédié à la création ou à la validation d'événements via l'API Pandora FMS peut être copié depuis :

/usr/share/pandora_server/util/pandora_revent.pl

Les options pour valider un événement sont :

./pandora_revent.pl -p <chemin_vers_consoleAPI> -u <informations d'identification> -validate_event <options> -id <event_id>

Dans certaines occasions, peut-être pour des raisons de sécurité, vous devez uniquement avoir la possibilité de créer des événements, pour cela vous pouvez copier « pandora_revent_create.pl » sur l'appareil client. Il est situé à :

/usr/share/pandora_server/util/pandora_revent_create.pl

Cet outil partage des caractéristiques similaires avec pandora_revent.pl.

Les événements avec des champs personnalisés peuvent être générés via la Pandora FMS CLI. Exemple:

perl pandora_manage.pl \
              /etc/pandora/pandora_server.conf \
              --create_event 'Événement personnalisé' Pare-feu système \
              'localhost' 'module' 0 4 '' 'admin' '' '' '' '' \
              '{"Emplacement": "Bureau", "Priorité": 42}'

Grâce à Gestion → Configuration → Événements, il est possible de configurer :

• Colonnes personnalisées.
• Réponses.
• Paramètres de filtre.

Il est possible de personnaliser les champs que l'observateur d'événements affiche par défaut ; Pour cela, depuis Événements → Voir les événements, cliquez sur Gérer les événements → Colonnes personnalisées et choisissez les champs à afficher.

Les champs affichés par défaut sont au nombre de cinq, mais il y a d'autres champs à ajouter :

Menu Gestion → Configuration → Événements → Filtres d'événements.

Vous permet de créer, supprimer et modifier les filtres appliqués à la vue des événements. Après avoir enregistré, vous pouvez accéder à Afficher les événements et charger le filtre approprié.

Une réponse à un événement est une action personnalisée qui peut être exécutée sur un événement, telle que la création d'un ticket Pandora ITSM avec les informations pertinentes sur l'événement. Vous pouvez obtenir plus d'informations sur Pandora ITSM dans la documentation de Pandora FMS.

Entrez un nom de représentant, une description, les paramètres à utiliser séparés par des virgules, la commande à utiliser (cette dernière permet l'utilisation de macros), le type et le serveur qui exécutera la commande. Dans les Parameters, vous pouvez en saisir autant que vous le souhaitez, en les séparant par des virgules. Lors de la réponse, une boîte de dialogue apparaîtra pour remplir chacun d'entre eux et l'ajouter ainsi à l'événement.

Les macros acceptées sont les suivantes :

Adresse de l'agent.

Alias de l'agent.

Identifiant de l'agent.

Nom de l'agent.

Identifiant de l'alerte associée à l'événement

Temps de réponse de la commande (secondes).

Identifiant de l'utilisateur qui exécute la réponse.

Nom complet de l'utilisateur qui exécute la réponse.

Extrait les informations des données personnalisées au format JSON.

Sortir toutes les données personnalisées en mode texte (avec des sauts de ligne).

Extrait un champ particulier des données personnalisées, en remplaçant le X par le nom du champ.

Date dans laquelle s'est produit l'événement.

Identifiant extra.

Identifiant de l'événement.

Instructions de l'événement.

Identifiant de la criticité de l'événement.

Criticité de l'événement (traduit par la console Pandora FMS).

Source de l'événement.

État de l'événement (Nouveau, validé ou événement en processus).

Étiquettes de l'événement séparées par des virgules.

Texte complet de l'événement.

Type d'événement (Système, Changeant à l'état inconnu…).

Date dans laquelle s'est produit l'événement sous format utimestamp.

Identifiant du groupe.

Nom du groupe dans la base de données.

Informations de contact pour un groupe d'agents.

Adresse du module associé à l'événement.

Identificant du module associé à l'événement.

Nom du module associé à l'événement.

Pour Command Center (Metaconsole) et Node: renvoie l'identifiant du nœud.

Pour Command Center (Metaconsole) et Node: renvoie le nom du nœud.

Utilisateur proprietaire de l'événement.

Nom complet de l'utilisateur proprietaire de l'événement.

Identifiant de l'utilisateur.

Retour à l'index de documentation du Pandora FMS