Performance Hub-logoPerformance Hub
Sitesectie: Documentatie

Aanvragen zoeken

Op deze pagina

Het tabblad Logs toont de aanvragen die in je organisatie zijn gedaan, de nieuwste eerst. Gebruik de filters bovenaan om de lijst te beperken tot één persoon, één IP-adres, één onderdeel van Performance Hub of één soort resultaat, en klik vervolgens op een aanvraag om de details ervan te bekijken.

Snelle referentie

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

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: De aanvragen vinden achter een vraag, zoals wie iets heeft gewijzigd of waarom iets is mislukt

Het tabblad Logs, met de filterbalk bovenaan, een lijst met aanvragen links en de details van de geselecteerde aanvraag rechtsHet tabblad Logs, met de filterbalk bovenaan, een lijst met aanvragen links en de details van de geselecteerde aanvraag rechts

Afbeelding 1: Het tabblad Logs: filters bovenaan, overeenkomende aanvragen links en de geselecteerde aanvraag rechts

Het tabblad Logs

  • Filterbalk: de filters bovenaan, met Live, vernieuwen en CSV exporteren aan de rechterkant.
  • Lijst: de overeenkomende aanvragen, de nieuwste eerst. Erboven staat "Viewing logs for 1 organisation" (of het aantal organisaties dat je kunt zien). Elke rij toont de statuscode, de methode, de bronbadge, de datum en tijd, het endpoint, het e-mailadres van de gebruiker en de responstijd in milliseconden.
  • Details: de aanvraag die je hebt geselecteerd. Zie Een logboekvermelding lezen.

De lijst laadt meer aanvragen terwijl je scrolt. Aan het einde van de lijst staat hoeveel aanvragen overeenkwamen, bijvoorbeeld "End of results · 5 logs".

De lijst filteren

  1. Klik op een filter in de filterbalk, bijvoorbeeld Endpoint.
  2. Kies een optie of typ een waarde. Typ bijvoorbeeld /api/door-gate-access/* in Endpoint en klik op Apply.
  3. Het filter toont de waarde die je hebt gekozen en de lijst wordt bijgewerkt. Voeg meer filters toe om verder te beperken: een aanvraag moet aan elk filter voldoen om te verschijnen.
  4. Klik op de × van een filter om dat filter te verwijderen. Klik op Clear, dat verschijnt zodra er een filter is ingesteld, om ze allemaal te verwijderen.

De filterbalk: Range, Email, IP, Endpoint, Org, Faciliteit, Method en Status, gevolgd door Live, vernieuwen en CSV exporterenDe filterbalk: Range, Email, IP, Endpoint, Org, Faciliteit, Method en Status, gevolgd door Live, vernieuwen en CSV exporteren

Afbeelding 2: De filterbalk: Range, Email, IP, Endpoint, Org, Faciliteit, Method en Status, gevolgd door Live, vernieuwen en CSV exporteren

FilterWaar het op filtert
RangeHet tijdstip waarop de aanvraag is gedaan. De standaardwaarde is Last 24 hours. Zie Range.
EmailHet volledige e-mailadres van de gebruiker, bijvoorbeeld priya.shah@example.com. Tijdens het typen kunnen adressen worden voorgesteld.
IPHet volledige IP-adres waar de aanvraag vandaan kwam, bijvoorbeeld 203.0.113.140
EndpointHet onderdeel van Performance Hub waarvoor de aanvraag bedoeld was. Elk deel van het pad komt overeen en je kunt een jokerteken * gebruiken. Zie Endpoint en jokertekens.
OrgEén organisatie, of Any org. Wordt getoond wanneer je toegang hebt tot ten minste één organisatie.
FaciliteitEén faciliteit, of Elke faciliteit. Wordt getoond wanneer je toegang hebt tot ten minste één faciliteit.
MethodGET, POST, PUT, PATCH of DELETE
StatusDe responsstatus. Zie Status.

Email en IP hebben de volledige waarde nodig

Email en IP vinden alleen exacte overeenkomsten. Typ het volledige e-mailadres, zoals ruby.castellano@example.com, of het volledige IP-adres. Een deel van een adres, zoals ruby of 203.0.113, levert niets op.

Gebruik Top Users op het dashboard om iemand te vinden zonder het volledige adres, of open een van diens aanvragen en kopieer het adres uit het veld User.

Bereik

Klik op Range om te kiezen hoe ver je terugkijkt.

  • Voorinstellingen: Last 15 minutes, Last hour, Last 12 hours, Last 24 hours, Last 7 days, Last 30 days en Last 90 days.
  • Datums: kies een begin- en einddatum in de kalender met twee maanden en klik op Apply. Klik op Cancel om het menu te sluiten zonder het bereik te wijzigen. Datums van meer dan 90 dagen geleden kunnen niet worden gekozen.

De opmerking onder in het menu vermeldt hoe lang logboeken worden bewaard: "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)."

Het menu Range geopend, met voorinstellingen van Last 15 minutes tot Last 90 days, een kalender met twee maanden en de opmerking over hoe lang logboeken worden bewaardHet menu Range geopend, met voorinstellingen van Last 15 minutes tot Last 90 days, een kalender met twee maanden en de opmerking over hoe lang logboeken worden bewaard

Afbeelding 3: Range: kies een voorinstelling of datums in de kalender. De opmerking toont hoe lang logboeken worden bewaard

Endpoint en jokertekens

Het endpoint is het pad waarnaar de aanvraag is verstuurd, zoals /api/door-gate-access/doors/front-entrance/unlock. Het vertelt je voor welk onderdeel van Performance Hub de aanvraag bedoeld was.

  • Zonder * komt elk deel van het pad overeen. unlock vindt bijvoorbeeld elke aanvraag met "unlock" in het pad.
  • Met * moet elk stuk tussen de sterretjes in het pad voorkomen. /api/door-gate-access/* vindt bijvoorbeeld elke aanvraag van Door & Gate Access, en /partner/v1/* vindt elke aanvraag van een integratie die de Partner API gebruikt.

Het filter Endpoint geopend, met /api/door-gate-access/* ingetypt en de knoppen Cancel en ApplyHet filter Endpoint geopend, met /api/door-gate-access/* ingetypt en de knoppen Cancel en Apply

Afbeelding 4: Endpoint accepteert een jokerteken *, bijvoorbeeld voor elke deuraanvraag

Het tabblad Logs gefilterd op /api/door-gate-access/*, met vijf deuraanvragen waarvan de eerste is geopendHet tabblad Logs gefilterd op /api/door-gate-access/*, met vijf deuraanvragen waarvan de eerste is geopend

Afbeelding 5: De lijst na filteren op een endpointpatroon

Weet je niet welk endpoint je moet gebruiken? Open een aanvraag die je kent, zoals een deur die je zelf hebt ontgrendeld, en kopieer het begin van het endpoint uit de details.

Status

Klik op Status om te filteren op de responsstatus. Typ in Search… om snel een status te vinden, bijvoorbeeld "403". Kies Any om elke status te tonen.

Statussen worden met hun naam vermeld, zoals 200 OK, 201 Created, 400 Bad Request, 401 Unauthorised, 403 Forbidden, 404 Not Found, 409 Conflict, 429 Too Many Requests, 500 Server Error en 503 Service Unavailable. Zie Statuscodes voor wat ze betekenen.

Het menu Status geopend, met een zoekvak, Any en statussen van 200 OK tot 401 UnauthorisedHet menu Status geopend, met een zoekvak, Any en statussen van 200 OK tot 401 Unauthorised

Afbeelding 6: Filteren op responsstatus

Live en vernieuwen

Op het tabblad Logs staat Live standaard op Off, zodat de lijst stil blijft staan terwijl je onderzoekt. Schakel het in en kies hoe vaak de lijst wordt vernieuwd om nieuwe aanvragen binnen te zien komen. Klik op de vernieuwknop (de ronde pijlen) om de lijst één keer opnieuw te laden.

Een gefilterde weergave delen of als bladwijzer opslaan

Je filters worden opgeslagen in het paginaadres. Sla de pagina op als bladwijzer om terug te keren naar dezelfde weergave, of stuur het adres naar een collega. Die ziet dezelfde gefilterde lijst als hij of zij toegang heeft tot Auditlogboeken en tot dezelfde organisatie.

Een adres dat eindigt op /audit-logs/logs?email=priya.shah%40example.com opent bijvoorbeeld de lijst gefilterd op die persoon, en een adres dat eindigt op /audit-logs/logs?endpoint=%2Fapi%2Fdoor-gate-access%2F* opent elke deuraanvraag.

Door de lijst navigeren

  • Klik op een aanvraag om de details ervan rechts te openen.
  • Gebruik de pijltoetsen omhoog en omlaag om naar de vorige of volgende aanvraag in de lijst te gaan.
  • Op een smal scherm openen de details over de lijst heen. Klik op de sluitknop om terug te gaan naar de lijst.

Geen resultaten

Als er niets overeenkomt, staat in de lijst "No logs match these filters" en "Try widening the time range or clearing a filter."

Het tabblad Logs met een Email-filter ingesteld, met de melding No logs match these filtersHet tabblad Logs met een Email-filter ingesteld, met de melding No logs match these filters

Afbeelding 7: Geen aanvragen komen overeen: vergroot het bereik of verwijder een filter

Zo vind je wat je zoekt:

  • Kies een langer Range, zoals Last 7 days.
  • Controleer of Email en IP het volledige adres bevatten. Een deel van een adres levert niets op.
  • Verwijder één filter tegelijk met de × ervan, of klik op Clear.