Performance Hub-logoPerformance Hub
Sitesectie: Documentatie

Auditlogboeken

Op deze pagina

Auditlogboeken is een overzicht van de aanvragen die in je organisatie naar Performance Hub zijn gedaan. Het omvat aanvragen van mensen die Performance Hub in een browser of de app gebruiken, en van verbonden tools zoals API-sleutels, AI-agents die via MCP zijn verbonden en de Model Router. Gebruik het om vragen te beantwoorden zoals wie een deur heeft ontgrendeld, waarom een wijziging niet is opgeslagen of wanneer een integratie niet meer werkte, of je locaties nu kantoren, winkels, cafés, evenementlocaties, klinieken, campussen of sportscholen zijn.

Snelle referentie

Waar je het vindt: Settings (tandwielpictogram, linksonder) → Auditlogboeken

Wie het kan gebruiken: Je hebt een rol nodig die Auditlogboeken en Identity & Access Management in je organisatie omvat, zoals Organisation Administrator. Zie Wie Auditlogboeken kan gebruiken.

Doel: Zien wie wat heeft gedaan in Performance Hub en uitzoeken waarom een aanvraag is mislukt

Het dashboard van Auditlogboeken, met de knop Window, vijf kerncijfers en de grafiek Request TimelineHet dashboard van Auditlogboeken, met de knop Window, vijf kerncijfers en de grafiek Request Timeline

Afbeelding 1: Het dashboard van Auditlogboeken: het tijdvenster, de kerncijfers en de tijdlijn van aanvragen

Wat er wordt vastgelegd

Elke logboekvermelding is één aanvraag die naar Performance Hub is gedaan. Deze toont:

  • Wie de aanvraag deed: het e-mailadres van de gebruiker.
  • Vanaf waar: het IP-adres en de browser of tool die de aanvraag verstuurde.
  • Wat er werd aangeroepen: de methode (bijvoorbeeld GET om te lezen of POST om aan te maken) en het endpoint, het deel van Performance Hub waarvoor de aanvraag bedoeld was, zoals /api/door-gate-access/doors/front-entrance/unlock.
  • Het resultaat: de responsstatus, bijvoorbeeld 200 bij succes of 403 wanneer de persoon geen toestemming had.
  • Hoe lang het duurde, in milliseconden.
  • Waar het vandaan kwam: een bronbadge, zoals web voor een persoon die Performance Hub gebruikt of api-key voor een integratie. Zie Bronbadges.

Voor recente aanvragen bevat de logboekvermelding ook wat er werd verstuurd en wat er terugkwam. Zie Een logboekvermelding lezen.

De twee tabbladen

TabbladWaarvoor het dient
DashboardTotalen, foutpercentages en grafieken voor een tijdvenster, met de drukste endpoints en gebruikers. Klik op een grafiek of rij om de bijbehorende logboeken te openen.
LogsDe aanvragen zelf. Filter en doorzoek de lijst, open een logboekvermelding om de details te bekijken en exporteer naar CSV.

Wie Auditlogboeken kan gebruiken

Je hebt een rol nodig die Auditlogboeken en Identity & Access Management in je organisatie omvat, zoals Organisation Administrator. Als je Auditlogboeken niet in het instellingenmenu ziet, bevat je rol het niet.

  • Welke organisaties je ziet: de organisaties waarin je rol zowel Auditlogboeken als Identity & Access Management omvat. Het tabblad Logs toont hoeveel, bijvoorbeeld "Viewing logs for 1 organisation".
  • Rolsjablonen: het sjabloon Organisation Administrator bevat Auditlogboeken. De sjablonen Site Manager en Site Owner bevatten het niet. Zie Rolsjablonen.
  • Aangepaste rollen: om een aangepaste rol Auditlogboeken te laten gebruiken, neem je zowel Auditlogboeken als Identity & Access Management op in de moduletoegang ervan. Zie Toegangsbereik en moduletoegang.

Auditlogboeken toont de e-mailadressen en IP-adressen van mensen en wat ze hebben verstuurd, dus geef het alleen aan mensen die het nodig hebben.

Hoe lang logboeken worden bewaard

De bewaartermijn van auditlogboeken bepaalt hoe lang auditlogboeken worden bewaard: 90 dagen voor elke logboekvermelding en 7 dagen voor de volledige payloads van aanvraag en respons.

Het menu Range op het tabblad Logs vermeldt:

"Auditlogboeken worden 90 dagen bewaard. Volledige request- en response-payloads worden 7 dagen bewaard, waarna er een korte preview bewaard blijft. Hebt u een langere geschiedenis nodig? Neem contact op met Support (hier zijn extra kosten aan verbonden)."

Je kunt dus 90 dagen terugkijken. De eerste 7 dagen bevat een logboekvermelding de volledige aanvraag en respons. Daarna wordt langere inhoud ingekort tot een korte preview. Zie Na 7 dagen: previews.

Wat je kunt doen

  • Het dashboard lezen: bekijk het aantal aanvragen, de foutpercentages en de drukste endpoints en gebruikers voor een tijdvenster.
  • Aanvragen zoeken: filter op tijdsbereik, e-mailadres, IP-adres, endpoint, organisatie, faciliteit, methode en status, en deel een gefilterde weergave.
  • Een logboekvermelding lezen: bekijk wie een aanvraag deed, vanaf waar, en wat er werd verstuurd en teruggegeven. Krijg voor een mislukte aanvraag een begrijpelijke samenvatting van de fout.
  • Logboeken exporteren: download de geladen logboeken als CSV-bestand.
  • Een voorbeeldonderzoek volgen: stapsgewijze antwoorden op veelgestelde vragen, zoals wie een deur heeft ontgrendeld of waarom een integratie niet meer synchroniseert.
  • Veelgestelde vragen