Een logboekvermelding lezen

Op deze pagina

Klik op een aanvraag in de lijst op het tabblad Logs om de details ervan rechts te openen. De details tonen wanneer de aanvraag is gedaan, door wie en vanaf waar, wat er werd verstuurd en wat er terugkwam. Voor een mislukte aanvraag kun je ook een samenvatting van de fout in gewone taal opvragen.

Snelle referentie

Waar je het vindt: Settings (tandwielpictogram, linksonder) → Auditlogboeken → Logs, en klik vervolgens op een aanvraag

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: Precies zien wat er bij één aanvraag is gebeurd

Een logboekvermelding openen

  1. Filter de lijst op het tabblad Logs tot de aanvragen die je nodig hebt.
  2. Klik op een aanvraag. De details ervan openen rechts en de aanvraag wordt in de lijst gemarkeerd.
  3. Gebruik de pijltoetsen omhoog en omlaag om door de lijst te bladeren zonder de details te verlaten.

Boven in de details worden de status, de methode, de bronbadge en het endpoint herhaald.

De details van een logboekvermelding: tijdstempel, responstijd, aanvraag-ID, IP-adres, gebruiker, referer, user agent, faciliteit en organisatie, gevolgd door de bodies van aanvraag en responsDe details van een logboekvermelding: tijdstempel, responstijd, aanvraag-ID, IP-adres, gebruiker, referer, user agent, faciliteit en organisatie, gevolgd door de bodies van aanvraag en respons

Afbeelding 1: Een logboekvermelding: wanneer het gebeurde, wie de aanvraag deed, vanaf waar, en de bodies van aanvraag en respons

De velden

De velden worden in Performance Hub in hoofdletters getoond, in deze volgorde:

VeldWat het toont
TimestampDe datum en tijd van de aanvraag
Response TimeHoe lang Performance Hub nodig had om te reageren, in milliseconden
Request IDEen unieke ID voor deze aanvraag. Klik op de kopieerknop om deze te kopiëren, bijvoorbeeld om door te geven aan Support.
IP AddressHet IP-adres waar de aanvraag vandaan kwam
UserHet e-mailadres van de persoon die de aanvraag deed
RefererDe pagina van waaruit de aanvraag is gedaan, als die er is
User AgentDe browser, app of tool die de aanvraag verstuurde
FaciliteitDe faciliteit waarvoor de aanvraag bedoeld was, als "Naam (id)", bijvoorbeeld Lower Manhattan en de faciliteit-ID ervan
OrganisatieDe organisatie, als "Naam (id)"

Aanvraag en respons

Onder de velden staan de bodies van de aanvraag, als die er zijn:

SectieWat het toont
Request POST BodyWat er werd verstuurd, bijvoorbeeld de opgegeven reden voor het ontgrendelen van een deur of de nieuwe openingstijden van een faciliteit. De kop luidt "Request POST Body" voor elke methode die een body verstuurt.
Response BodyWat Performance Hub terugstuurde, inclusief eventuele foutmeldingen
Query ParametersOpties die aan de aanvraag zijn toegevoegd, zoals een paginanummer of een faciliteit

Klik op Copy section (het kopieerpictogram rechtsboven in een sectie) om de inhoud ervan te kopiëren, bijvoorbeeld om in een ondersteuningsverzoek te plakken.

Als een aanvraag niets te tonen had, staat in de details "No request/response payloads recorded for this entry." Veel GET-aanvragen, die alleen informatie lezen, hebben geen aanvraagbody.

AI-foutenoverzicht

Voor een mislukte aanvraag, met een status van 400 of hoger, bevatten de details een sectie AI Error Summary.

  1. Klik op Generate summary.
  2. Lees de samenvatting. Deze legt in gewone taal uit wat er misging en wat je vervolgens kunt doen.

De AI Error Summary voor een 403-aanvraag, die uitlegt dat de persoon die de wijziging aanbracht geen toestemming had om de rol toe te wijzenDe AI Error Summary voor een 403-aanvraag, die uitlegt dat de persoon die de wijziging aanbracht geen toestemming had om de rol toe te wijzen

Afbeelding 2: Voor een mislukte aanvraag legt Generate summary de fout uit in gewone taal

  • De samenvatting wordt alleen gegenereerd wanneer je op Generate summary klikt. Zodra een samenvatting is gegenereerd, kan deze een tag cached tonen.
  • De samenvatting wordt door AI gegenereerd en kan onjuist zijn. Vergelijk deze met de Response Body, die het bericht bevat dat Performance Hub daadwerkelijk heeft teruggegeven.
  • Als de samenvatting niet kan worden gegenereerd, vraagt een waarschuwing je het later opnieuw te proberen. Lees in de tussentijd de Response Body.

Na 7 dagen: previews

Volledige bodies van aanvraag en respons worden 7 dagen bewaard. Daarna worden langere bodies ingekort tot een korte preview en staat in de details "Full request and response payloads are kept for 7 days. Showing a preview for this log." Korte bodies die in de preview passen, blijven volledig behouden.

De rest van de logboekvermelding, zoals wie de aanvraag deed, wanneer en het resultaat, wordt 90 dagen bewaard.

Een logboekvermelding ouder dan 7 dagen, met de previewmelding en ingekorte bodies van aanvraag en responsEen logboekvermelding ouder dan 7 dagen, met de previewmelding en ingekorte bodies van aanvraag en respons

Afbeelding 3: Na 7 dagen blijft alleen een korte preview van de aanvraag en respons over

Als je de volledige bodies later misschien nodig hebt, open je de aanvraag en gebruik je Copy section binnen 7 dagen. Een CSV-export bevat de bodies niet.

Statuscodes

De status staat vooraan in elke rij. Het eerste cijfer vertelt je wat voor resultaat het is:

StatusBetekenisVoorbeelden
2xxGeslaagd200 OK, 201 Created
3xxOmleiding: de aanvraag is ergens anders heen gestuurd301 Moved
4xxEen probleem met de aanvraag, bijvoorbeeld geen toestemming of ongeldige invoer400 Bad Request (een waarde was ongeldig), 401 Unauthorised (niet aangemeld), 403 Forbidden (geen toestemming), 404 Not Found, 409 Conflict (de aanvraag botste met de huidige toestand, zoals een deur in onderhoudsmodus), 429 Too Many Requests (te veel aanvragen in korte tijd)
5xxEen serverfout500 Server Error, 502 Bad Gateway, 503 Service Unavailable

Bronbadges

Elke aanvraag heeft een bronbadge die aangeeft waar deze vandaan kwam:

BadgeWaar de aanvraag vandaan kwam
webIemand die Performance Hub gebruikt in een browser of de app
api-keyEen integratie die een API-sleutel gebruikt, zoals een boekings- of ledensysteem. Zie Authenticatie van de Partner API.
mcpEen AI-agent of AI-client die via MCP is verbonden. Zie Gebruik met AI.
model-routerDe Model Router
websocketEen liveverbinding, zoals een realtime update
guest-tokenEen gastlink

Er kunnen ook andere badges verschijnen.