Creating an Event
An Event defines which records from a table or view you want to analyze. Each Event is associated with one configured Event Source and can optionally include filters to select specific records.
Multiple Events can reuse the same Event Source with different filter conditions.
Step 1: Name the Event and Select an Event Source
Navigate to Events → Add Event.
- Enter a descriptive Event Name, such as Payment Failed.
- Select an existing configured Event Source from the dropdown.
- Use Sample Rows or Schema to inspect the available data.
Each Event is tied to one Event Source (table or view). If the records you want to analyze are spread across multiple tables or views, create a separate Event for each relevant source.
Step 2: Define Filter Conditions (Optional)
Filters determine which records from the selected Event Source qualify for the Event.
To add a filter:
- Select a column.
- Choose a comparison operator, such as = (equals).
- Enter the target value.
- Add more conditions if needed.
Example: Payment Failed
| Setting | Value |
|---|---|
| Event Name | Payment Failed |
| Event Source | PAYMENT_LEDGER |
| Filter Column | PAYMENT_STATE |
| Operator | Equals (=) |
| Target Value | FAILED |
This Event includes only records where PAYMENT_STATE = 'FAILED'.
Combining Multiple Filters
When using multiple conditions, select how they should be combined:
- AND: All conditions must match the same row.
- OR: At least one condition must match the row.
zinzu supports either AND or OR across an Event's filters, but not a combination of both.
Creating an Event Without Filters
Filters are optional. If no filter conditions are specified, all rows from the selected Event Source qualify for the Event.
For example, an Event named Payment Attempt without filters includes every record from the PAYMENT_LEDGER table.
Important: Events Across Multiple Sources
An individual Event cannot combine records from multiple tables or views.
If your business activity is recorded across different sources, create separate Events for each source.
Example:
| Event | Event Source |
|---|---|
| Payment Failed | PAYMENT_LEDGER |
| Retry Attempted | SERVICE_LOGS |
| Payment Succeeded | PAYMENT_LEDGER |
These Events can then be used together in a zinzu query to find patterns such as:
Payment Failed → Retry Attempted → Payment Succeeded
zinzu connects matching EventOwner records across the sources when executing the query.

