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

Como encontrar solicitações

Nesta página

A guia Logs lista as solicitações feitas na sua organização, das mais recentes para as mais antigas. Use os filtros na parte superior para restringir a lista a uma pessoa, um endereço IP, uma parte do Performance Hub ou um tipo de resultado e, em seguida, clique em uma solicitação para ver os detalhes dela.

Referência rápida

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

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: Encontrar as solicitações por trás de uma dúvida, como quem alterou algo ou por que algo falhou

A guia Logs, com a barra de filtros na parte superior, uma lista de solicitações à esquerda e os detalhes da solicitação selecionada à direitaA guia Logs, com a barra de filtros na parte superior, uma lista de solicitações à esquerda e os detalhes da solicitação selecionada à direita

Figura 1: A guia Logs: filtros na parte superior, solicitações correspondentes à esquerda e a solicitação selecionada à direita

A guia Logs

  • Barra de filtros: os filtros na parte superior, com Live, atualizar e Exportar CSV à direita.
  • Lista: as solicitações correspondentes, das mais recentes para as mais antigas. Acima dela, aparece "Viewing logs for 1 organisation" (ou o número de organizações que você pode ver). Cada linha mostra o código de status, o método, o selo de origem, a data e a hora, o endpoint, o endereço de e-mail do usuário e o tempo de resposta em milissegundos.
  • Detalhes: a solicitação que você selecionou. Consulte Como ler uma entrada de registro.

A lista carrega mais solicitações à medida que você rola a página. No final da lista, ela mostra quantas solicitações corresponderam, por exemplo, "End of results · 5 logs".

Filtrar a lista

  1. Clique em um filtro na barra de filtros, por exemplo, Endpoint.
  2. Escolha uma opção ou digite um valor. Por exemplo, digite /api/door-gate-access/* em Endpoint e clique em Apply.
  3. O filtro mostra o valor escolhido, e a lista é atualizada. Adicione mais filtros para restringi-la ainda mais: uma solicitação precisa corresponder a todos os filtros para aparecer.
  4. Para remover um filtro, clique no × dele. Para remover todos, clique em Clear, que aparece assim que algum filtro é definido.

A barra de filtros: Range, Email, IP, Endpoint, Org, Instalação, Method e Status, seguidos de Live, atualizar e Exportar CSVA barra de filtros: Range, Email, IP, Endpoint, Org, Instalação, Method e Status, seguidos de Live, atualizar e Exportar CSV

Figura 2: A barra de filtros: Range, Email, IP, Endpoint, Org, Instalação, Method e Status, seguidos de Live, atualizar e Exportar CSV

FiltroO que ele corresponde
RangeO momento em que a solicitação foi feita. O padrão é Last 24 hours. Consulte Range.
EmailO endereço de e-mail completo do usuário, por exemplo, priya.shah@example.com. Ele pode sugerir endereços enquanto você digita.
IPO endereço IP completo de onde veio a solicitação, por exemplo, 203.0.113.140
EndpointA parte do Performance Hub à qual a solicitação se destinava. Qualquer parte do caminho corresponde, e você pode usar um curinga *. Consulte Endpoint e curingas.
OrgUma organização ou Any org. Aparece quando você tem acesso a pelo menos uma organização.
InstalaçãoUma instalação ou Any facility. Aparece quando você tem acesso a pelo menos uma instalação.
MethodGET, POST, PUT, PATCH ou DELETE
StatusO status da resposta. Consulte Status.

Email e IP exigem o valor completo

Email e IP encontram apenas correspondências exatas. Digite o endereço de e-mail completo, como ruby.castellano@example.com, ou o endereço IP completo. Parte de um endereço, como ruby ou 203.0.113, não encontra nada.

Para encontrar uma pessoa sem o endereço completo dela, use Top Users no painel ou abra uma das solicitações dela e copie o endereço do campo User.

Intervalo

Clique em Range para escolher até quando olhar para trás.

  • Predefinições: Last 15 minutes, Last hour, Last 12 hours, Last 24 hours, Last 7 days, Last 30 days e Last 90 days.
  • Datas: escolha uma data de início e uma data de término no calendário de dois meses e clique em Apply. Clique em Cancel para fechar o menu sem alterar o intervalo. Não é possível escolher datas de mais de 90 dias atrás.

A observação na parte inferior do menu informa por quanto tempo os registros são mantidos: "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)."

O menu Range aberto, com predefinições de Last 15 minutes a Last 90 days, um calendário de dois meses e a observação sobre por quanto tempo os registros são mantidosO menu Range aberto, com predefinições de Last 15 minutes a Last 90 days, um calendário de dois meses e a observação sobre por quanto tempo os registros são mantidos

Figura 3: Range: escolha uma predefinição ou datas no calendário. A observação mostra por quanto tempo os registros são mantidos

Endpoint e curingas

O endpoint é o caminho para o qual a solicitação foi enviada, como /api/door-gate-access/doors/front-entrance/unlock. Ele indica a qual parte do Performance Hub a solicitação se destinava.

  • Sem um *, qualquer parte do caminho corresponde. Por exemplo, unlock encontra todas as solicitações com "unlock" no caminho.
  • Com um *, cada trecho entre os asteriscos precisa aparecer no caminho. Por exemplo, /api/door-gate-access/* encontra todas as solicitações do Door & Gate Access, e /partner/v1/* encontra todas as solicitações de uma integração que usa a Partner API.

O filtro Endpoint aberto, com /api/door-gate-access/* digitado e os botões Cancel e ApplyO filtro Endpoint aberto, com /api/door-gate-access/* digitado e os botões Cancel e Apply

Figura 4: Endpoint aceita um curinga *, por exemplo, para todas as solicitações de portas

A guia Logs filtrada por /api/door-gate-access/*, listando cinco solicitações de portas com a primeira abertaA guia Logs filtrada por /api/door-gate-access/*, listando cinco solicitações de portas com a primeira aberta

Figura 5: A lista após filtrar por um padrão de endpoint

Não sabe qual endpoint usar? Abra uma solicitação que você conhece, como uma porta que você mesmo desbloqueou, e copie o início do endpoint dela nos detalhes.

Status

Clique em Status para filtrar pelo status da resposta. Digite em Search… para encontrar um status rapidamente, por exemplo, "403". Escolha Any para mostrar todos os status.

Os status são listados com seus nomes, como 200 OK, 201 Created, 400 Bad Request, 401 Unauthorised, 403 Forbidden, 404 Not Found, 409 Conflict, 429 Too Many Requests, 500 Server Error e 503 Service Unavailable. Consulte Códigos de status para saber o que eles significam.

O menu Status aberto, com uma caixa de pesquisa, Any e status de 200 OK a 401 UnauthorisedO menu Status aberto, com uma caixa de pesquisa, Any e status de 200 OK a 401 Unauthorised

Figura 6: Filtrar pelo status da resposta

Live e atualizar

Na guia Logs, Live fica como Off por padrão, para que a lista permaneça parada enquanto você investiga. Ative-o e escolha com que frequência a lista é atualizada para acompanhar a chegada de novas solicitações. Clique no botão de atualizar (as setas circulares) para recarregar a lista uma vez.

Compartilhar ou adicionar aos favoritos uma visualização filtrada

Seus filtros ficam salvos no endereço da página. Adicione a página aos favoritos para voltar à mesma visualização ou envie o endereço a um colega. Ele verá a mesma lista filtrada se tiver acesso aos Registros de auditoria e à mesma organização.

Por exemplo, um endereço que termina em /audit-logs/logs?email=priya.shah%40example.com abre a lista filtrada para essa pessoa, e um que termina em /audit-logs/logs?endpoint=%2Fapi%2Fdoor-gate-access%2F* abre todas as solicitações de portas.

Navegar pela lista

  • Clique em uma solicitação para abrir os detalhes dela à direita.
  • Use as teclas de seta para cima e para baixo para ir para a solicitação anterior ou seguinte da lista.
  • Em uma tela estreita, os detalhes abrem sobre a lista. Clique no botão de fechar para voltar à lista.

Nenhum resultado

Se nada corresponder, a lista mostra "No logs match these filters" e "Try widening the time range or clearing a filter."

A guia Logs com um filtro Email definido, mostrando No logs match these filtersA guia Logs com um filtro Email definido, mostrando No logs match these filters

Figura 7: Nenhuma solicitação corresponde: amplie o intervalo ou limpe um filtro

Para encontrar o que você procura:

  • Escolha um Range mais longo, como Last 7 days.
  • Verifique se Email e IP contêm o endereço completo. Parte de um endereço não encontra nada.
  • Remova um filtro de cada vez com o × dele ou clique em Clear.