Events

Send each occurrence of your operation as an event: a transaction, an authentication, or a logistics milestone. The event is the central entity of the platform. Metrics, monitors, rules, and analyses operate over the events received.

Modeling the occurrences as events establishes a single, standardized entry point for data ingestion, regardless of the business domain. With that single entry point, you can:

  • analyze data in real time: track what is happening in your operation as events arrive;
  • create custom metrics: aggregate values, calculate rates, and track trends directly from received events;
  • configure monitors: define criteria to detect anomalies, risks, or performance drops;
  • apply rules: evaluate each event as it arrives and enrich it with new values;
  • score risk: use analyses to measure velocity and concentration in the recent history of each event;
  • evolve without coupling: add new fields and event types without breaking existing integrations.
Event Type
type:     "transaction"
fields:
  amount:   number
  status:   string
  currency: string
schema
validates
Event
type:     "transaction"
id:       "evt_8f3a"
amount:   99.90
status:   "approved"
currency: "BRL"
occurrence

Event organization

Each event belongs to an event type, which defines the expected data contract: which fields exist, their types, and whether they are required. Event types can represent different business contexts, such as financial transaction (transaction), user authentication (user_authentication), and logistics delivery milestones (logistics_delivery_event).

You define the event types according to the reality of your operation and send the occurrences to the POST /events endpoint. The platform validates the data, processes each event, and makes it available for analysis, metrics, and monitors.

Table of contents