What is an Event?
An event is generated when all conditions of a trigger are met simultaneously. Each event represents a specific occurrence requiring attention on a system. Example: If a trigger monitors battery voltage with conditionbattery_voltage < 11.5V, an event is generated the moment this condition becomes true on a system.
What Events Do for You
Events serve two primary purposes:1. Notification
Alert your operations team through configured channels when conditions warrant attention. Different priority levels (Critical, High, Medium, Low) ensure the right urgency.2. Data Capture
Trigger recordings from associated implementations to preserve context around the event. This data enables investigation and root cause analysis.Event Context
Every event contains comprehensive information: System Information:- Which system generated the event
- System labels for filtering (zone, model, etc.)
- Which trigger matched
- Priority level (Critical, High, Medium, Low)
- Trigger category and labels
- Which signals crossed their thresholds
- Actual signal values at time of match
- Configured threshold values
- Links to recordings captured by implementations
- Recording time windows (before/after the event)
- Timestamps and duration
Working with Events
View Events
- Web Interface: Navigate to Smart Data view to see all events
- CLI: Use
heex events listwith filtering options
Filter Events
Find relevant events by:- System (specific system or by labels like zone, model)
- Trigger (specific trigger or by category)
- Time range (last 24h, week, custom period)
- Priority (critical, high, medium, low)
Notification Channels
Events notify your team through:- Email: Individual addresses or distribution lists
- Slack: Channel notifications with event details
- In-App: Heex web interface notifications
Next Steps
Learn How to Configure Effective Monitoring:- Monitoring Best Practices - Configure triggers that generate valuable events
- Trigger Configuration - Create triggers in the web interface
- Fleet Monitoring - Use events for fleet management
- Key Concepts - Understand Heex fundamentals
- Labels - Organize and filter events