Sur cette page

Integration avec GLPI

Cette integration transforme les changements de statut des moniteurs Mugnsoft en tickets GLPI. Lorsqu’un moniteur tombe en erreur, l’Integrator ouvre un ticket ; lorsque le moniteur se retablit, le meme ticket est resolu automatiquement.

Resultat : votre centre de services voit les pannes Mugnsoft comme des tickets a part entiere, sans creation ni cloture manuelle de tickets.

Note :

Cette integration se configure sur le composant Integrator, aux cotes des autres destinations push. Elle utilise l’API REST de GLPI en HTTPS ; aucun plugin GLPI n’est requis.

Nous supposons qu’aucune regle de pare-feu n’empeche l’Integrator Mugnsoft de joindre votre instance GLPI, et que vous disposez d’un utilisateur d’integration autorise a creer et mettre a jour des tickets.

Fonctionnement

L’Integrator ne reagit qu’a un changement de statut confirme :

  • Panne (le moniteur passe a un statut non-OK) : un nouveau ticket est cree avec un titre, le detail du moniteur dans le contenu, et urgency/impact derives de la severite.
  • Retablissement (le moniteur revient a OK) : le ticket ouvert est retrouve puis bascule vers son statut resolu.

GLPI ne dispose pas de champ de correlation natif ; chaque ticket porte donc une cle embarquee dans son titre (construite a partir du type de moniteur, du nom et de la sonde). Le ticket ouvert est retrouve via l’API de recherche GLPI sur cette cle. La recherche etant cote serveur, la resolution fonctionne meme apres un redemarrage de l’Integrator, et les controles non-OK repetes n’ouvrent jamais de doublons.

Statut Mugnsoft urgency / impact GLPI
CRITICAL / ERROR 5 (tres eleve)
MAJOR 4 (eleve)
MINOR 3 (moyen)

GLPI derive la priorite du ticket de la matrice urgency × impact.

Acquittement et prise en charge du ticket

Mugnsoft ne dispose pas de notion d’acquittement — l’alerting repose uniquement sur le statut. Pour eviter que la resolution automatique ne cloture un ticket que votre equipe traite activement, l’integration utilise le statut du ticket GLPI comme signal d’acquittement :

  • Si, au retablissement, le ticket est toujours Nouveau, il est resolu automatiquement.
  • Si un humain l’a pris en charge (attribue, en cours ou en attente), le ticket est laisse ouvert et un suivi de retablissement est ajoute a la place — la cloture reste a la main de l’operateur.

Desactivez Auto-resolve pour supprimer toute cloture automatique (un suivi de retablissement est toujours ajoute).

Amortissement des flaps (grace period)

L’alerting reposant sur le statut et ne disposant d’aucun amortissement propre, un moniteur instable pourrait ouvrir et resoudre une serie de tickets. La grace period retarde l’ouverture d’un ticket apres une panne : si le moniteur se retablit dans la fenetre, le flap est supprime et aucun ticket n’est cree. Une panne reellement durable ouvre quand meme un ticket une fois la fenetre ecoulee. Mettez 0 (defaut) pour une ouverture immediate.

Preparer GLPI

  1. Dans Configuration > Generale > API, activez l’API REST et notez la base de l’API (le point d’entree apirest.php est joint via l’hote de votre instance).
  2. Creez (ou choisissez) un client API. Si le client est configure pour exiger un App-Token, copiez-le — vous le collerez dans l’Integrator. Si aucun App-Token n’est requis, vous pouvez laisser ce champ vide.
  3. Creez (ou choisissez) un utilisateur d’integration avec un profil autorisant la creation et la mise a jour de tickets (par exemple Technicien).

Configurer l’Integrator

  1. Accedez aux reglages du composant Integrator et ouvrez le panneau des services externes.
  2. Selectionnez la tuile GLPI et activez-la.
Configuration de l'integration GLPI sur l'Integrator
  1. Renseignez les champs de connexion :
Champ Valeur
IP/FQDN Hote de l’instance GLPI (ex. glpi.example.com)
Port 443
SSL active
Utilisateur l’utilisateur d’integration
Mot de passe le mot de passe de l’utilisateur d’integration
App-Token l’App-Token du client API (laisser vide si le client n’en a pas)
Solved status statut du ticket a la resolution automatique (defaut 5 = Resolu ; 6 = Clos)
Auto-resolve active (defaut). Si un humain a pris en charge le ticket, il est laisse ouvert et un suivi de retablissement est ajoute au lieu de le cloturer
Grace period (s) delai d’amortissement avant ouverture a la panne ; un retablissement dans la fenetre ne cree aucun ticket (defaut 0 = immediat)
  1. Cliquez sur le bouton test pour verifier la connectivite et les identifiants, puis enregistrez.

Verifier

  1. Provoquez une panne de moniteur (par exemple, executez un moniteur URL vers une cible injoignable). Un nouveau ticket doit apparaitre dans GLPI avec le nom du moniteur et une cle embarquee dans le titre.
  2. Retablissez la cible pour que le moniteur revienne a OK. Le meme ticket doit basculer vers son statut resolu — sans doublon, et sans second ticket lors des controles OK suivants.

See also

Traductions

Integration avec Jira