Aktivitätsprotokoll
Das Activity Log zeigt deinen neuesten Traffic. Es lädt beim Öffnen der Seite; klicke auf die Aktualisieren-Schaltfläche neben dem Titel, um die neuesten Zeilen abzurufen. Nutze es, um einzelne Aufrufe zu debuggen, Response Codes zu prüfen und sicherzustellen, dass eine neue Integration funktioniert.
Produkt
Die Seite öffnet sich mit einem Produkt-Umschalter: API für die Requests, die du an die API-Endpoints sendest, Proxy für die Tunnel, die deine eigenen Tools über proxy.foura.ai öffnen. Beide Feeds decken die letzte Stunde ab und nutzen dieselbe Limit-Auswahl. Die Auswahl wird gespeichert und ist über #activity/proxy direkt verlinkbar.
Der Rest dieser Seite beschreibt zuerst den API-Feed, danach den Proxy-Feed.
Was du im API-Feed siehst
Das Log zeigt Requests der letzten Stunde an, die neuesten ganz oben. Neun Spalten strukturieren jede Zeile:
| Spalte | Was sie anzeigt |
|---|---|
| Zeit | Wann der Request gestellt wurde |
| Key | Welcher API-Key verwendet wurde |
| Request | Der Aufruf selbst: eine farbige Endpoint-Markierung (Single, Proxy, Browser oder Auto), die HTTP-Methode und die Zieldomäne. Sortiert nach Domäne. |
| Status | Zwei Werte in einer Zelle, getrennt durch einen Schrägstrich: der HTTP-Status deines Aufrufs an FourA, gefolgt vom Status, den das Ziel zurückgegeben hat. Ein Strich bedeutet, dass das Ziel nie geantwortet hat. |
| Ergebnis | Request-Klassifizierung (Success, Client Error, Rate Limited und so weiter) |
| Dauer | Gesamte Response-Zeit in Millisekunden |
| Bytes | Übertragung in beide Richtungen in einer Zelle: Pfeil nach unten für den Request-Payload, Pfeil nach oben für die Response. Eine Zeile mit Premium-Traffic enthält ein premium-Label in dieser Zelle, einschließlich solcher, bei denen ein Premium-Exit versucht wurde und der Standard-Pool geantwortet hat; dieser Traffic zählt zu deinem Premium-Traffic. |
| Credits | Für den Aufruf verbrauchte Credits (siehe Response Headers) |
| Client-IP | Die Adresse, von der der Request stammt. Requests aus dem Playground oder FourAs gehostetem MCP zeigen FourA anstelle einer Adresse an. |
Klicke auf eine Spaltenüberschrift, um die Tabelle nach dieser Spalte zu sortieren; die Richtung wechselt absteigend, aufsteigend und aus. Strg- oder Cmd-Klick setzt auf den Standard zurück (neueste zuerst).
Filtern
Vier Steuerelemente schränken das Log ein.
Nach Eigentümer
Wenn du mindestens einer Organisation angehörst, erscheint zuerst das Dropdown Eigentümer: Alles, Persönlich oder eine deiner Organisationen. Eine Änderung aktualisiert das Key-Dropdown daneben, sodass ein Key des vorherigen Eigentümers den Wechsel nicht überstehen und stillschweigend nichts zurückgeben kann. Dasselbe Steuerelement in Übersicht, Metriken und API-Keys folgt deiner Auswahl. Siehe Organisationen.
Nach API-Key
Verwende das API-Key-Dropdown, um Requests eines einzelnen Keys anzuzeigen. Es erscheinen nur Keys, auf die du Zugriff hast: deine persönlichen Keys und die Keys von Organisationen, denen du angehörst.
Nach Endpoint
Wenn Produkt auf API gesetzt ist, filtere mit den Chips Single / Proxy Finder / Browser / Auto auf einen Endpoint. Nützlich, wenn du reine Browser-Fehler getrennt von Single-Requests debuggen willst. Auto listet deine Auto-Aufrufe mit jeweils einer Zeile auf.
Nach Limit
Das Aktivitätsprotokoll zeigt standardmäßig 50 Einträge an. Verwende die Limit-Auswahl, um die Anzahl der angezeigten Einträge zu ändern:
| Limit | Notizen |
|---|---|
| 10 | Schneller Überblick |
| 50 | Standard |
| 100 | Erweiterte Ansicht |
| 200 | Maximum |
Alle Einträge stammen aus der letzten Stunde. Für historische Daten nutze den Bereich Metriken, der Daten über Tage und Wochen aggregiert.
Auto-Aufrufe
Eine Auto-Zeile entspricht einem Aufruf. Die zweite Zeile zeigt, wie viele Versuche Auto unternommen hat und wie viele davon erfolgreich waren; Credits und Bytes zeigen die Gesamtsummen dieser Versuche. Für einige Sekunden nach Ende eines Aufrufs wird attempts settling… angezeigt, danach füllt sich die Zeile automatisch aus. Ein Aufruf, der abgelehnt wurde, bevor Auto einen Versuch starten konnte, zeigt no attempts recorded an.
Öffne die Zeile, um eine Attempts-Tabelle zu sehen: Engine, Rung, Status, Outcome, Time, Bytes, Credits. Versuche zählen zu deinen Single-, Proxy Finder- und Browser-Limits, jedoch nie zu deiner Request-Anzahl oder Erfolgsrate.
Einen Request öffnen
Klicke auf eine Zeile, um ein Detail-Panel mit einer Vorschau der vollständigen Request- und Response-Payloads zu öffnen. Das Panel zeigt ein Meta-Raster basierend auf der Zeile selbst an, sodass es auch nutzbar bleibt, wenn die gespeicherte Payload abgelaufen ist: Zeit, API-Key, Client-IP, Ziel, HTTP-Status, App-Status, Ergebnis, Gateway total (der gesamte Aufruf aus FourA-Sicht), Upstream fetch (die Zeit für den antwortenden Versuch), Bytes, Credits und die X-FourA-Request-Id des Requests. Falls zutreffend, werden auch die Proxy-Kette eines Proxy Finder-Aufrufs (jeder Proxy-Versuch inklusive Retries), der genutzte Proxy, die Response-Body-Größe und Fehler der Engine angezeigt.
Unter dem Raster wird jeweils ein Bereich angezeigt, auswählbar über Tabs:
| Tab | Inhalt |
|---|---|
| Request | Formatierter JSON-Code des exakt gesendeten Bodys |
| Response headers | Die vom Ziel zurückgegebenen Header, ein Block pro Redirect-Hop. Bei Weiterleitungen zeigt der Tab die Anzahl der Hops an. |
| Response body | Die gespeicherte Body-Vorschau mit Badges für abgeschnittene oder binäre Daten, sofern zutreffend |
| Other fields | Alle weiteren Rückgabewerte der Engine abseits von Status, Timings, Proxy und Headern. Ausgeblendet, wenn keine zusätzlichen Daten vorliegen. |
Ein Kopieren-Button kopiert den aktuell geöffneten Bereich. Payloads werden 24 Stunden lang gespeichert, begrenzt auf die letzten 200 pro API-Key. Ältere Zeilen zeigen nur die Zeilendaten ohne Payload an.
Meldungen im Body-Bereich
Der Body-Bereich verwendet je nach Status unterschiedliche Platzhaltertexte:
| Nachricht | Bedeutung |
|---|---|
(no body — the request failed: <error>) |
Der Request schlug fehl, bevor das Ziel einen Body zurückgab |
(no body captured for this request) |
Payload ist abgelaufen oder wurde nicht gespeichert |
(empty body — the server returned 0 bytes) |
Das Ziel hat eine tatsächlich leere Response zurückgegeben |
Im Playground öffnen
Der Detail-Dialog enthält den Button Open in Playground. Klicke darauf, um den archivierten Request und die archivierte Response in das Playground-Formular zu laden. Von dort aus kannst du Parameter anpassen und den Aufruf erneut an die Live-API senden oder einfach das Ergebnis prüfen, ohne den Request erneut auszuführen.
Der Button ist für Auto-Aufrufe und nicht wiederholbare Payloads (zu große Request-Stubs und Nicht-API-Routen) deaktiviert, jeweils mit einem Hinweis zum Grund.
Der Proxy-Feed
Stelle Product auf Proxy um, und der Feed zeigt eine Zeile pro Tunnel an, ebenfalls aus der letzten Stunde. Ein Tunnel ist eine von deinem Tool geöffnete Verbindung. Was darin gesendet wurde, ist dein eigener verschlüsselter Traffic. Die Zeile beschreibt daher, wohin die Verbindung ging, wie sie geroutet wurde, wie lange der Aufbau dauerte und welches Datenvolumen übertragen wurde.
| Spalte | Angezeigter Inhalt |
|---|---|
| Time | Zeitpunkt, an dem der Tunnel endete, mit relativer Zeitangabe daneben |
| Proxy user | Verwendeter Proxy-Benutzer |
| Target | Host und Port des Tunnel-Ziels |
| Exit | Shared oder Premium, plus das Land des Exits, sofern bekannt |
| Outcome | Success, Client Error, Service Error, Service Fail oder Rate Limited, bei einer Ablehnung mit der Ursache in deinen eigenen Begriffen |
| Setup | Dauer vom Verbindungsaufbau deines Tools bis zur Übergabe des Tunnels |
| Duration | Dauer, die der Tunnel offen blieb |
| Bytes | Beide Richtungen in einer Zelle, mit einer premium-Kennzeichnung, wenn der Exit über das Premium-Netzwerk lief |
| Client IP | Adresse, von der die Verbindung ausging |
Es gibt keine Spalten für Status, Credits oder Payloads und keinen Detail-Dialog. Ein CONNECT hat keinen Status vom Ziel und keinen Body, den FourA speichern könnte.
Das Owner-Dropdown und die Limit-Auswahl funktionieren genauso. Anstelle des Key-Dropdowns filtert ein Proxy user-Dropdown den Feed auf eine bestimmte Anmeldeinformation. Jede Spalte lässt sich sortieren.
Eine Zeile mit dem Status Rate Limited bezieht sich auf das Limit deines Tarifs, nicht auf eine Ablehnung durch das Ziel. Der angegebene Grund nennt das konkrete Limit: gleichzeitige Tunnel, Verbindungsaufbauten pro Minute, aufgebrauchter Traffic, Premium nicht verfügbar oder ein Port, der nicht in deinem Tarif enthalten ist. Siehe Proxy Port.
Die Request-ID verwenden
Jede API-Response enthält einen X-Foura-Request-Id-Header. Wenn du ihn serverseitig protokollierst, kannst du ihn in ein Support-Ticket einfügen, um exakt auf den Request im Activity Log zu verweisen. Die ID entspricht der ID in diesem Dialog sowie der von der API zurückgegebenen X-Foura-Request-Id. Details findest du unter Response Headers.
Verwandte Themen
- Metriken und Analysen: Aggregierte Performancedaten über längere Zeiträume für beide Produkte
- Proxy-Port: Das Produkt, über das der Proxy-Feed berichtet
- Playground: Requests aus der Activity wiederholen
- Response-Header: Herkunft von Request-ID und Credits
- API-Endpoints: Request- und Response-Formate
- Organisationen: Was der Owner-Filter abdeckt
- Fehlerbehebung: Häufige Probleme und Lösungen