Eventos

Envie cada ocorrência da sua operação como um evento: uma transação, uma autenticação ou um marco logístico. O evento é a entidade central da plataforma. Métricas, monitoramentos, regras e análises operam sobre os eventos recebidos.

Modelar as ocorrências como eventos estabelece um ponto único e padronizado de ingestão de dados, independentemente do domínio de negócio. Com esse ponto único, você pode:

  • analisar dados em tempo real: acompanhe o que está acontecendo na sua operação assim que os eventos chegam;
  • criar métricas customizadas: agregue valores, calcule taxas e acompanhe tendências diretamente dos eventos recebidos;
  • configurar monitoramentos: defina critérios para detectar anomalias, riscos ou quedas de performance;
  • aplicar regras: avalie cada evento no momento em que ele chega e enriqueça-o com novos valores;
  • pontuar risco: use análises para medir velocidade e concentração no histórico recente de cada evento;
  • evoluir sem acoplamento: adicione novos campos e tipos de evento sem quebrar integrações existentes.
Tipo de Evento
type:     "transaction"
fields:
  amount:   number
  status:   string
  currency: string
schema
valida
Evento
type:     "transaction"
id:       "evt_8f3a"
amount:   99.90
status:   "approved"
currency: "BRL"
ocorrência

Organização dos eventos

Cada evento pertence a um tipo de evento, que define o contrato de dados esperado: quais campos existem, seus tipos e obrigatoriedade. Os tipos de evento podem representar contextos de negócio diferentes, como transação financeira (transaction), autenticação de usuário (user_authentication) e marcos logísticos de entrega (logistics_delivery_event).

Você define os tipos de evento conforme a realidade da sua operação e envia as ocorrências para o endpoint POST /events. A plataforma valida os dados, processa cada evento e o disponibiliza para análise, métricas e monitoramentos.


Índice