Dziennik aktywności
Dziennik aktywności pokazuje Twoje najnowsze żądania API w czasie rzeczywistym. Używaj go, aby debugować pojedyncze żądania, sprawdzać kody odpowiedzi i weryfikować działanie Twojej integracji.
Co zobaczysz
Dziennik wyświetla żądania z ostatniej godziny, z najnowszymi na górze. Dziewięć kolumn tworzy cały wiersz:
| Kolumna | Co pokazuje |
|---|---|
| Czas | Kiedy wykonano żądanie |
| Klucz | Który klucz API został użyty |
| Żądanie | Samo wywołanie: kolorowa kropka produktu (single, proxy lub browser), metoda HTTP i domena docelowa. Sortuje po domenie. |
| Status | Dwie wartości w jednej komórce, oddzielone ukośnikiem: status HTTP Twojego wywołania do FourA, a następnie status zwrócony przez cel. Znak minusa oznacza brak odpowiedzi od celu. |
| Wynik | Klasyfikacja żądania (Success, Client Error, Rate Limited i tak dalej) |
| Czas trwania | Całkowity czas odpowiedzi w milisekundach |
| Bajty | Transfer w obie strony w jednej komórce: strzałka w dół dla rozmiaru żądania, strzałka w górę dla odpowiedzi |
| Kredyty | Kredyty zużyte na wywołanie (zobacz Nagłówki odpowiedzi) |
| IP klienta | Adres, który wykonał żądanie |
Kliknij nagłówek dowolnej kolumny, aby posortować tabelę po tej kolumnie; kierunek zmienia się cyklicznie z malejącego na rosnący, a następnie się wyłącza. Kliknięcie z klawiszem Ctrl lub Cmd przywraca domyślne ustawienie (najnowsze na górze).
Filtrowanie
Trzy kontrolki zawężają dziennik.
Po kluczu API
Użyj listy rozwijanej kluczy API, aby pokazać żądania z jednego klucza. Na liście pojawiają się tylko klucze w Twoim zakresie dostępu.
Po produkcie
Filtruj do jednego endpointu za pomocą selektora single / proxy / browser. Przydatne, gdy chcesz debugować błędy występujące tylko w przeglądarce oddzielnie od żądań single.
Po limicie
Dziennik aktywności domyślnie pokazuje 50 wpisów. Użyj selektora limitu, aby zmienić liczbę wyświetlanych wpisów:
| Limit | Uwagi |
|---|---|
| 10 | Szybki skan |
| 50 | Domyślnie |
| 100 | Rozszerzony widok |
| 200 | Maksymalnie |
Wszystkie wpisy pochodzą z ostatniej godziny. W przypadku danych historycznych użyj sekcji Metryki, która agreguje dane z dni i tygodni.
Otwieranie żądania
Kliknij dowolny wiersz, aby otworzyć panel szczegółów z pełnym podglądem ładunku żądania i odpowiedzi. Panel otwiera się na meta siatce zbudowanej z samego wiersza, więc pozostaje przydatny nawet po wygaśnięciu zapisanego ładunku: znacznik czasu, klucz, status HTTP, status aplikacji, wynik, czas trwania, kredyty, proxy i X-FourA-Request-Id żądania.
Poniżej siatki wyświetlany jest jeden panel naraz, wybierany zakładką:
| Zakładka | Co pokazuje |
|---|---|
| Żądanie | Czytelnie sformatowany JSON z dokładnym wysłanym ciałem |
| Nagłówki odpowiedzi | Nagłówki zwrócone przez cel, z licznikiem na zakładce |
| Ciało odpowiedzi | Podgląd zapisanego ciała, z plakietkami uciętych i binarnych danych tam, gdzie mają zastosowanie |
| Inne pola | Wszystko inne, co zwrócił silnik poza statusem, czasami, proxy i nagłówkami. Ukryte, gdy nie ma nic dodatkowego. |
Przycisk Kopiuj kopiuje zawartość aktualnie otwartego panelu. Ładunki (payloads) są przechowywane przez 24 godziny, do 200 ostatnich żądań na klucz API. Wiersze starsze niż 24 godziny są wyświetlane bez ładunku.
Komunikaty panelu ładunku (Body)
Panel ładunku używa różnych komunikatów zastępczych w zależności od sytuacji:
| Komunikat | Znaczenie |
|---|---|
(no body — the request failed: <error>) |
Żądanie zakończyło się błędem zanim cel zwrócił odpowiedź (body) |
(no body captured for this request) |
Ładunek przedawnił się lub nie został zapisany |
(empty body — the server returned 0 bytes) |
Cel zwrócił pustą odpowiedź |
Otwórz w Playground
Okno szczegółów ma przycisk Otwórz w Playground. Kliknij go, aby załadować zarówno zarchiwizowane żądanie, jak i odpowiedź do formularza Playground. Stamtąd możesz zmodyfikować parametry i ponowić żądanie (replay) wobec aktywnego API lub po prostu przejrzeć otrzymaną odpowiedź bez ponownego uruchamiania żądania.
Przycisk jest wyłączony dla ładunków, których nie można odtworzyć (zbyt duże fragmenty żądań i trasy inne niż API), wraz ze wskazówką wyjaśniającą powód.
Używanie identyfikatora żądania (Request ID)
Każda odpowiedź API zawiera nagłówek X-Foura-Request-Id. Zaloguj go po swojej stronie, a następnie wklej go do zgłoszenia w dziale wsparcia, aby wskazać dokładne żądanie w Dzienniku aktywności. Identyfikator jest ten sam, co używany w tym oknie dialogowym, i zgadza się z X-Foura-Request-Id zwracanym przez API. Zobacz Nagłówki odpowiedzi, aby poznać szczegóły.
Zobacz również
- Metryki i analityka: Zbierane dane dotyczące wydajności za dłuższe okresy
- Playground: Ponawianie żądań (replay) z Aktywności
- Nagłówki odpowiedzi: Skąd bierze się identyfikator żądania i kredyty
- Punkty końcowe API: Kształty żądań i odpowiedzi
- Rozwiązywanie problemów: Typowe problemy i ich rozwiązania