Logo Performance HubPerformance Hub
Sekcja witryny: Dokumentacja

Dzienniki audytu

Na tej stronie

Dzienniki audytu to rejestr żądań wysyłanych do Performance Hub w Twojej organizacji. Obejmują żądania od osób korzystających z Performance Hub w przeglądarce lub w aplikacji oraz od połączonych narzędzi, takich jak klucze API, agenci AI połączeni przez MCP i Model Router. Korzystaj z nich, aby odpowiadać na pytania, takie jak kto otworzył drzwi, dlaczego zmiana nie została zapisana lub kiedy integracja przestała działać — niezależnie od tego, czy Twoje lokalizacje to biura, sklepy, kawiarnie, obiekty eventowe, przychodnie, kampusy czy siłownie.

Skrócone informacje

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

Kto może z nich 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: Sprawdzanie, kto co zrobił w Performance Hub, i ustalanie, dlaczego żądanie się nie powiodło

Panel Dzienniki audytu z przyciskiem Window, pięcioma głównymi wskaźnikami i wykresem Request TimelinePanel Dzienniki audytu z przyciskiem Window, pięcioma głównymi wskaźnikami i wykresem Request Timeline

Rysunek 1: Panel Dzienniki audytu: okno czasowe, główne wskaźniki i oś czasu żądań

Co jest rejestrowane

Każdy wpis w dzienniku to jedno żądanie wysłane do Performance Hub. Pokazuje:

  • Kto wysłał żądanie: adres e-mail użytkownika.
  • Skąd: adres IP oraz przeglądarkę lub narzędzie, które je wysłało.
  • Co zostało wywołane: metodę (na przykład GET do odczytu lub POST do tworzenia) i punkt końcowy, czyli część Performance Hub, której dotyczyło żądanie, na przykład /api/door-gate-access/doors/front-entrance/unlock.
  • Wynik: stan odpowiedzi, na przykład 200 w przypadku powodzenia lub 403, gdy osoba nie miała uprawnień.
  • Czas trwania w milisekundach.
  • Źródło: plakietkę źródła, na przykład web dla osoby korzystającej z Performance Hub lub api-key dla integracji. Zobacz Plakietki źródła.

W przypadku ostatnich żądań wpis w dzienniku zawiera też to, co zostało wysłane i co zostało zwrócone. Zobacz Odczytywanie wpisu w dzienniku.

Dwie karty

KartaDo czego służy
PanelSumy, wskaźniki błędów i wykresy dla okna czasowego wraz z najczęściej wywoływanymi punktami końcowymi i najaktywniejszymi użytkownikami. Kliknij wykres lub wiersz, aby otworzyć pasujące dzienniki.
LogsSame żądania. Filtruj i przeszukuj listę, otwórz wpis w dzienniku, aby zobaczyć jego szczegóły, i eksportuj dane do pliku CSV.

Kto może korzystać z Dzienników audytu

Potrzebujesz roli, która obejmuje Dzienniki audytu oraz Identity & Access Management w Twojej organizacji, takiej jak Organisation Administrator. Jeśli nie widzisz pozycji Dzienniki audytu w menu ustawień, Twoja rola jej nie obejmuje.

  • Które organizacje widzisz: organizacje, w których Twoja rola obejmuje zarówno Dzienniki audytu, jak i Identity & Access Management. Karta Logs pokazuje ich liczbę, na przykład "Viewing logs for 1 organisation".
  • Szablony ról: szablon Organisation Administrator obejmuje Dzienniki audytu. Szablony Site Manager i Site Owner ich nie obejmują. Zobacz Szablony ról.
  • Role niestandardowe: aby rola niestandardowa mogła korzystać z Dzienników audytu, uwzględnij w jej dostępie do modułów zarówno Dzienniki audytu, jak i Identity & Access Management. Zobacz Zakres dostępu i dostęp do modułów.

Dzienniki audytu pokazują adresy e-mail osób, adresy IP i to, co wysłały, dlatego przyznawaj do nich dostęp tylko osobom, które go potrzebują.

Jak długo przechowywane są dzienniki

Okres przechowywania dzienników audytu określa, jak długo są one przechowywane: 90 dni dla każdego wpisu w dzienniku i 7 dni dla pełnej treści jego żądania i odpowiedzi.

Menu Range na karcie Logs zawiera komunikat:

"Dzienniki audytu są przechowywane przez 90 dni. Pełne ładunki żądań i odpowiedzi są zachowywane przez 7 dni, po czym pozostaje krótki podgląd. Potrzebujesz dłuższej historii? Skontaktuj się z pomocą techniczną (mogą obowiązywać dodatkowe opłaty)."

Możesz więc sięgnąć 90 dni wstecz. Przez pierwsze 7 dni wpis w dzienniku zawiera pełne żądanie i odpowiedź. Później dłuższe treści są skracane do krótkiego podglądu. Zobacz Po 7 dniach: podglądy.

Co możesz zrobić

  • Odczytywać panel: sprawdzaj liczbę żądań, wskaźniki błędów oraz najczęściej wywoływane punkty końcowe i najaktywniejszych użytkowników w danym oknie czasowym.
  • Wyszukiwać żądania: filtruj według zakresu czasu, adresu e-mail, adresu IP, punktu końcowego, organizacji, obiektu, metody i stanu oraz udostępniaj przefiltrowany widok.
  • Odczytywać wpisy w dzienniku: sprawdzaj, kto wysłał żądanie, skąd oraz co zostało wysłane i zwrócone. W przypadku nieudanego żądania uzyskaj zrozumiałe podsumowanie błędu.
  • Eksportować dzienniki: pobieraj załadowane dzienniki jako plik CSV.
  • Korzystać z przykładów dochodzeń: odpowiedzi krok po kroku na typowe pytania, na przykład kto otworzył drzwi lub dlaczego integracja przestała synchronizować dane.
  • Często zadawane pytania