Skip to main content
Nem todo evento pode ser aceito na hora em que chega. Às vezes falta a definição, o formato veio errado, é uma duplicata, ou um tipo de identidade ainda não foi configurado. Quando isso acontece, o PrismaFlow não descarta o evento e não devolve erro pro seu sistema — ele guarda o evento inteiro na Quarentena, junto com o motivo, pra você revisar e reprocessar.
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.
Aba Quarentena com a lista de eventos barrados e seus motivos

Cada linha mostra o evento, o motivo, nº de erros, tamanho, quando chegou e as ações (reprocessar e ver detalhes). Em cima: busca, filtro por motivo e período, e Exportar.

As colunas são: Evento (nome + versão), Motivo, Erros (quantos problemas o schema apontou), Tamanho, Recebido em e Ações. Na coluna de ações, o ícone de setas circulares (↻) reprocessa o evento e o ícone de olho (👁) abre os detalhes. Você pode filtrar por motivo e por período, e exportar a lista.

​
Os motivos da quarentena

Todo evento barrado cai em um destes motivos:

​
Ver os detalhes de um evento

Clique no ícone de olho (👁) de uma linha para abrir os detalhes.
Modal de detalhes de um evento em quarentena

Detalhes do evento: contexto, o motivo com os erros exatos (campo + problema) e o payload original. Botão Reprocessar no rodapé.

O painel tem três partes:
  • 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).
Reprocessar não conserta nada sozinho — ele só reenvia o evento ao fluxo. Se a causa ainda não foi resolvida, o evento volta para a quarentena como um novo registro. Corrija primeiro, reprocesse depois.
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.