Logo Performance HubPerformance Hub
Sekcja witryny: Dokumentacja

Wyszukiwanie żądań

Na tej stronie

Karta Logs zawiera listę żądań wysłanych w Twojej organizacji, od najnowszych. Użyj filtrów u góry, aby zawęzić listę do jednej osoby, jednego adresu IP, jednej części Performance Hub lub jednego rodzaju wyniku, a następnie kliknij żądanie, aby zobaczyć jego szczegóły.

Skrócone informacje

Gdzie to znaleźć: Settings (ikona koła zębatego w lewym dolnym rogu) → Dzienniki audytu → Logs

Kto może z tego korzystać: Potrzebujesz roli, która obejmuje Dzienniki audytu oraz Identity & Access Management w Twojej organizacji, takiej jak Organisation Administrator. Zobacz Kto może korzystać z Dzienników audytu.

Cel: Znajdowanie żądań stojących za pytaniem, na przykład kto coś zmienił lub dlaczego coś się nie powiodło

Karta Logs z paskiem filtrów u góry, listą żądań po lewej stronie i szczegółami wybranego żądania po prawejKarta Logs z paskiem filtrów u góry, listą żądań po lewej stronie i szczegółami wybranego żądania po prawej

Rysunek 1: Karta Logs: filtry u góry, pasujące żądania po lewej stronie i wybrane żądanie po prawej

Karta Logs

  • Pasek filtrów: filtry u góry, a po prawej stronie przełącznik Live, przycisk odświeżania i przycisk Eksportuj CSV.
  • Lista: pasujące żądania, od najnowszych. Nad nią widnieje komunikat "Viewing logs for 1 organisation" (lub liczba organizacji, które widzisz). Każdy wiersz pokazuje kod stanu, metodę, plakietkę źródła, datę i godzinę, punkt końcowy, adres e-mail użytkownika oraz czas odpowiedzi w milisekundach.
  • Szczegóły: wybrane żądanie. Zobacz Odczytywanie wpisu w dzienniku.

Lista wczytuje kolejne żądania podczas przewijania. Na końcu listy wyświetla, ile żądań pasowało, na przykład "End of results · 5 logs".

Filtrowanie listy

  1. Kliknij filtr na pasku filtrów, na przykład Endpoint.
  2. Wybierz opcję lub wpisz wartość. Na przykład wpisz /api/door-gate-access/* w polu Endpoint i kliknij Apply.
  3. Filtr pokazuje wybraną wartość, a lista się aktualizuje. Dodaj kolejne filtry, aby jeszcze bardziej ją zawęzić: żądanie musi pasować do każdego filtra, aby się pojawiło.
  4. Aby usunąć jeden filtr, kliknij na nim ×. Aby usunąć wszystkie, kliknij Clear — przycisk ten pojawia się po ustawieniu dowolnego filtra.

Pasek filtrów: Range, Email, IP, Endpoint, Org, Obiekt, Method i Status, a następnie Live, odświeżanie i Eksportuj CSVPasek filtrów: Range, Email, IP, Endpoint, Org, Obiekt, Method i Status, a następnie Live, odświeżanie i Eksportuj CSV

Rysunek 2: Pasek filtrów: Range, Email, IP, Endpoint, Org, Obiekt, Method i Status, a następnie Live, odświeżanie i Eksportuj CSV

FiltrDo czego dopasowuje
RangeCzas wysłania żądania. Domyślnie jest to Last 24 hours. Zobacz Range.
EmailPełny adres e-mail użytkownika, na przykład priya.shah@example.com. Podczas wpisywania mogą pojawiać się podpowiedzi adresów.
IPPełny adres IP, z którego pochodzi żądanie, na przykład 203.0.113.140
EndpointCzęść Performance Hub, której dotyczyło żądanie. Dopasowuje dowolny fragment ścieżki i można użyć symbolu wieloznacznego *. Zobacz Punkt końcowy i symbole wieloznaczne.
OrgJedna organizacja lub Any org. Wyświetlany, gdy masz dostęp do co najmniej jednej organizacji.
ObiektJeden obiekt lub Dowolny obiekt. Wyświetlany, gdy masz dostęp do co najmniej jednego obiektu.
MethodGET, POST, PUT, PATCH lub DELETE
StatusStan odpowiedzi. Zobacz Status.

Pola Email i IP wymagają pełnej wartości

Filtry Email i IP znajdują tylko dokładne dopasowania. Wpisz cały adres e-mail, na przykład ruby.castellano@example.com, lub cały adres IP. Fragment adresu, na przykład ruby lub 203.0.113, nie daje żadnych wyników.

Aby znaleźć osobę bez znajomości jej pełnego adresu, użyj sekcji Top Users na panelu albo otwórz jedno z jej żądań i skopiuj adres z pola User.

Zakres

Kliknij Range, aby wybrać, jak daleko wstecz chcesz sięgnąć.

  • Ustawienia wstępne: Last 15 minutes, Last hour, Last 12 hours, Last 24 hours, Last 7 days, Last 30 days i Last 90 days.
  • Daty: wybierz datę początkową i końcową w kalendarzu obejmującym dwa miesiące, a następnie kliknij Apply. Kliknij Cancel, aby zamknąć menu bez zmiany zakresu. Nie można wybrać dat sprzed ponad 90 dni.

Komunikat u dołu menu informuje, jak długo przechowywane są dzienniki: "Audit logs are kept for 90 days. Full request and response payloads are kept for 7 days, after which a short preview remains. Need a longer history? Contact Support (additional charges apply)."

Otwarte menu Range z ustawieniami wstępnymi od Last 15 minutes do Last 90 days, kalendarzem obejmującym dwa miesiące i komunikatem o czasie przechowywania dziennikówOtwarte menu Range z ustawieniami wstępnymi od Last 15 minutes do Last 90 days, kalendarzem obejmującym dwa miesiące i komunikatem o czasie przechowywania dzienników

Rysunek 3: Range: wybierz ustawienie wstępne lub daty w kalendarzu. Komunikat informuje, jak długo przechowywane są dzienniki

Punkt końcowy i symbole wieloznaczne

Punkt końcowy to ścieżka, do której wysłano żądanie, na przykład /api/door-gate-access/doors/front-entrance/unlock. Informuje, której części Performance Hub dotyczyło żądanie.

  • Bez * dopasowywany jest dowolny fragment ścieżki. Na przykład unlock znajduje każde żądanie, które ma "unlock" w ścieżce.
  • Z * każdy fragment między gwiazdkami musi występować w ścieżce. Na przykład /api/door-gate-access/* znajduje każde żądanie Door & Gate Access, a /partner/v1/* znajduje każde żądanie z integracji korzystającej z Partner API.

Otwarty filtr Endpoint z wpisaną wartością /api/door-gate-access/* oraz przyciskami Cancel i ApplyOtwarty filtr Endpoint z wpisaną wartością /api/door-gate-access/* oraz przyciskami Cancel i Apply

Rysunek 4: Filtr Endpoint akceptuje symbol wieloznaczny *, na przykład dla wszystkich żądań dotyczących drzwi

Karta Logs przefiltrowana według /api/door-gate-access/*, z listą pięciu żądań dotyczących drzwi i otwartym pierwszym z nichKarta Logs przefiltrowana według /api/door-gate-access/*, z listą pięciu żądań dotyczących drzwi i otwartym pierwszym z nich

Rysunek 5: Lista po przefiltrowaniu według wzorca punktu końcowego

Nie wiesz, jakiego punktu końcowego użyć? Otwórz znane Ci żądanie, na przykład dotyczące drzwi, które sam(a) odblokowałeś(-aś), i skopiuj początek jego punktu końcowego ze szczegółów.

Status

Kliknij Status, aby filtrować według stanu odpowiedzi. Wpisz wartość w polu Search…, aby szybko znaleźć stan, na przykład "403". Wybierz Any, aby wyświetlić wszystkie stany.

Stany są wyświetlane wraz z nazwami, na przykład 200 OK, 201 Created, 400 Bad Request, 401 Unauthorised, 403 Forbidden, 404 Not Found, 409 Conflict, 429 Too Many Requests, 500 Server Error i 503 Service Unavailable. Ich znaczenie opisano w sekcji Kody stanu.

Otwarte menu Status z polem wyszukiwania, opcją Any i stanami od 200 OK do 401 UnauthorisedOtwarte menu Status z polem wyszukiwania, opcją Any i stanami od 200 OK do 401 Unauthorised

Rysunek 6: Filtrowanie według stanu odpowiedzi

Live i odświeżanie

Na karcie Logs przełącznik Live jest domyślnie ustawiony na Off, dzięki czemu lista nie zmienia się podczas dochodzenia. Włącz go i wybierz częstotliwość odświeżania listy, aby obserwować napływające nowe żądania. Kliknij przycisk odświeżania (okrągłe strzałki), aby jednorazowo wczytać listę ponownie.

Udostępnianie przefiltrowanego widoku lub dodawanie go do zakładek

Filtry są zapisywane w adresie strony. Dodaj stronę do zakładek, aby wrócić do tego samego widoku, lub wyślij adres współpracownikowi. Zobaczy on tę samą przefiltrowaną listę, jeśli ma dostęp do Dzienników audytu i do tej samej organizacji.

Na przykład adres kończący się na /audit-logs/logs?email=priya.shah%40example.com otwiera listę przefiltrowaną do tej osoby, a adres kończący się na /audit-logs/logs?endpoint=%2Fapi%2Fdoor-gate-access%2F* otwiera wszystkie żądania dotyczące drzwi.

Poruszanie się po liście

  • Kliknij żądanie, aby otworzyć jego szczegóły po prawej stronie.
  • Użyj klawiszy strzałek w górę i w dół, aby przejść do poprzedniego lub następnego żądania na liście.
  • Na wąskim ekranie szczegóły otwierają się nad listą. Kliknij przycisk zamykania, aby wrócić do listy.

Brak wyników

Jeśli nic nie pasuje, lista wyświetla komunikaty "No logs match these filters" i "Try widening the time range or clearing a filter."

Karta Logs z ustawionym filtrem Email i komunikatem No logs match these filtersKarta Logs z ustawionym filtrem Email i komunikatem No logs match these filters

Rysunek 7: Brak pasujących żądań: rozszerz zakres lub wyczyść filtr

Aby znaleźć to, czego szukasz:

  • Wybierz dłuższy zakres w filtrze Range, na przykład Last 7 days.
  • Sprawdź, czy pola Email i IP zawierają cały adres. Fragment adresu nie daje żadnych wyników.
  • Usuwaj filtry pojedynczo za pomocą ich przycisku × lub kliknij Clear.