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.
type: "transaction" fields: amount: number status: string currency: string
type: "transaction" id: "evt_8f3a" amount: 99.90 status: "approved" currency: "BRL"
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.