> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymorfa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Logs e histórico de auditoria

> Inspecione requisições, entregas, mudanças de sessão e ações da equipe.

Abra **Logs** para investigar a atividade operacional. Abra
**Configurações → Atividade** para inspecionar as alterações feitas por pessoas e
credenciais da sua equipe.

## Investigue os logs

Escolha **Todos**, **Requisições de API**, **Webhooks** ou **Sessões**. Use
**Somente erros** para restringir qualquer visualização às falhas. As linhas
mostram data e hora precisas, origem, resumo, detalhes e status. Os detalhes de
uma requisição incluem a duração ou um código de falha; os detalhes de uma
entrega incluem o número de tentativas e o status HTTP. Os métodos da API têm
cores distintas.

A barra lateral contém os filtros de linha do tempo e de propriedades. No
celular, abra **Filtros** para usar os mesmos controles. A busca sugere as
propriedades compatíveis com o tipo de log selecionado. Selecione uma sugestão,
digite um valor e pressione Enter para transformá-la em uma pílula de filtro.
Clique em uma pílula para editá-la ou use o botão de fechar dela para removê-la.
Valores da mesma propriedade funcionam como alternativas; propriedades
diferentes precisam corresponder todas. **Redefinir** limpa os filtros, a busca
e o contexto de evento e restaura a linha do tempo do último dia.

Os identificadores de filtro aparecem quando a origem selecionada os aceita,
incluindo IDs de requisição, sessão, evento, webhook, cliente, número e
conversa. Um identificador só fica disponível quando a atividade correspondente
o registra.

Use **Ordenar** ou o cabeçalho de uma coluna para adicionar propriedades de
ordenação. As pílulas de ordenação aparecem abaixo da busca, em ordem de
prioridade. Clique em **Ordenar** para ocultar ou mostrar as pílulas sem perder a
ordenação ativa. Clique em uma pílula para mudar a direção dela ou remova-a com o
botão de fechar. Arraste as bordas das colunas para redimensioná-las; o
navegador lembra essas larguras.

### Linha do tempo e modo ao vivo

O botão de calendário à esquerda abre a seleção de datas. Clique em uma data de
início e depois em uma data de término. Clique no mês ou no ano para ir para
outro mês ou ano. Selecione **Local** ou **UTC** e depois **Aplicar**. Datas
anteriores ao primeiro log retido, datas depois de hoje e dias sem atividade
registrada ficam desativados.

O menu suspenso à direita seleciona um período relativo: os últimos 30 minutos,
a última hora, as últimas 12 horas, o último dia, os últimos três dias, a última
semana ou as últimas duas semanas. Ele também substitui um intervalo de datas
personalizado por um período relativo. O calendário continua disponível ao lado
de um período selecionado.

**Ao vivo** atualiza a cada três segundos. Um aviso de modo ao vivo aparece
acima das linhas, e o ícone de atualização gira enquanto uma atualização está em
andamento. As janelas relativas avançam a cada atualização; as janelas
personalizadas mantêm as datas selecionadas. **Atualizar** busca novos
resultados quando você quiser. Passe o mouse ou coloque o foco sobre um horário
para ver o UTC, o horário local, o horário ISO e o tempo decorrido, que é
atualizado a cada segundo enquanto o popup está aberto.

O servidor retorna os 500 logs correspondentes mais recentes na janela
selecionada, com 50 linhas por página da tabela. Restrinja a linha do tempo ou
os filtros quando a visualização atingir o limite. Um intervalo selecionado
cobre no máximo 366 dias.

### Detalhes e contexto

Selecione uma linha para ver os campos registrados. Em telas largas, o detalhe
fica ao lado da tabela, para você inspecionar outra linha sem fechá-lo. Telas
menores abrem o mesmo detalhe em uma gaveta. Feche o detalhe para voltar à
tabela completa. **Ver no contexto** abre a atividade de até cinco minutos antes
e depois desse registro, em todas as origens. Registros com um ID de sessão
também restringem o contexto a essa sessão. Limpe o contexto para voltar à
janela do último dia.

As atualizações de sessão incluem os estados de conexão registrados, os motivos
de desconexão, o fim de banimentos temporários, os prazos de telefone offline e
as mudanças de restrição. Esses fatos continuam disponíveis independentemente da
retenção do corpo das mensagens. Os dados de pareamento e o conteúdo das
mensagens ficam fora desses fatos de estado.

Quando a sua equipe usa o beta de acompanhamentos de campanha, os
acompanhamentos aparecem em **Todos** como linhas de **Campanha**, uma para cada
mudança de estado de um acompanhamento, como `campaign.followup.scheduled` ou
`campaign.followup.cancelled`. Os detalhes incluem os IDs da campanha, do
destinatário, do acompanhamento, do número e do comando e um motivo como `reply`
ou `opt_out`, nunca números de telefone nem o texto da mensagem. Acompanhamentos
com falha e com resultado desconhecido também aparecem em **Somente erros**. Os
destinos de logs não encaminham essas linhas. Consulte
[Envie um acompanhamento após a entrega ou a leitura](/pt-br/guides/campaigns/follow-ups).

Os detalhes de webhook mostram as tentativas registradas, o status HTTP, o
código de falha e trechos da resposta de falha com dados sensíveis ocultados. O corpo do evento
vinculado só é carregado quando você abre o detalhe, e apenas enquanto essa carga
continuar disponível de acordo com a configuração de armazenamento de mensagens
do número de origem. O detalhe explica cargas indisponíveis ou expiradas.

Os logs do projeto não incluem as cargas das requisições, as credenciais nem os
cabeçalhos das requisições. Requisições de API com falha e entregas de webhook
podem incluir um trecho da resposta de até 8 KB, depois que os campos comuns de
credenciais são ocultados. Tipos de conteúdo de resposta não compatíveis são
omitidos. Os registros operacionais brutos usam destaque de sintaxe.

Uma requisição de API com falha retorna um `request_log_url` no
[corpo do erro](/api/errors#request-ids-and-log-links). Esse link filtra
**Requisições de API** pelo ID da requisição nos últimos sete dias. O ID
corresponde ao cabeçalho de resposta `X-Request-Id`. **Mostrar todos os eventos**
remove essa restrição à requisição vinculada.

## Inspecione o histórico de auditoria

**Configurações → Atividade** lista até 500 ações da sua equipe ou do projeto
selecionado. Filtre por ator, ação, origem, resultado, intervalo de datas ou
busca. As fotos e os nomes de exibição dos atores aparecem quando a conta do ator
os fornece; as iniciais servem de fallback. Abra uma linha para ver o e-mail
do ator, a ação, o recurso, o resultado, as informações registradas da
requisição e as alterações de campo antes e depois. Os detalhes de auditoria
apresentam campos estruturados, sem uma visualização do registro bruto.

## Exporte ou encaminhe

O menu de exportação abre imediatamente. **Copiar logs visíveis**,
**Exportar CSV** e **Exportar JSON** usam as linhas filtradas e ordenadas da
tabela carregada. O histórico de auditoria também exporta os registros filtrados
e ordenados como CSV ou JSON.

Proprietários e administradores do projeto usam **Amostragem de rastros** para
configurar a amostragem dos registros operacionais encaminhados e
**Adicionar destino** no menu de exportação para configurar um destino. A
amostragem mantém completos os logs armazenados e o histórico de auditoria.
Consulte [Encaminhamento de logs](/pt-br/console/log-forwarding) para ver a
configuração, as regras de amostragem e a verificação de entrega.

Consulte a [visão geral do produto Logs](https://www.polymorfa.com/observability#logs) para uma introdução visual.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.