Registros de auditoria

Os Registros de auditoria são um registro das solicitações feitas ao Performance Hub na sua organização. Eles abrangem as solicitações de pessoas que usam o Performance Hub em um navegador ou no aplicativo e de ferramentas conectadas, como chaves de API, agentes de IA conectados por MCP e o Model Router. Use-os para responder a perguntas como quem desbloqueou uma porta, por que uma alteração não foi salva ou quando uma integração parou de funcionar, sejam os seus locais escritórios, lojas, cafés, espaços de eventos, clínicas, campi ou academias.

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: Ver quem fez o quê no Performance Hub e descobrir por que uma solicitação falhou

Figura 1: O painel dos Registros de auditoria: a janela de tempo, os indicadores principais e a linha do tempo de solicitações

O que é registrado

Cada entrada de registro é uma solicitação feita ao Performance Hub. Ela mostra:

• Quem fez a solicitação: o endereço de e-mail do usuário.
• De onde: o endereço IP e o navegador ou a ferramenta que a enviou.
• O que foi chamado: o método (por exemplo, GET para ler ou POST para criar) e o endpoint, que é a parte do Performance Hub à qual a solicitação se destinava, como /api/door-gate-access/doors/front-entrance/unlock.
• O resultado: o status da resposta, por exemplo, 200 para sucesso ou 403 quando a pessoa não tinha permissão.
• Quanto tempo levou, em milissegundos.
• Qual foi a origem: um selo de origem, como web para uma pessoa usando o Performance Hub ou api-key para uma integração. Consulte Selos de origem.

Para solicitações recentes, a entrada de registro também guarda o que foi enviado e o que foi retornado. Consulte Como ler uma entrada de registro.

As duas guias

Quem pode usar os Registros de auditoria

Você precisa de uma função que inclua os Registros de auditoria e o Identity & Access Management na sua organização, como Organisation Administrator. Se você não vê Registros de auditoria no menu de configurações, a sua função não os inclui.

• Quais organizações você vê: as organizações em que a sua função inclui tanto os Registros de auditoria quanto o Identity & Access Management. A guia Logs mostra quantas são, por exemplo, "Viewing logs for 1 organisation".
• Modelos de função: o modelo Organisation Administrator inclui os Registros de auditoria. Os modelos Site Manager e Site Owner não os incluem. Consulte Modelos de função.
• Funções personalizadas: para permitir que uma função personalizada use os Registros de auditoria, inclua tanto os Registros de auditoria quanto o Identity & Access Management no acesso aos módulos dela. Consulte Escopo de acesso e acesso aos módulos.

Os Registros de auditoria mostram os endereços de e-mail das pessoas, os endereços IP e o que elas enviaram, por isso conceda-os somente a quem precisa.

Por quanto tempo os registros são mantidos

A retenção dos registros de auditoria define por quanto tempo eles são mantidos: 90 dias para cada entrada de registro e 7 dias para os payloads completos de solicitação e resposta.

O menu Range da guia Logs diz:

"Os registros de auditoria são mantidos por 90 dias. Os payloads completos de solicitação e resposta são mantidos por 7 dias, após os quais permanece uma breve visualização. Precisa de um histórico mais longo? Entre em contato com o suporte (aplicam-se custos adicionais)."

Assim, você pode consultar até 90 dias atrás. Nos primeiros 7 dias, uma entrada de registro guarda a solicitação e a resposta completas. Depois disso, os corpos mais longos são reduzidos a uma prévia curta. Consulte Após 7 dias: prévias.

O que você pode fazer

• Ler o painel: veja o volume de solicitações, as taxas de erro e os endpoints e os usuários mais ativos em uma janela de tempo.
• Encontrar solicitações: filtre por intervalo de tempo, endereço de e-mail, endereço IP, endpoint, organização, instalação, método e status e compartilhe uma visualização filtrada.
• Ler uma entrada de registro: veja quem fez uma solicitação, de onde e o que foi enviado e retornado. Para uma solicitação com falha, obtenha um resumo do erro em linguagem simples.
• Exportar registros: baixe os registros carregados como um arquivo CSV.
• Seguir um exemplo de investigação: respostas passo a passo para perguntas comuns, como quem desbloqueou uma porta ou por que uma integração parou de sincronizar.
• Perguntas frequentes

Páginas relacionadas

• Modelos de função: quais modelos incluem os Registros de auditoria
• Escopo de acesso e acesso aos módulos: conceda os Registros de auditoria a uma função personalizada
• Door & Gate Access: Registros de acesso: o registro separado de cada tentativa de desbloqueio de portas e portões