Domotz Event Dependency (Parent-Child Alert Correlation)

Overview

The Event Dependency feature helps reduce ticket clutter and improve incident management when multiple connected devices in a network hierarchy go offline at the same time.

Domotz will detect when a parent device goes offline, and any child devices connected to it which are also offline, will be associated to the parent device as the cause of the outage. Instead of treating each device as an independent outage, Domotz evaluates the Parent-Child relationship and links events together.

For ITSM ticketing system integrations, this means tickets for the parent and child devices are automatically bundled together for easier management.

⚠️ Important in this release:

• Supported ticketing systems: ConnectWise and Halo PSA
• Event Dependency affects ticket bundling only (notification message body is unchanged)
• UI available only when ConnectWise or Halo PSA integration is configured
• Notifications are not suppressed; both parent and child devices still generate alerts

Current Behavior (Without Event Dependency)

• Domotz generates a separate alert notification for each device that goes offline.
• No Parent-Child relationships are considered, leading to multiple alerts and multiple tickets.

Behavior with Event Dependency Enabled

When Event Dependency is enabled:

1. Topology is evaluated:
   • Domotz uses the network hierarch to determine whether any relationship exist for the offline devices.
2. Tickets are bundled (ConnectWise and Halo PSA only):
   • A parent ticket is created.
   • Child tickets are created for dependent devices.
   • Child tickets are linked automatically to the parent ticket in the ITSM system.
3. Notifications remain unchanged:
   • Domotz still sends separate alert notifications for each offline device.
   • Message content is not modified in this release.
   • The benefit is that in ConnectWise/Halo, tickets are grouped for visibility.

Configuration in the UI

The Event Dependency feature is configurable only when ConnectWise or Halo PSA ticketing integration is active on the account.

1. Event Dependency Configuration UI: (Note: only available to roles with permission to manage Contact Channels)
   
   • For account wide configuration, navigate to Alert Settings > Event Dependency. Here the feature can be enabled and configured uniformly for all collectors in the account.
     
     
   • For collector level configuration, navigate to the collector settings page > Other Settings > Event Dependency Configuration. Here the feature can be enabled and configured for a given collector.
     
     
     
2. Event Dependency Enablement and Configuration:
   • Use the toggle to enable/disable the feature.
     
   • Device DOWN notification delay setting: This is the waiting time before Device DOWN event notifications will be sent, allowing for dependency evaluation. Read More (Device Status Time Window + Delay Time = Total Time from Heartbeat Lost to Event Dependency Notification). The default delay is 5 minutes with a minimum delay of 1 minute. Example: If a parent router and five child switches go offline at the same time, Domotz waits for the configured delay, then creates a parent ticket and bundles all child tickets under it.

Ticket Autoclose Behavior

If autoclose is enabled for the ticketing system, then only those tickets for devices which have come back online and generated a device UP event notification will be closed. In the scenario where child devices take longer come back online and generate an UP notification than the parent device, the parent ticket may be closed with some child tickets remaining open. It’s also possible that a child device will come back online and generate an UP notification before the parent device, in which case the parent ticket will remain open when some or all of the child tickets have been closed.

Example Event Dependency Workflow

Refer to the network segment below for the explanation for how Event Dependency evaluates device topological relationships and bundles parent and child tickets in the ConnetWise or Halo PSA ticketing systems.

In this scenario

• The parent switch device goes down (SwitchB)
• All the child devices linked to the parent device (DeviceB1 & Device B2) go down within the Offline Delay Time Window
• NOTE: It does not matter in what order the parent and child devices go down. As long as they all go down within the Offline Delay Time Window the events will be linked and the parent and child tickets will be bundled in the ConnectWise or Halo PSA ticketing system.

Event Dependency behavior:

• A ticket for the parent switch is created
• Tickets for all the child devices are created and linked to the parent ticket in ConnectWise or Halo PSA ticketing systems.