Metriken
Die Metrics-Seite (Seitenleiste > Metrics) bietet dir einen detaillierten analytischen Einblick in deine API-Nutzung. Sie zeigt die Gesamtverteilung der Ergebnisse und schlüsselt den Traffic nach API-Key, Client-IP oder Zieldomain auf.
Für Echtzeit-Zusammenfassungskarten und Zeitachsendiagramme (Concurrency, Requests, Bytes, Response Time, Budget) verwende die Seite Dashboard Overview.
Filter
Zwei Steuerelemente befinden sich über der Seite: eine API-Key-Auswahl und eine Intervall-Auswahl.
Key Filter
Verwende das API-Key-Dropdown, um die Seite auf einen bestimmten Key zu beschränken. Nur Keys in deinem Zugriffsbereich werden angezeigt: persönliche Keys, Org-Keys, die du verwaltest, oder Keys, die über Teams geteilt werden.
Interval Selector
Verwende die Intervall-Schaltflächen, um das Zeitfenster zu steuern:
| Button | Window |
|---|---|
| 1M | Letzte 1 Minute |
| 5M | Letzte 5 Minuten |
| 30M | Letzte 30 Minuten |
| 1H | Letzte 1 Stunde |
| 6H | Letzte 6 Stunden |
| 1D | Letzte 24 Stunden |
Sowohl das Donut-Diagramm als auch die Tabelle folgen deiner Auswahl.
Outcome Distribution
Ein Donut-Diagramm oben zeigt die Aufschlüsselung von Erfolg/Fehler für das ausgewählte Intervall. Fahre über ein Segment, um die genaue Anzahl der Requests und den Prozentsatz zu sehen. Nutze es, um schnell zu erkennen, ob ein plötzlicher Rückgang der Erfolgsquote mit einer bestimmten Ergebniskategorie übereinstimmt.
Outcome Types
Jeder API-Request wird genau einem Ergebnis zugeordnet. Nur success wird auf dein abrechenbares Kontingent angerechnet.
| Outcome | Layer | Meaning |
|---|---|---|
success |
n/a | Der Request lieferte eine gültige Response. Ohne validate-Regeln bedeutet dies HTTP 200. Wenn du validate-Regeln gesendet hast, gilt jede Response, die deine Regeln akzeptiert haben, als Erfolg, unabhängig vom HTTP-Status. |
application_error |
target | Das Ziel gab HTTP 200 zurück, aber der Response-Body enthielt ein Fehlerfeld. |
application_fail |
target | Das Ziel gab einen Nicht-2xx-Status zurück, den deine validate-Regeln nicht akzeptiert haben, oder gar keine Response. |
client_error |
caller | Dein Request wurde abgelehnt, bevor er FourA verließ: falsche Parameter, fehlerhafter Proxy-Wert oder eine URL, die auf eine private/reservierte IP (SSRF-Schutz) auflöst. |
rate_limit |
FourA | Der Request wurde durch dein RPM- oder Concurrency-Limit abgelehnt. Siehe Rate Limits. |
service_error |
FourA | Das Backend gab einen 5xx zurück oder antwortete mit einem Body, den wir nicht parsen konnten. |
service_fail |
FourA | Ein Netzwerkfehler: Timeout, Verbindung abgelehnt, DNS-Fehler, Client getrennt. |
Die Layer-Spalte sagt dir, wer verantwortlich ist: target bedeutet die Seite, die du aufgerufen hast, 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 (z. B. [200, 403]) zuzulassen, kommen diese Responses als success anstelle von application_fail zurück. Die Klassifizierung folgt dem Urteil der Engine zu deinen Regeln, nicht dem reinen HTTP-Code.
Für die vollständige Taxonomie und wie sie sich auf die Abrechnung auswirkt, siehe Request Outcomes.
Multi-View Usage Table
Unter dem Donut schlüsselt eine Nutzungstabelle deinen Traffic mit drei Ansichts-Tabs auf:
| Tab | Gruppiert Daten nach |
|---|---|
| API Key | Jedem deiner API-Schlüssel |
| Client IP | Quell-IP-Adressen, die Requests ausführen |
| Domain | Ziel-Domains in deinen Requests |
Jeder Tab unterstützt Scope-Chips auf der rechten Seite, die die angezeigten Spalten ändern:
| Scope | Was er anzeigt |
|---|---|
| Bandwidth | Request-Anzahl, Bytes in, Bytes out |
| Response Time | Request-Anzahl, min., durchschn. und max. Latenz |
| Concurrency | Request-Anzahl plus Anzahlen gleichzeitiger Requests (nur API-Key-Ansicht) |
| Outcomes | Request-Anzahl plus einer Aufschlüsselung pro Outcome |
| Budget | Request-Anzahl und verbrauchte Credits, aufgeschlüsselt nach Produkt (Single, Proxy, Browser) |
Der Budget-Scope liest die Metrik credits, die bei jedem Request von der API geschrieben wird (siehe Response Headers). Die Summen entsprechen den unbereinigten gemessenen Ausgaben; die Abrechnung berücksichtigt für deinen Plan nur das Outcome success.
Klicke auf einen Spaltenkopf, um nach dieser Spalte zu sortieren. Der Sortierstatus bleibt pro Tabelle über Seitenaufrufe hinweg erhalten. Strg- oder Cmd-Klick auf einen Header setzt diesen zurück.
Verwandt
- Dashboard Overview: Echtzeit-Statistiken und Zeitachsen-Diagramme
- Request Outcomes: Die sieben Outcome-Werte im Detail erklärt
- Response Headers: Woher die Credits stammen
- API Errors: Wie Fehler über die Leitung zurückkommen