Zum Hauptinhalt springen
Integrationen

Integrationshistorie prüfen und exportieren

Fehlende Tickets und Zustellfehler eingrenzen, ältere Versuche finden und gefilterte Historien als CSV exportieren.

Wenn ein Ticket fehlt oder eine Integration einen Fehler meldet, prüfe ihre Historie. Dort findest du die gespeicherten Versuche mit Ergebnis und, je nach Integration, Anfrage, Antwort und Fehlerdetails.

Voraussetzungen

Du benötigst die Berechtigung Integrationsverwaltung. Für Zustellungen muss die jeweilige Integration eingerichtet sein; eine leere Historie bestätigt nicht, dass eine Alarmierungsregel richtig konfiguriert ist.

Einen Versuch finden

  1. Öffne Administration → Integrationen und die betroffene Integration. Bei Webhooks, Teams oder E-Mail öffnest du den konkreten Webhook, Kanal oder Empfänger.
  2. Öffne Historie beziehungsweise die angezeigte Zustelltabelle.
  3. Gib unter Historie durchsuchen… einen Suchbegriff ein und bestätige mit Enter. Suche zum Beispiel nach einer Ticketnummer oder einem Fehlertext, der in den gespeicherten Details vorkommt. Welche Felder durchsuchbar sind, hängt von der Integration ab.
  4. Grenze mit Vorgang, Ergebnis, Von und Bis ein. Bis schließt den gewählten Tag ein. Suche und Filter gelten für die gesamte gespeicherte Historie, nicht nur für die sichtbare Seite.
  5. Sortiere über eine sortierbare Spaltenüberschrift oder blättere unten weiter. Standardmäßig erscheinen die neuesten Versuche zuerst und 50 Zeilen pro Seite; du kannst 25, 50, 100 oder 200 wählen.
  6. Klappe die passende Zeile auf. Lies die verfügbaren Anfrage- und Antwortdaten, Fehlerdetails und gegebenenfalls den Zeitpunkt des nächsten Versuchs.

Mit Filter zurücksetzen entfernst du die Such- und Filterbedingungen. Eine leere gefilterte Liste bedeutet nur, dass kein gespeicherter Eintrag zu diesen Bedingungen passt.

Das Ergebnis einordnen

Ergebnis oder SymptomNächster Schritt
Übersprungen oder Nicht konfiguriertLies den Grund. Prüfe zum Beispiel die Kunden-Zuordnung, die Verbindung und den gewählten Alarmierungskanal.
FehlgeschlagenPrüfe Statuscode und Antwort. Korrigiere Zugangsdaten, Berechtigungen oder ungültige Angaben; beachte einen bereits angekündigten nächsten Versuch.
Endgültig fehlgeschlagenFür diesen Versuch sind keine weiteren automatischen Wiederholungen vorgesehen. Behebe die Ursache und prüfe, ob der Kanal eine manuelle Wiederholung anbietet.
Erfolgreich, aber das erwartete Ticket fehltVerwende die Ticket-ID oder Nummer aus der Antwort und prüfe Kunde und Zielsystem. Ein erfolgreicher Zustellversuch allein bestätigt nicht jede nachgelagerte Aktion des Zielsystems.
Keine Antwort aufgezeichnetLies vorhandene Fehlerdetails. Eine fehlende Antwort ist kein Beleg dafür, dass das Zielsystem nichts verarbeitet hat.

Bei Verbindungsfehlern oder Zeitüberschreitungen prüfe auch die Firewall beziehungsweise IP-Freigabe vor der API oder dem Empfänger. Siehe IP-Adressen und Firewall-Freigaben; eine erfolgreiche Verbindung aus deinem Browser bestätigt nicht die Erreichbarkeit von octoja aus.

Bei Webhooks zeigt das Zustelldiagramm die letzten 24 Stunden. Es ist nicht auf die sichtbare Tabellenseite begrenzt und muss deshalb nicht dieselbe Anzahl wie eine anders gefilterte Historie zeigen.

Gefilterte Historie exportieren

  1. Stelle Suche, Filter und Sortierung wie gewünscht ein.
  2. Öffne das Tabellenmenü … und wähle CSV exportieren.
  3. Verwende die Datei für die weitere Analyse oder Weitergabe. Sie enthält alle passenden Zeilen, nicht nur die aktuelle Seite. Versuche, die nach dem Start des Exports hinzukommen, werden nicht aufgenommen.

Achtung: Historien und Exporte können Kunden-, Geräte- und Fehlerdaten enthalten. Prüfe den Inhalt, bevor du ihn außerhalb deines Teams weitergibst.

Eine Zustellung erneut senden

Erneut senden steht bei Webhooks, Teams, E-Mail und Woasi zur Verfügung, nicht bei jeder Integration. Klappe die betreffende Zeile auf und nutze die Schaltfläche erst, nachdem du die Ursache behoben hast. Die Verbindung muss weiterhin verwendbar sein.

Eine Wiederholung kann im Zielsystem erneut eine Aktion auslösen. Prüfe vorher, ob die erste Zustellung dort bereits verarbeitet wurde — besonders nach einer Zeitüberschreitung.

Verwandte Artikel