Tool-Aufrufstatistik und Fehlerwarnungen

Wo finde ich das?

Oben auf der Seite „Tools“ gibt es drei Tabs: „Tools“, „Aufrufstatistik“ und „Protokoll- und Benachrichtigungseinstellungen“. Alle Mitglieder können die Statistik sehen; Einstellungen zu ändern erfordert die Rolle Inhaber oder Administrator.

Aufrufstatistik

Wählen Sie oben einen Zeitraum (heute, gestern, die letzten 7, 30 oder 90 Tage, gesamter Zeitraum oder benutzerdefiniert). Standard sind die letzten 7 Tage.

Ein Aufruf gilt als erfolgreich, wenn Ihr Tool eine 2xx-Antwort liefert, auch wenn die Antwort selbst einen Fehler meldet. Ist die Wiederholung bei Fehlern aktiv, zählen alle Versuche als ein Aufruf.

• Zusammenfassung: Zahl der erfolgreichen und fehlgeschlagenen Aufrufe, Erfolgsrate und durchschnittliche Dauer.
• Diagramme: Aufrufe pro Tag, fehlgeschlagene Aufrufe pro Tag und eine Aufschlüsselung pro Tool. Testaufrufe zählen in den Diagrammen nicht, erscheinen aber im Aufrufprotokoll.
• Offene Warnungen: Dauerhaft fehlerhafte Tools stehen in einem Feld oben auf der Seite, eines pro Zeile; der Link in jeder Zeile führt zu den fehlgeschlagenen Aufrufen dieses Tools. Der Verlauf geschlossener Warnungen steht unten auf der Seite.
• Aufrufprotokoll: Filtern Sie nach Tool, Status und Quelle (Agent, Auswahl-Schritt, Tool-Aufruf-Schritt, Test). Ein Klick auf eine Zeile zeigt die Fehlerdetails, den HTTP-Status, die Dauer, die Antwortgröße, den Fehlertext des Tools, die gesendeten Felder (E-Mail-Adressen und lange Nummern sind ausgeblendet) sowie Agent und Sitzung. Der Inhalt einer erfolgreichen Antwort wird nicht gespeichert.

Die Tools des Shop-Agenten (Produktsuche, Bestellstatus…) werden hier nicht gezählt; Sie finden sie unter Integrationen › „Aktionsstatistik“.

Protokoll- und Benachrichtigungseinstellungen

• „Aufbewahrungsfrist“: wie viele Tage detaillierte Aufrufdaten aufbewahrt werden (1–30 Tage, Standard 7). Zähler sind dauerhaft; nach Ablauf werden nur die Details gelöscht.
• „Zeitfenster“ und „Schwellenwert“: Eine Warnung öffnet sich, wenn innerhalb des Zeitfensters (5–1440 Minuten, Standard 15) mindestens so viele Aufrufe fehlschlagen wie der Schwellenwert angibt (1–1000, Standard 5).

Gelingt ein Aufruf und fällt die Fehlerzahl unter den Schwellenwert, schließt sich die Warnung von selbst, und eine Benachrichtigung „funktioniert wieder“ geht raus. Ein Tool mit offener Warnung zeigt in der Tool-Liste das Abzeichen „Fällt aus“.

Zeitfenster und Schwellenwert gelten auch für die Anbieter-Fehlerwarnung bei Integrationen; Integrationswarnungen gehen mit der Benachrichtigung „Ausfall eines Integrationsschritts“ raus. An welchen Kanal Tool-Warnungen gehen (Slack, Teams, Telegram, E-Mail), wählen Sie mit der Benachrichtigung „Tool-Ausfall“ auf der Seite „Warnungen und Benachrichtigungen“.