Dziennik aktywności
Activity Log pokazuje Twoj najnowszy ruch w czasie rzeczywistym. Uzyj go do debugowania pojedynczych wywolan, sprawdzania kodow odpowiedzi oraz weryfikacji dzialania nowej integracji.
Produkt
Strona otwiera sie z przelacznikiem Product: API dla zadan wysylanych do endpointow API, Proxy dla tuneli otwieranych przez Twoje wlasne narzedzia przez proxy.foura.ai. Oba kanaly obejmuja ostatnia godzine i korzystaja z tego samego selektora limitu. Wybor jest zapamietywany i dostepny przez bezposredni link jako #activity/proxy.
Dalsza czesc tej strony opisuje najpierw kanal API, a nastepnie kanal Proxy.
Co zobaczysz w kanale API
Dziennik wyswietla zadania z ostatniej godziny, z najnowszymi na samej gorze. Caly wiersz sklada sie z dziewieciu kolumn:
| Kolumna | Co zawiera |
|---|---|
| Time | Czas wykonania zadania |
| Key | Uzyty klucz API |
| Request | Samo wywolanie: kolorowe oznaczenie endpointu (Single, Proxy, Browser lub Auto), metoda HTTP oraz domena docelowa. Sortowanie wedlug domeny. |
| Status | Dwie wartosci w jednej komorce, rozdzielone ukosnikiem: status HTTP Twojego wywolania do FourA, a nastepnie status zwrocony przez cel. Myslnik oznacza, ze cel nigdy nie odpowiedzial. |
| Outcome | Klasyfikacja zadania (Success, Client Error, Rate Limited itd.) |
| Duration | Calkowity czas odpowiedzi w milisekundach |
| Bytes | Transfer w obie strony w jednej komorce: strzalka w dol dla ladunku zadania, strzalka w gore dla odpowiedzi. Wiersz, ktory zuzyl ruch premium, ma oznaczenie premium w tej komorce, wlaczajac w to sytuacje, gdy podjeto probe uzycia wezla premium, ale odpowiedziala pula standardowa; taki ruch wlicza sie do Twojego ruchu premium. |
| Credits | Kredyty wykorzystane na wywolanie (zobacz Response Headers) |
| Client IP | Adres, z ktorego wyslano zadanie. Zadania wyslane z Playground lub hostowanego MCP FourA pokazuja FourA zamiast adresu. |
Kliknij naglowek dowolnej kolumny, aby posortowac tabele wedlug tej kolumny; kierunek przelacza sie miedzy malejacym, rosnacym a wylaczonym. Klikniecie z klawiszem Ctrl lub Cmd przywraca domyslne sortowanie (od najnowszych).
Filtrowanie
Cztery kontrolki pozwalaja zawezic dane w dzienniku.
Wedlug wlasciciela
Jesli nalezysz do co najmniej jednej organizacji, jako pierwsze pojawia sie menu rozwijane Owner: Everything, Personal lub jedna z Twoich organizacji. Jego zmiana przebudowuje sasiednie menu kluczy, wiec klucz nalezacy do poprzedniego wlasciciela nie pozostanie wybrany i nie zwroci po cichu pustego wyniku. Ta sama kontrolka w sekcjach Overview, Metrics i API Keys stosuje sie do Twojego wyboru. Zobacz Organizations.
Wedlug klucza API
Uzyj menu rozwijanego kluczy API, aby wyswietlic zadania powiazane z jednym kluczem. Widoczne sa tylko klucze, do ktorych masz dostep: Twoje klucze osobiste oraz klucze organizacji, do ktorych nalezysz.
Wedlug endpointu
Gdy opcja Product jest ustawiona na API, mozesz odfiltrowac do jednego endpointu za pomoca przyciskow Single / Proxy Finder / Browser / Auto. Jest to przydatne, gdy chcesz zdebugowac bledy wystepujace wylacznie w przegladarce oddzielnie od pojedynczych zadan. Auto wyswietla Twoje wywolania Auto, po jednym wierszu na kazde.
Wedlug limitu
Domyślnie dziennik aktywności wyświetla 50 wpisów. Użyj selektora limitu, aby zmienić liczbę wyświetlanych pozycji:
| Limit | Uwagi |
|---|---|
| 10 | Szybki podgląd |
| 50 | Domyślnie |
| 100 | Widok rozszerzony |
| 200 | Maksimum |
Wszystkie wpisy pochodzą z ostatniej godziny. W przypadku danych historycznych użyj sekcji Metrics, która agreguje dane z wielu dni i tygodni.
Wywołania Auto
Wiersz Auto reprezentuje jedno wywołanie. Jego druga linijka wskazuje, ile prób podjął tryb Auto i ile z nich zakończyło się sukcesem, a wartości Credits i Bytes to sumy tych prób. Przez kilka sekund po zakończeniu wywołania widoczny jest komunikat attempts settling…, po czym wiersz sam się uzupełnia. Wywołanie odrzucone, zanim tryb Auto podjął jakąkolwiek próbę, ma status no attempts recorded.
Otwórz wiersz, aby zobaczyć tabelę Attempts: Engine, Rung, Status, Outcome, Time, Bytes, Credits. Próby wliczają się do Twoich limitów Single, Proxy Finder oraz Browser, ale nigdy do ogólnej liczby requestów ani wskaźnika success rate.
Otwieranie requestu
Kliknij dowolny wiersz, aby otworzyć panel szczegółów z pełnym podglądem payloadu requestu i response. Panel otwiera się z siatką metadanych zbudowaną na podstawie samego wiersza, dzięki czemu pozostaje użyteczny nawet po wygaśnięciu zapisanego payloadu: timestamp, key, status HTTP, status aplikacji, outcome, czas trwania, credits, proxy oraz X-FourA-Request-Id requestu.
Poniżej siatki wyświetlany jest jeden panel naraz, wybierany za pomocą zakładki:
| Zakładka | Co zawiera |
|---|---|
| Request | Sformatowany JSON (pretty-printed) z dokładnie wysłanym body |
| Response headers | Nagłówki zwrócone przez cel, po jednym bloku na każdy przeskok przekierowania. Gdy cel wykonał przekierowanie, zakładka pokazuje liczbę przeskoków. |
| Response body | Zapisany podgląd body, z oznaczeniami obcięcia (truncated) i danych binarnych (binary) tam, gdzie mają zastosowanie |
| Other fields | Wszystko inne, co zwrócił silnik poza statusem, czasami, proxy i nagłówkami. Ukryte, gdy nie ma dodatkowych danych. |
Przycisk Copy kopiuje zawartość aktualnie otwartego panelu. Payloady są przechowywane przez 24 godziny, z limitem do ostatnich 200 na klucz API. Starsze wiersze pokazują wyłącznie metadane wiersza, bez payloadu.
Komunikaty w panelu Body
Panel body wyświetla różne teksty zastępcze w zależności od tego, co się wydarzyło:
| Komunikat | Znaczenie |
|---|---|
(no body — the request failed: <error>) |
Wystąpił błąd requestu, zanim cel zwrócił body |
(no body captured for this request) |
Payload wygasł lub nie został zapisany |
(empty body — the server returned 0 bytes) |
Cel zwrócił rzeczywiście pusty response |
Otwieranie w Playground
Okno szczegółów zawiera przycisk Open in Playground. Kliknij go, aby załadować zarówno zarchiwizowany request, jak i zarchiwizowany response do formularza Playground. Z tego miejsca możesz zmodyfikować parametry i ponowić wywołanie do aktywnego API lub po prostu sprawdzić zwrócone dane bez ponownego uruchamiania requestu.
Przycisk jest wyłączony dla wywołań Auto oraz dla payloadów niemożliwych do powtórzenia (zbyt duże fragmenty requestów i trasy inne niż API), wraz ze wskazówką wyjaśniającą przyczynę.
Feed Proxy
Przełącz Product na Proxy, a lista zmieni się na jeden wiersz na tunel, również z ostatniej godziny. Tunel to pojedyncze połączenie otwarte przez Twoje narzędzie. Dane przesyłane wewnątrz to Twój własny zaszyfrowany ruch, więc wiersz opisuje docelowe miejsce połączenia, sposób wyjścia, czas nawiązywania oraz ilość przesłanych danych.
| Kolumna | Co zawiera |
|---|---|
| Time | Czas zakończenia tunelu wraz ze względnym czasem obok |
| Proxy user | Użytkownik proxy, który obsłużył połączenie |
| Target | Host i port docelowy tunelu |
| Exit | Shared lub Premium, wraz z krajem węzła wyjściowego, jeśli jest znany |
| Outcome | Success, Client Error, Service Error, Service Fail lub Rate Limited, z podaniem powodu odmowy w zrozumiałej formie |
| Setup | Czas od połączenia Twojego narzędzia do przekazania tunelu |
| Duration | Czas utrzymania otwartego tunelu |
| Bytes | Łącznie oba kierunki w jednej komórce, z oznaczeniem premium, gdy węzeł wyjściowy działał w sieci premium |
| Client IP | Adres, z którego zainicjowano połączenie |
Nie ma kolumn Status, Credits ani payload, brak też okna szczegółów. W przypadku CONNECT nie występuje kod statusu z celu ani treść, którą FourA mogłoby zapisać.
Menu rozwijane Owner i selektor limitu działają tak samo. Zamiast listy kluczy menu Proxy user ogranicza widok do pojedynczych danych uwierzytelniających. Wszystkie kolumny można sortować.
Wiersz ze statusem Rate Limited oznacza limit Twojego planu, a nie odmowę ze strony celu. Przyczyna wskazuje konkretny powód: liczbę jednoczesnych tuneli, liczbę otwarć na minutę, wyczerpany transfer, brak dostępności premium lub brak portu w Twoim planie. Zobacz Proxy Port.
Używanie Request ID
Każda odpowiedź API zawiera nagłówek X-Foura-Request-Id. Zapisuj go w logach po swojej stronie, aby wkleić go do zgłoszenia pomocy technicznej i wskazać dokładny request w Activity Log. Identyfikator jest taki sam jak ten używany w tym oknie i odpowiada wartości X-Foura-Request-Id zwracanej przez API. Zobacz Response Headers, aby uzyskać szczegóły.
Powiązane
- Metrics and Analytics: Zagregowane dane o wydajności w dłuższych okresach dla obu produktów
- Proxy Port: Produkt, którego dotyczą dane Proxy
- Playground: Ponowne wysyłanie żądań z Activity
- Response Headers: Pochodzenie identyfikatora żądania i punktów (credits)
- API Endpoints: Formaty zapytań i odpowiedzi
- Organizations: Zakres filtrowania Owner
- Troubleshooting: Częste problemy i rozwiązania