Metriken
Die Metriken-Seite (Seitenleiste > Metriken) bietet dir eine tiefere analytische Ansicht deiner API-Nutzung. Sie zeigt deine gesamte Outcome-Verteilung und schlüsselt den Traffic nach API-Key, Client-IP oder Ziel-Domain auf.
Für Echtzeit-Zusammenfassungskarten und Zeitliniendiagramme (Concurrency, Requests, Bytes, Response Time) nutze die Seite Dashboard-Übersicht.
Filter
Über der Seite befinden sich zwei Steuerelemente: eine API-Key-Auswahl und eine Intervall-Auswahl.
Key-Filter
Nutze das API-Key-Dropdown, um die Seite auf einen bestimmten Key einzugrenzen. Es erscheinen nur Keys innerhalb deines Zugriffsbereichs: persönliche Keys, von dir verwaltete Org-Keys oder über Teams geteilte Keys.
Intervall-Auswahl
Nutze die Intervall-Buttons, um das Zeitfenster zu steuern:
| Button | Zeitfenster |
|---|---|
| 1M | Letzte 1 Minute |
| 5M | Letzten 5 Minuten |
| 30M | Letzten 30 Minuten |
| 1H | Letzte 1 Stunde |
| 6H | Letzten 6 Stunden |
| 1D | Letzten 24 Stunden |
Sowohl das Donut-Diagramm als auch die Tabelle passen sich deiner Auswahl an.
Outcome-Verteilung
Ein Donut-Diagramm oben zeigt die Aufteilung in Erfolg/Fehler für das ausgewählte Intervall. Bewege den Mauszeiger über ein Segment, um die genaue Anzahl der Requests und den Prozentsatz zu sehen. Nutze es, um schnell zu erkennen, ob ein plötzlicher Abfall der Erfolgsquote mit einer bestimmten Outcome-Kategorie zusammenhängt.
Outcome-Typen
Jeder API-Request wird genau einem Outcome zugeordnet. Nur success wird auf dein abrechenbares Kontingent angerechnet.
| Outcome | Ebene | Bedeutung |
|---|---|---|
success |
n. a. | Der Request hat eine gültige Response geliefert. Ohne validate-Regeln bedeutet dies HTTP 200. Wenn du validate-Regeln gesendet hast, gilt jede von deinen Regeln akzeptierte Response als Erfolg, unabhängig vom HTTP-Status. |
application_error |
target | Das Ziel hat HTTP 200 zurückgegeben, aber der Response-Body enthielt ein Fehlerfeld. |
application_fail |
target | Das Ziel hat einen Nicht-2xx-Status zurückgegeben, den deine validate-Regeln nicht akzeptiert haben, oder gar keine Response. |
client_error |
caller | Dein Request wurde abgelehnt, bevor er FourA verlassen hat: ungültige Parameter, fehlerhafter Proxy-Wert oder eine URL, die auf eine private/reservierte IP verweist (SSRF-Schutz). |
rate_limit |
FourA | Der Request wurde durch dein RPM- oder Concurrency-Limit abgelehnt. Siehe Rate Limits. |
service_error |
FourA | Das Backend hat einen 5xx-Fehler zurückgegeben oder mit einem Body geantwortet, den wir nicht parsen konnten. |
service_fail |
FourA | Ein Netzwerkfehler: Timeout, Verbindung verweigert, DNS-Fehler, Client-Verbindung getrennt. |
Die Spalte „Ebene“ zeigt, wer verantwortlich ist: target bedeutet die von dir aufgerufene Seite, caller bedeutet, dass dein Request fehlerhaft war, FourA bedeutet, dass wir ihn nicht verarbeiten konnten.
Wenn du validate.status.accept verwendest, um bestimmte Nicht-200-Codes zuzulassen (zum Beispiel [200, 403]), werden diese Antworten als success statt als application_fail zurückgegeben. Die Klassifizierung folgt der Entscheidung der Engine über deine Regeln, nicht dem rohen HTTP-Code.
Die vollständige Taxonomie und wie sie sich auf die Abrechnung auswirkt, findest du unter Request Outcomes.
Multi-View-Nutzungstabelle
Unter dem Donut-Diagramm schlüsselt eine Nutzungstabelle deinen Traffic in drei Ansichts-Tabs auf:
| Tab | Gruppiert Daten nach |
|---|---|
| API Key | Jedem deiner API-Keys |
| Client IP | Quell-IP-Adressen, die Requests senden |
| Domain | Ziel-Domains in deinen Requests |
Jeder Tab unterstützt rechts vier Bereichs-Chips, die die angezeigten Spalten ändern:
| Bereich | Was angezeigt wird |
|---|---|
| Bandwidth | Request-Anzahl, Bytes eingehend, Bytes ausgehend |
| Response Time | Request-Anzahl, minimale, mittlere und maximale Latenz |
| Concurrency | Request-Anzahl plus Anzahl gleichzeitiger Requests (nur in der API-Key-Ansicht) |
| Outcomes | Request-Anzahl plus eine Aufschlüsselung nach Outcome |
Verwandte Themen
- Dashboard-Übersicht: Echtzeit-Statistiken und Zeitliniendiagramme
- Request Outcomes: Die sieben Outcome-Werte im Detail erklärt
- API-Fehler: Wie Fehler über das Netzwerk zurückgegeben werden