Logo di Performance HubPerformance Hub
Sezione del sito: Documentazione

Esempi di indagine

In questa pagina

Questi esempi mostrano come rispondere a domande comuni con Registri di controllo. Ognuno indica la domanda, i filtri e i clic da usare e cosa cercare. Gli stessi passaggi funzionano in qualsiasi tipo di sede, quindi adatta i filtri alla tua domanda.

Riferimento rapido

Dove trovarlo: Settings (icona a forma di ingranaggio, in basso a sinistra) → Registri di controllo

Chi può usarlo: ti serve un ruolo che includa Registri di controllo e Identity & Access Management nella tua organizzazione, come Organisation Administrator. Vedi Chi può usare Registri di controllo.

Scopo: passare da una domanda alle richieste che le danno risposta

Chi ha sbloccato l'ingresso principale?

Una palestra o un centro ricreativo: l'ingresso principale è stato sbloccato da remoto e il responsabile di turno vuole sapere chi l'ha fatto e perché.

  1. Nella scheda Logs, fai clic su Endpoint, digita /api/door-gate-access/* e fai clic su Apply. L'elenco mostra solo le richieste di Door & Gate Access.
  2. Imposta Range in modo da includere il momento dello sblocco.
  3. Fai clic sulla richiesta il cui endpoint termina con /front-entrance/unlock.

La scheda Logs filtrata per /api/door-gate-access/*, con la richiesta di sblocco dell'ingresso principale apertaLa scheda Logs filtrata per /api/door-gate-access/*, con la richiesta di sblocco dell'ingresso principale aperta

Figura 1: tutte le richieste relative alle porte, con lo sblocco dell'ingresso principale aperto

Cosa cercare: User mostra chi ha sbloccato la porta, in questo caso oscar.tran@example.com. Il Request POST Body mostra il motivo indicato, "Member forgot access card", e il Response Body mostra che la porta si è sbloccata.

Passaggio successivo: controlla il registro della porta stessa nei Registri di accesso di Door & Gate Access, che registrano ogni tentativo di sblocco della porta, anche dall'app mobile.

Perché un membro del personale non è riuscito a cambiare il ruolo di qualcuno?

Una clinica di fisioterapia: una coordinatrice ha provato ad assegnare un nuovo ruolo a un collega, ma non ha funzionato.

  1. Nella scheda Logs, fai clic su Status e scegli 403 Forbidden.
  2. Fai clic sulla richiesta 403 Forbidden del momento in cui è stato cambiato il ruolo.
  3. In AI Error Summary, fai clic su Generate summary.

L'AI Error Summary che spiega che la persona che ha effettuato la modifica non aveva l'autorizzazione per assegnare quel ruoloL'AI Error Summary che spiega che la persona che ha effettuato la modifica non aveva l'autorizzazione per assegnare quel ruolo

Figura 2: il riepilogo spiega perché il cambio di ruolo è stato rifiutato

Cosa cercare: il riepilogo indica che la persona "does not have permission to assign that role". Confrontalo con il Response Body, che riporta "You don't have permission to assign this role." Il Request POST Body mostra quale ruolo ha cercato di assegnare.

Passaggio successivo: chiedi a un Organisation Administrator di effettuare la modifica oppure rivedi il ruolo della persona. Vedi Modificare i ruoli di un utente e Modelli di ruolo.

La nostra integrazione di prenotazione ha smesso di sincronizzarsi durante la notte

Un centro acquatico o una struttura comunale: i check-in dal sistema di prenotazione hanno smesso di comparire durante la notte.

  1. Nella scheda Logs, fai clic su Endpoint, digita /partner/v1/* e fai clic su Apply.
  2. Imposta Range su Last 24 hours.
  3. Guarda lo stato all'inizio di ogni riga, quindi fai clic sulle richieste non riuscite per leggerne il Response Body.

Cosa cercare: le richieste con il badge api-key provenienti da integrations@example.org. In questo caso l'elenco mostra 429 Too Many Requests, quando l'integrazione ha inviato troppe richieste in poco tempo, e 503 Service Unavailable. Annota quando sono iniziati gli errori e se sono seguite richieste riuscite.

Passaggio successivo: fai clic su Esporta CSV e invia il file al partner dell'integrazione, così potrà verificare dal suo lato. Vedi Esportare i registri e la pagina Errori della Partner API.

Un webhook non è stato salvato

Un bar, un negozio o un locale dell'ospitalità: un responsabile ha configurato un webhook per inviare i dati dei visitatori a un altro sistema, ma il webhook non è stato salvato.

  1. Nella scheda Logs, fai clic su Email e digita l'indirizzo email completo del responsabile, in questo caso leo.hargreaves@example.com.
  2. Trova le due richieste POST del momento in cui il responsabile ha salvato il webhook: una 400 Bad Request e una 201 Created sullo stesso endpoint.
  3. Fai clic sulla 400 Bad Request, poi sulla 201 Created di qualche minuto dopo, e confrontale.

Cosa cercare: il Response Body della 400 riporta "url must start with https://". Nel relativo Request POST Body, l'indirizzo non inizia con https://. Nella 201, il responsabile aveva aggiunto https:// e il webhook è stato salvato.

Passaggio successivo: per una richiesta non riuscita, fai clic su Generate summary per ottenere una spiegazione in linguaggio semplice. Vedi AI Error Summary.

Cosa ha fatto la settimana scorsa un membro del personale in uscita?

Un ufficio o uno spazio di coworking: prima che un membro del personale lasci l'organizzazione, il suo responsabile vuole una documentazione della sua attività recente.

  1. Nella scheda Logs, fai clic su Email e digita l'indirizzo email completo della persona.
  2. Imposta Range su Last 7 days.
  3. Scorri fino in fondo all'elenco in modo che vengano caricate tutte le richieste. L'esportazione include solo le righe caricate.
  4. Fai clic su Esporta CSV, quindi su Export.

Cosa cercare: le modifiche più che le letture. Imposta Method su POST, PUT, PATCH o DELETE, uno alla volta, per vedere le richieste che hanno creato, modificato o rimosso qualcosa. Per qualsiasi elemento inatteso, apri la richiesta e leggine il Request POST Body.

Passaggio successivo: quando la persona se ne va, rimuovi il suo accesso. Vedi Rimuovere gli utenti. Conserva il file CSV secondo le norme della tua organizzazione.

Quale sede ha avuto più richieste non riuscite?

Un operatore con più sedi: ieri diverse sedi hanno segnalato problemi e la sede centrale vuole sapere da dove iniziare.

  1. Nella scheda Pannello di controllo, imposta Window in modo da coprire la giornata.
  2. In Errors Over Time, fai clic sull'intervallo in cui gli errori sono stati più numerosi. Si apre la scheda Logs con le richieste non riuscite di quel periodo.
  3. Fai clic su Struttura, scegli una sede alla volta e confronta il numero di richieste non riuscite di ciascuna.

Cosa cercare: una sede con molti più errori delle altre o con errori su un solo endpoint. Apri alcune delle sue richieste e leggi il Response Body oppure fai clic su Generate summary.

Passaggio successivo: vedi Il pannello di controllo per gli altri grafici e Strutture per le sedi della tua organizzazione.