Pense na quarentena como uma sala de espera com rede de segurança: nada se perde. O evento
fica guardado exatamente como chegou até você resolver a causa e reprocessá-lo.
A aba Quarentena
Os eventos barrados ficam na aba Quarentena, dentro de Eventos. Cada linha é um evento que não entrou.
Os motivos da quarentena
Todo evento barrado cai em um destes motivos:| Motivo | O que significa | Como resolver |
|---|---|---|
| Envelope inválido | O formato do evento veio quebrado (estrutura/JSON malformado). | Corrija o que o seu sistema está enviando. |
| Definição não encontrada | Não existe uma definição para esse evento e versão. | Crie a definição (ou confira se o nome/versão batem). |
| Definição desabilitada | A definição existe, mas está desativada. | Reative a definição ou ajuste o evento. |
| Validação falhou | O evento não bate com o schema (campo faltando, tipo errado). | Ajuste o schema ou corrija a origem do dado. |
| Propriedade desconhecida | Veio um campo a mais que o modo Estrito não aceita. | Adicione o campo ao schema ou use o modo Permissivo. |
| Evento duplicado | O mesmo evento chegou de novo dentro da janela de ~1 hora. | Normalmente não precisa de ação — é proteção contra duplicatas. |
| Identidade pendente | Um tipo de identidade do evento ainda não foi configurado. | Abra o card da identidade e salve a configuração. |
Ver os detalhes de um evento
Clique no ícone de olho (👁) de uma linha para abrir os detalhes.
- Contexto — quando o evento chegou, o tamanho do payload e o Correlation ID (um código para rastrear esse evento nos seus logs).
- Motivo — a explicação do que houve e, quando aplicável, a lista exata dos erros: o
campo e o problema (por exemplo,
$.items[0].price→must be number, ou$.customer_id→is required). Há também o atalho Editar schema, que leva direto à definição para corrigir. - Payload — o evento original, intacto, do jeitinho que chegou.
Reprocessar
Depois de resolver a causa (criar/corrigir a definição, configurar a identidade, etc.), clique em Reprocessar — no rodapé dos detalhes ou no ícone ↻ da linha. O evento volta para o fluxo normal como se tivesse acabado de chegar (ganha um novo identificador interno, mas mantém o mesmo Correlation ID para rastreio).Eventos reprocessados somem da lista — ela mostra apenas os que ainda estão pendentes. Se
você reprocessou e o evento não voltou, deu certo.
Exportar
O botão Exportar baixa a lista (respeitando os filtros ativos) em CSV ou JSON, até 1.000 linhas. O CSV traz recebido em, evento, versão, motivo, correlation ID, tamanho e um resumo do erro — o payload completo não entra no CSV (mas está sempre nos detalhes de cada evento).Bom saber
Zero perda de dados
Um evento barrado nunca é descartado nem some — ele fica guardado inteiro até você decidir o
que fazer.
A lista mostra só os pendentes
Assim que um evento é reprocessado, ele sai da lista. O que você vê são os que ainda precisam
de atenção.
'Identidade pendente' aparece um pouco depois
Esse motivo é detectado numa etapa posterior (não no instante do envio), então o evento pode
levar um tempinho até aparecer aqui.
Corrija a causa antes de reprocessar
Reprocessar sem resolver o motivo só faz o evento voltar para a quarentena.