Jira

Vue d’ensemble

L’intégration Jira ouvre un ticket dans votre projet lorsqu’un monitor tombe en panne. Disponible sur le plan Enterprise.

Note

Seule une transition DOWN crée un ticket — up, dégradé et pause ne font délibérément rien, pour qu’un monitor qui flappe ou se rétablit ne spamme pas le projet. La résolution/fermeture du ticket est laissée à votre propre workflow. Pour de l’alerting d’astreinte (création + résolution auto), utilisez plutôt Jira Service Management.

Configuration

1. Créez un jeton d’API sur id.atlassian.com → jetons d’API.
2. Notez la clé du projet (ex. OPS) et le type de ticket souhaité (ex. Task, Bug).
3. Dans OKStatus, allez dans Alerting → Canaux → Ajouter un canal → Jira.
4. Renseignez :
   • URL de base — https://votre-equipe.atlassian.net
   • Email du compte — le compte Atlassian du jeton
   • Jeton d’API
   • Clé du projet
   • Type de ticket (optionnel, Task par défaut)
   • Réutiliser et résoudre automatiquement un ticket (case optionnelle — voir ci-dessous)
5. Cliquez sur Tester, puis attachez le canal à vos monitors.

Réutiliser et résoudre automatiquement un ticket

Par défaut, le canal ouvre un nouveau ticket à chaque panne d’un monitor — ce qui, pour un monitor qui flappe (panne/rétablissement répétés), peut inonder votre board. Activez Réutiliser et résoudre automatiquement un ticket pour garder à la place un seul ticket par monitor qui suit son état :

• Panne → ouvre un ticket (ou, s’il en existe déjà un, le rouvre/commente).
• Rétablissement → fait passer ce ticket dans un statut Done.
• Nouvelle panne → rouvre le même ticket au lieu d’en créer un nouveau.

Un monitor qui flappe 30 fois produit donc un seul ticket avec 30 changements de statut, pas 30 tickets.

Comment ça marche, et pourquoi c’est robuste :

• Le ticket est retrouvé à chaque fois par un label propre au monitor (OKStatus ne stocke jamais la clé du ticket) : le comportement est sans état.
• Les transitions sont détectées automatiquement dans le workflow de votre projet (choix d’une transition dont la catégorie de statut cible est Done pour résoudre, ou non-Done pour rouvrir) — aucun nom de statut à configurer, fonctionne avec les workflows personnalisés.
• Si un admin supprime complètement le ticket, la panne suivante en crée simplement un nouveau (la recherche par label ne trouve rien), et un rétablissement sans ticket est un no-op sûr. Rien ne casse.

Note

L’index de recherche Jira est en cohérence à terme : si un monitor flappe panne→rétablissement en quelques secondes, le rétablissement peut ne pas encore trouver le ticket tout juste créé et le laisser ouvert ; l’événement suivant réconcilie. Les vrais incidents (minutes ou plus) ne sont pas affectés.

Notes

• L’authentification est Basic (email + jeton d’API), via l’API REST Jira.
• Le résumé et la description du ticket créé nomment le monitor, l’URL, la région et l’heure de détection.
• Jira auto-hébergé (Data Center) fonctionne — utilisez son nom DNS (une IP privée littérale est refusée).