Logotipo do Performance HubPerformance Hub
Seção do site: Documentação

Exemplos de investigação

Nesta página

Estes exemplos mostram como responder a dúvidas comuns com os Registros de auditoria. Cada um apresenta a pergunta, os filtros e cliques a usar e o que procurar. As mesmas etapas funcionam em qualquer tipo de local, então adapte os filtros à sua própria pergunta.

Referência rápida

Onde encontrar: Configurações (ícone de engrenagem, no canto inferior esquerdo) → Registros de auditoria

Quem pode usar: Você precisa de uma função que inclua os Registros de auditoria e o Identity & Access Management na sua organização, como Organisation Administrator. Consulte Quem pode usar os Registros de auditoria.

Finalidade: Partir de uma pergunta até as solicitações que a respondem

Quem desbloqueou a entrada principal?

Uma academia ou centro de lazer: a entrada principal foi desbloqueada remotamente, e o gerente de plantão quer saber quem fez isso e por quê.

  1. Na guia Logs, clique em Endpoint, digite /api/door-gate-access/* e clique em Apply. A lista mostra apenas as solicitações do Door & Gate Access.
  2. Defina Range para abranger o horário do desbloqueio.
  3. Clique na solicitação cujo endpoint termina em /front-entrance/unlock.

A guia Logs filtrada por /api/door-gate-access/*, com a solicitação de desbloqueio da entrada principal abertaA guia Logs filtrada por /api/door-gate-access/*, com a solicitação de desbloqueio da entrada principal aberta

Figura 1: Todas as solicitações de portas, com o desbloqueio da entrada principal aberto

O que procurar: User mostra quem desbloqueou a porta, aqui oscar.tran@example.com. O Request POST Body mostra o motivo informado, "Member forgot access card", e o Response Body mostra que a porta foi desbloqueada.

Próximo passo: verifique o registro da própria porta nos Registros de acesso do Door & Gate Access, que registram todas as tentativas de desbloqueio na porta, inclusive pelo aplicativo móvel.

Por que um membro da equipe não conseguiu alterar a função de alguém?

Uma clínica de fisioterapia: uma coordenadora tentou atribuir uma nova função a um colega, e não funcionou.

  1. Na guia Logs, clique em Status e escolha 403 Forbidden.
  2. Clique na solicitação 403 Forbidden do horário da alteração de função.
  3. Em AI Error Summary, clique em Generate summary.

O AI Error Summary explicando que a pessoa que fez a alteração não tinha permissão para atribuir essa funçãoO AI Error Summary explicando que a pessoa que fez a alteração não tinha permissão para atribuir essa função

Figura 2: O resumo explica por que a alteração de função foi recusada

O que procurar: o resumo diz que a pessoa "does not have permission to assign that role". Compare-o com o Response Body, que diz "You don't have permission to assign this role." O Request POST Body mostra qual função ela tentou atribuir.

Próximo passo: peça a um Organisation Administrator para fazer a alteração ou revise a função da pessoa. Consulte Como alterar as funções de um usuário e Modelos de função.

Nossa integração de reservas parou de sincronizar durante a noite

Um centro aquático ou uma instalação municipal: os check-ins do sistema de reservas pararam de aparecer durante a noite.

  1. Na guia Logs, clique em Endpoint, digite /partner/v1/* e clique em Apply.
  2. Defina Range como Last 24 hours.
  3. Observe o status no início de cada linha e clique nas solicitações com falha para ler o Response Body delas.

O que procurar: solicitações com o selo api-key de integrations@example.org. Aqui a lista mostra 429 Too Many Requests, quando a integração enviou solicitações demais em pouco tempo, e 503 Service Unavailable. Anote quando as falhas começaram e se houve solicitações bem-sucedidas depois.

Próximo passo: clique em Exportar CSV e envie o arquivo ao parceiro de integração para que ele verifique o lado dele. Consulte Como exportar registros e a página Erros da Partner API.

Um webhook não foi salvo

Um café, uma loja ou um estabelecimento de hospitalidade: um gerente configurou um webhook para enviar os dados dos visitantes a outro sistema, e ele não foi salvo.

  1. Na guia Logs, clique em Email e digite o endereço de e-mail completo do gerente, aqui leo.hargreaves@example.com.
  2. Encontre as duas solicitações POST do momento em que o gerente salvou o webhook: um 400 Bad Request e um 201 Created no mesmo endpoint.
  3. Clique no 400 Bad Request e depois no 201 Created alguns minutos mais tarde e compare-os.

O que procurar: o Response Body do 400 diz "url must start with https://". No Request POST Body dele, o endereço não tem https:// no início. No 201, o gerente havia adicionado https://, e o webhook foi salvo.

Próximo passo: para uma solicitação com falha, clique em Generate summary para obter uma explicação em linguagem simples. Consulte AI Error Summary.

O que um funcionário que está de saída fez na semana passada?

Um escritório ou espaço de coworking: antes de um funcionário sair, o gestor dele quer um registro da atividade recente.

  1. Na guia Logs, clique em Email e digite o endereço de e-mail completo da pessoa.
  2. Defina Range como Last 7 days.
  3. Role até o final da lista para que todas as solicitações sejam carregadas. A exportação inclui apenas as linhas carregadas.
  4. Clique em Exportar CSV e depois em Export.

O que procurar: alterações, e não leituras. Defina Method como POST, PUT, PATCH ou DELETE, um de cada vez, para ver as solicitações que criaram, alteraram ou removeram itens. Para qualquer coisa inesperada, abra a solicitação e leia o Request POST Body dela.

Próximo passo: quando a pessoa sair, remova o acesso dela. Consulte Como remover usuários. Armazene o arquivo CSV de acordo com a política da sua organização.

Qual local teve mais solicitações com falha?

Um operador com vários locais: diversos locais relataram problemas ontem, e a matriz quer saber por onde começar.

  1. Na guia Painel, defina Window para abranger o dia.
  2. Em Errors Over Time, clique no intervalo em que os erros foram mais altos. A guia Logs é aberta com as solicitações com falha daquele período.
  3. Clique em Instalação, escolha cada local, um de cada vez, e compare quantas solicitações com falha cada um tem.

O que procurar: um local com muito mais falhas do que os outros ou falhas em um único endpoint. Abra algumas das solicitações dele e leia o Response Body ou clique em Generate summary.

Próximo passo: consulte O painel para ver os outros gráficos e Instalações para ver os locais da sua organização.