Karta Request logs w
Developer Hub przedstawia ruch API /v1 w Państwa
organizacji: statystyki podsumowujące z ostatnich 24 godzin —
liczbę żądań, odsetek błędów i liczbę żądań objętych limitem szybkości — nad przeszukiwalnym
dziennikiem poszczególnych żądań.
Co rejestruje każdy wpis
Tabela dziennika zawiera czas, metodę HTTP, ścieżkę, status odpowiedzi, decyzję zasad,
opóźnienie i identyfikator żądania każdego wywołania. Otwarcie wpisu wyświetla
pełne szczegóły, w tym konto usługi i klucz API, które wykonały wywołanie,
źródłowy adres IP oraz uprawnienia obowiązujące w momencie wywołania.
Decyzja zasad informuje, w jaki sposób żądanie zostało obsłużone:
- Allowed — żądanie zostało uwierzytelnione i autoryzowane.
- Denied — żądanie zostało odrzucone, na przykład dlatego, że klucz nie miał
wymaganego uprawnienia, wygasł lub został unieważniony.
- Rate limited — żądanie przekroczyło limit żądań i zostało odrzucone
z kodem
429. Zobacz limity szybkości.
Filtrowanie i wyszukiwanie
Zawęź dziennik według konta usługi, klucza API, metody HTTP, klasy statusu
(2xx–5xx), decyzji zasad, zakresu czasu lub prefiksu ścieżki (na przykład
/v1/entities).
Śledzenie błędu według identyfikatora żądania
Każda odpowiedź API zawiera nagłówek Request-Id, a każda treść błędu
zawiera tę samą wartość w polu request_id. Wklej tę wartość w polu wyszukiwania
dziennika żądań, aby od razu przejść do odpowiedniego wpisu i zobaczyć dokładnie,
jak żądanie zostało obsłużone.
Gdy integracja zgłasza błąd, poproś o wartość request_id z
odpowiedzi z błędem. To najszybsza droga od objawu po stronie klienta do
miarodajnego zapisu tego, co się wydarzyło — a także wartość, którą należy podać
w kontakcie z pomocą techniczną Living Security.
Wczesne wykrywanie problemów
- Rosnący odsetek błędów zwykle oznacza, że klucz wygasł, został unieważniony lub utracił
wymagane uprawnienie — przefiltruj według decyzji, aby znaleźć wadliwe poświadczenie.
- Rosnąca liczba żądań Rate limited oznacza, że obciążenie jest zbyt intensywne; strategie
wygładzania ruchu opisano w sekcji limity szybkości.
- Ruch z konta usługi, które powinno być nieaktywne, jest sygnałem, by sprawdzić,
czy jego poświadczenia znajdują się tam, gdzie Państwo zakładają — oraz by
wyłączyć konto na czas
prowadzenia analizy.