Integration avec Jira

Cette integration transforme les changements de statut des moniteurs Mugnsoft en demandes Jira. Lorsqu’un moniteur tombe en erreur, l’Integrator ouvre une demande ; lorsque le moniteur se retablit, la meme demande est resolue automatiquement.

Resultat : votre equipe voit les pannes Mugnsoft comme des demandes Jira a part entiere, sans creation ni cloture manuelle.

Note :

Cette integration se configure sur le composant Integrator, aux cotes des autres destinations push. Elle cible Jira Cloud (API REST v3) en HTTPS ; aucune application Jira n’est requise.

Nous supposons qu’aucune regle de pare-feu n’empeche l’Integrator Mugnsoft de joindre votre site Jira, et que vous disposez d’un compte autorise a creer et transitionner des demandes dans le projet cible.

Fonctionnement

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

Panne (le moniteur passe a un statut non-OK) : une nouvelle demande est creee avec un resume, le detail du moniteur dans la description, une priority derivee de la severite, et un label de deduplication.
Retablissement (le moniteur revient a OK) : la demande ouverte est retrouvee puis passee par la transition de resolution configuree.

Jira ne dispose pas de champ de correlation ; chaque demande porte donc un label normalise mugnsoft-<type>-<nom>-<sonde> et la demande ouverte est retrouvee via une requete JQL exacte (labels = "<cle>" AND statusCategory != Done). 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.

Jira ne permet pas non plus de fixer un statut directement : la resolution est une transition de workflow, retrouvee par son nom (defaut Done) parmi les transitions disponibles de la demande, puis appliquee.

Statut Mugnsoft	priorite Jira
`CRITICAL` / `ERROR`	`Highest`
`MAJOR`	`High`
`MINOR`	`Medium`

Les noms de priorite sont definis par l’instance ; ceux ci-dessus sont les valeurs par defaut de Jira.

Acquittement et prise en charge de la demande

Mugnsoft ne dispose pas de notion d’acquittement — l’alerting repose uniquement sur le statut. Pour eviter que la resolution automatique ne cloture une demande que votre equipe traite activement, l’integration utilise l'assignation et le statut Jira comme signal d’acquittement :

Si, au retablissement, la demande est toujours non attribuee et dans la categorie de statut A faire, elle est resolue automatiquement.
Si un humain l’a prise en charge (attribuee, ou passee En cours), la demande est laissee ouverte et un commentaire de retablissement est ajoute a la place — la cloture reste a la main de l’operateur.

Desactivez Auto-resolve pour supprimer toute transition automatique (un commentaire 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 demandes. La grace period retarde l’ouverture d’une demande apres une panne : si le moniteur se retablit dans la fenetre, le flap est supprime et aucune demande n’est creee. Une panne reellement durable ouvre quand meme une demande une fois la fenetre ecoulee. Mettez 0 (defaut) pour une ouverture immediate.

Preparer Jira

Creez un jeton d’API sur id.atlassian.com > Securite > Jetons d’API. Le jeton sert de mot de passe ; l’email de votre compte est l’utilisateur.
Choisissez la cle de projet (par exemple OPS) ou les demandes doivent etre creees, et verifiez que le compte peut y creer et transitionner des demandes.
Notez le nom de la transition de resolution dans le workflow de ce projet (defaut Done). Elle doit correspondre a une transition disponible sur la demande lorsqu’elle est ouverte.

Configurer l’Integrator

Accedez aux reglages du composant Integrator et ouvrez le panneau des services externes.
Selectionnez la tuile Jira et activez-la.

Configuration de l'integration Jira sur l'Integrator

Renseignez les champs de connexion :

Champ	Valeur
IP/FQDN	Hote Jira Cloud (ex. `your-domain.atlassian.net`)
Port	`443`
SSL	active
User (email)	l’email du compte
API token	le jeton d’API du compte
Project key	la cle du projet cible (ex. `OPS`)
Issue type	type de demande pour les demandes creees (defaut `Bug`)
Resolve transition	transition utilisee pour la resolution automatique (defaut `Done`)
Auto-resolve	active (defaut). Si un humain a pris en charge la demande, elle est laissee ouverte et un commentaire de retablissement est ajoute au lieu de la transitionner
Grace period (s)	delai d’amortissement avant ouverture a la panne ; un retablissement dans la fenetre ne cree aucune demande (defaut `0` = immediat)

Cliquez sur le bouton test pour verifier la connectivite et les identifiants, puis enregistrez.

Verifier

Provoquez une panne de moniteur (par exemple, executez un moniteur URL vers une cible injoignable). Une nouvelle demande doit apparaitre dans le projet avec le nom du moniteur dans le resume et un label mugnsoft-….
Retablissez la cible pour que le moniteur revienne a OK. La meme demande doit passer par la transition de resolution — sans doublon, et sans seconde demande lors des controles OK suivants.