Skip to main content

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 condition battery_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.)
Trigger Information:
  • Which trigger matched
  • Priority level (Critical, High, Medium, Low)
  • Trigger category and labels
Condition Details:
  • Which signals crossed their thresholds
  • Actual signal values at time of match
  • Configured threshold values
Associated Data:
  • 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 list with 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
Configure notification channels based on event priority to ensure critical conditions receive immediate attention.

Next Steps

Learn How to Configure Effective Monitoring: Apply Events to Your Use Case: Related Concepts: