Jira

Überblick

Die Jira-Integration legt ein Ticket in Ihrem Projekt an, wenn ein Monitor ausfällt. Verfügbar im Tarif Enterprise.

Hinweis

Nur der Übergang nach DOWN erzeugt ein Ticket — up, beeinträchtigt und pausiert tun bewusst nichts, sodass ein flatternder oder sich erholender Monitor das Projekt nie zuspammt. Das Auflösen bzw. Schließen des Tickets überlässt OKStatus Ihrem eigenen Workflow. Für Bereitschaftsalarme (anlegen + automatisch auflösen) verwenden Sie stattdessen Jira Service Management.

Einrichtung

1. Erstellen Sie ein API-Token unter id.atlassian.com → API tokens.
2. Notieren Sie den Projektschlüssel (z. B. OPS) und den gewünschten Vorgangstyp (z. B. Task, Bug).
3. Gehen Sie in OKStatus zu Alarmierung → Kanäle → Kanal hinzufügen → Jira.
4. Füllen Sie aus:
   • Basis-URL — https://ihr-team.atlassian.net
   • Konto-E-Mail — das Atlassian-Konto, zu dem das Token gehört
   • API-Token
   • Projektschlüssel
   • Vorgangstyp (optional, Standard Task)
   • Ein Ticket wiederverwenden und automatisch auflösen (optionales Kontrollkästchen — siehe unten)
5. Klicken Sie auf Testen und hängen Sie den Kanal dann an Ihre Monitors.

Ein Ticket wiederverwenden und automatisch auflösen

Standardmäßig legt der Kanal bei jedem Ausfall ein neues Ticket an — was bei einem flatternden Monitor (wiederholt down/up) Ihr Board fluten kann. Aktivieren Sie Ein Ticket wiederverwenden und automatisch auflösen, damit stattdessen ein einziges Ticket je Monitor dessen Zustand nachführt:

• Down → legt ein Ticket an (oder öffnet ein vorhandenes erneut bzw. kommentiert es).
• Up → überführt dieses Ticket in einen Done-Status.
• Erneut down → öffnet dasselbe Ticket wieder, statt ein neues anzulegen.

Ein Monitor, der 30-mal flattert, erzeugt also ein Ticket mit 30 Statusänderungen, nicht 30 Tickets.

Wie es funktioniert und warum es robust ist:

• Das Ticket wird jedes Mal über ein monitorspezifisches Label gefunden (OKStatus speichert den Vorgangsschlüssel nie), das Verhalten ist also zustandslos.
• Die Übergänge werden aus dem Workflow Ihres Projekts automatisch erkannt (zum Auflösen wird ein Übergang gewählt, dessen Zielstatus in der Kategorie Done liegt, zum Wiederöffnen einer außerhalb davon) — keine Statusnamen zu konfigurieren, funktioniert auch mit eigenen Workflows.
• Löscht eine Administratorin das Ticket vollständig, legt der nächste Ausfall schlicht ein neues an (die Label-Suche findet nichts), und eine Wiederherstellung ohne Ticket ist ein gefahrloser Leerlauf. Nichts geht kaputt.

Hinweis

Der Suchindex von Jira ist letztlich konsistent (eventually consistent): Flattert ein Monitor innerhalb weniger Sekunden down→up, findet die Wiederherstellung das gerade angelegte Ticket womöglich noch nicht und lässt es offen; das nächste Ereignis gleicht das ab. Echte Vorfälle (Minuten oder länger) sind nicht betroffen.

Hinweise

• Die Authentifizierung erfolgt per Basic (E-Mail + API-Token) über die Jira-REST-API.
• Zusammenfassung und Beschreibung des angelegten Vorgangs nennen Monitor, URL, Region und Erkennungszeitpunkt.
• Selbst gehostetes Jira (Data Center) funktioniert — verwenden Sie dessen DNS-Namen (eine buchstäbliche private IP wird abgelehnt).