Dwell time
Dwell time triggers when a device stays in a location longer than expected.
How it works
You define a location and a maximum dwell duration. If a device remains inside the location longer than the limit, the rule triggers. The violation clears when the device leaves.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
location_id |
string | Conditional | — | Zone to monitor. Use this or zone_tags. |
zone_tags |
array | Conditional | — | Match zones with any of these tags |
exclude_zone_ids |
array | No | — | Zone IDs to exclude when using zone_tags |
max_dwell_duration_seconds |
integer | No | 3600 | Maximum time in location before triggering (default: 1 hour) |
Example: loading bay timeout
Alert when a vehicle has been in the loading bay for more than 30 minutes:
- Location:
zone_loading_bay - Max dwell duration: 1,800 seconds (30 minutes)
- Severity: Medium