Como ler uma entrada de registro
Nesta página
Clique em uma solicitação da lista na guia Logs para abrir os detalhes dela à direita. Os detalhes mostram quando a solicitação foi feita, quem a fez e de onde, o que foi enviado e o que voltou. Para uma solicitação com falha, você também pode pedir um resumo do erro em linguagem simples.
Referência rápida
Onde encontrar: Configurações (ícone de engrenagem, no canto inferior esquerdo) → Registros de auditoria → Logs e, em seguida, clique em uma solicitação
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: Ver exatamente o que aconteceu em uma solicitação
Abrir uma entrada de registro
- Na guia Logs, filtre a lista para as solicitações de que você precisa.
- Clique em uma solicitação. Os detalhes dela abrem à direita, e a solicitação fica destacada na lista.
- Use as teclas de seta para cima e para baixo para percorrer a lista sem sair dos detalhes.
A parte superior dos detalhes repete o status, o método, o selo de origem e o endpoint.
Figura 1: Uma entrada de registro: quando aconteceu, quem a fez, de onde e os corpos da solicitação e da resposta
Os campos
Os campos aparecem em letras maiúsculas no Performance Hub, nesta ordem:
| Campo | O que mostra |
|---|---|
| Timestamp | A data e a hora da solicitação |
| Response Time | Quanto tempo o Performance Hub levou para responder, em milissegundos |
| Request ID | Um ID exclusivo para esta solicitação. Clique no botão de copiar para copiá-lo, por exemplo, para informá-lo ao Suporte. |
| IP Address | O endereço IP de onde veio a solicitação |
| User | O endereço de e-mail da pessoa que fez a solicitação |
| Referer | A página a partir da qual a solicitação foi feita, quando houver |
| User Agent | O navegador, aplicativo ou ferramenta que enviou a solicitação |
| Instalação | A instalação à qual a solicitação se destinava, no formato "Nome (id)", por exemplo, Lower Manhattan e o ID da instalação |
| Organização | A organização, no formato "Nome (id)" |
Solicitação e resposta
Abaixo dos campos ficam os corpos da solicitação, quando houver:
| Seção | O que mostra |
|---|---|
| Request POST Body | O que foi enviado, por exemplo, o motivo informado para o desbloqueio de uma porta ou o novo horário de uma instalação. O título mostra "Request POST Body" para todos os métodos que enviam um corpo. |
| Response Body | O que o Performance Hub enviou de volta, incluindo qualquer mensagem de erro |
| Query Parameters | Opções adicionadas à solicitação, como um número de página ou uma instalação |
Clique em Copy section (o ícone de copiar no canto superior direito de uma seção) para copiar o conteúdo dela, por exemplo, para colar em uma solicitação de suporte.
Se uma solicitação não tiver nada a mostrar, os detalhes dizem "No request/response payloads recorded for this entry." Muitas solicitações GET, que apenas leem informações, não têm corpo de solicitação.
Resumo de erros por IA
Para uma solicitação com falha, com status 400 ou superior, os detalhes incluem uma seção AI Error Summary.
- Clique em Generate summary.
- Leia o resumo. Ele explica em linguagem simples o que deu errado e o que fazer em seguida.
Figura 2: Para uma solicitação com falha, Generate summary explica o erro em linguagem simples
- O resumo é gerado somente quando você clica em Generate summary. Depois que um resumo é gerado, ele pode mostrar uma etiqueta cached.
- Ele é gerado por IA e pode estar errado. Compare-o com o Response Body, que contém a mensagem que o Performance Hub realmente retornou.
- Se não for possível gerar o resumo, um aviso pedirá que você tente novamente mais tarde. Enquanto isso, leia o Response Body.
Após 7 dias: prévias
Os corpos completos das solicitações e respostas são mantidos por 7 dias. Depois disso, os corpos mais longos são reduzidos a uma prévia curta, e os detalhes dizem "Full request and response payloads are kept for 7 days. Showing a preview for this log." Os corpos curtos que cabem na prévia permanecem completos.
O restante da entrada de registro, como quem fez a solicitação, quando e o resultado, é mantido por 90 dias.
Figura 3: Após 7 dias, resta apenas uma prévia curta da solicitação e da resposta
Se você talvez precise dos corpos completos mais tarde, abra a solicitação e use Copy section dentro de 7 dias. Uma exportação em CSV não inclui os corpos.
Códigos de status
O status é o primeiro item de cada linha. O primeiro dígito indica o tipo de resultado:
| Status | Significado | Exemplos |
|---|---|---|
| 2xx | Sucesso | 200 OK, 201 Created |
| 3xx | Redirecionamento: a solicitação foi enviada para outro lugar | 301 Moved |
| 4xx | Um problema com a solicitação, por exemplo, falta de permissão ou entrada inválida | 400 Bad Request (um valor não era válido), 401 Unauthorised (sem login), 403 Forbidden (sem permissão), 404 Not Found, 409 Conflict (a solicitação entrou em conflito com o estado atual, como uma porta em modo de manutenção), 429 Too Many Requests (solicitações demais em pouco tempo) |
| 5xx | Um erro do servidor | 500 Server Error, 502 Bad Gateway, 503 Service Unavailable |
Selos de origem
Cada solicitação tem um selo de origem que indica de onde ela veio:
| Selo | De onde veio a solicitação |
|---|---|
web | Alguém usando o Performance Hub em um navegador ou no aplicativo |
api-key | Uma integração que usa uma chave de API, como um sistema de reservas ou de membros. Consulte Autenticação da Partner API. |
mcp | Um agente de IA ou cliente de IA conectado por MCP. Consulte Usar com IA. |
model-router | O Model Router |
websocket | Uma conexão ao vivo, como uma atualização em tempo real |
guest-token | Um link de convidado |
Outros selos podem aparecer.
Páginas relacionadas
- Como encontrar solicitações: filtre a lista
- Como exportar registros: baixe os registros carregados
- Exemplos de investigação: coloque os detalhes em prática
- Registros de auditoria: perguntas frequentes