Dziennik aktywności
Dziennik aktywności (Activity Log) pokazuje Twoje najnowsze requesty API w czasie rzeczywistym. Użyj go, aby debugować pojedyncze requesty, sprawdzać kody response i weryfikować, czy Twoja integracja działa.
Co zobaczysz
Log wyświetla requesty wysłane w ciągu ostatniej godziny, z najnowszymi na samej górze. Każdy wpis zawiera:
| Pole | Opis |
|---|---|
| Timestamp | Czas wykonania requestu |
| Metoda | Metoda HTTP wysłana do celu (GET, POST itp.) |
| Route | Który endpoint FourA został użyty (single, proxy lub browser) |
| Domena | Domena docelowa wyodrębniona z URL requestu |
| Status | Kod statusu HTTP zwrócony przez cel |
| Status aplikacji | Status na poziomie aplikacji zwrócony w body response |
| Wynik | Klasyfikacja requestu (success, client_error, rate_limit itp.) |
| Czas trwania | Całkowity czas response w milisekundach |
| Bajty wejściowe | Rozmiar payloadu requestu |
| Bajty wyjściowe | Rozmiar payloadu response |
| Nazwa klucza | Który klucz API został użyty |
| IP klienta | Adres IP, z którego wykonano request |
Filtrowanie
Trzy elementy sterujące pozwalają zawęzić log.
Według klucza API
Użyj rozwijanej listy kluczy API, aby pokazać requesty dla jednego klucza. Na liście pojawią się tylko te klucze, do których masz dostęp.
Według produktu
Filtruj do jednego endpointu za pomocą selektora single / proxy / browser. Przydatne, gdy chcesz debugować błędy dotyczące wyłącznie przeglądarki (browser-only) oddzielnie od pojedynczych requestów.
Według limitu
Dziennik aktywności domyślnie pokazuje 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. Dane historyczne znajdziesz w sekcji Metrics, która agreguje dane z wielu dni i tygodni.
Otwieranie requestu
Kliknij dowolny wiersz, aby otworzyć okno szczegółów z pełnym podglądem payloadu requestu i response. Okno zawiera:
- Siatkę metadanych: timestamp, klucz, status HTTP, status aplikacji, wynik, czas trwania oraz nagłówek
X-Foura-Request-Idrequestu. - Request: sformatowany JSON (pretty-print) dokładnie wysłanego body, wraz z przyciskiem Kopiuj.
- Response: pasek metadanych oraz podgląd body, z odpowiednimi etykietami (badges) oznaczającymi skrócenie (truncated) lub dane binarne (binary).
Payloady są przechowywane przez 24 godziny, z limitem do ostatnich 200 na klucz API. Dla starszych wierszy wyświetlany jest tylko sam wpis, bez okna szczegółów.
Komunikaty w panelu Body
Panel body wyświetla różne komunikaty zastępcze w zależności od tego, co się stało:
| Komunikat | Co oznacza |
|---|---|
(no body — the request failed: <error>) |
Wystąpił błąd requestu, zanim cel zwrócił body |
(no body captured) |
Payload wygasł lub nie został zapisany |
(empty body — the server returned 0 bytes) |
Cel zwrócił rzeczywiście pusty response |
Otwórz 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. Stamtąd możesz dostosować parametry i powtórzyć żądanie do żywego API lub po prostu sprawdzić, co zostało zwrócone, bez ponownego uruchamiania requestu.
Przycisk jest wyłączony dla payloadów, których nie można powtórzyć (zbyt duże fragmenty requestów oraz ścieżki inne niż API), wraz z podpowiedzią wyjaśniającą przyczynę.
Użycie Request ID
Każdy response API zawiera nagłówek X-Foura-Request-Id. Zapisz go w swoich logach, a w razie potrzeby będziesz mógł wkleić go do zgłoszenia pomocy technicznej, aby wskazać dokładny request w Dzienniku aktywności. Identyfikator jest taki sam jak ten używany w oknie szczegółów i odpowiada wartości X-Foura-Request-Id zwróconej przez API. Szczegółowe informacje znajdziesz w dokumentacji API Endpoints.
Powiązane
- Metrics and Analytics: Agregowane dane o wydajności z dłuższych okresów
- Playground: Powtarzaj requesty z poziomu aktywności
- API Endpoints: Struktura requestów i response'ów, w tym nagłówek ID requestu
- Troubleshooting: Typowe problemy i rozwiązania