Skip to main content

Alerts and clips

An alert opens when a workflow with a Create Alert step matches a detection. See Rules and workflows. Each alert links to a short clip of the moment and, once it's ready, a caption that describes it.

Find alerts​

Open Alerts. Use the tabs at the top to pick a view:

TabShows
ActiveOpen and acknowledged alerts. This is the default.
UnassignedActive alerts nobody has taken.
Assigned to meActive alerts assigned to you.
ResolvedAlerts closed as handled.
DismissedAlerts closed as noise or a false alarm.
AllEvery alert, in any state.

Use All cameras next to the tabs to show one camera only. The header shows how many alerts match. Alerts are listed newest first, 20 to a page. Use Previous and Next to move between pages.

The Dashboard tab also has an Alert Triage Queue with the latest alerts.

Each alert card shows:

  • The name of the workflow that raised it.
  • The caption, or its status while it is being written. See Video captions.
  • The camera and time.
  • Who it is assigned to, if anyone, and the latest note.
  • A severity badge: High, Medium or Info.

The severity comes from the workflow's Create Alert step if it sets one, otherwise from the camera's detection profile, otherwise from the event type's default severity. See Steps.

Play a clip​

Click an alert card. If its clip is ready, the clip plays in the card. Click again to close it. A card without a clip shows No clip: the clip isn't ready, or the alert has none.

A clip runs from 5 seconds before to 5 seconds after the moment the rule matched. It is an H.264 MP4 file that plays in any modern browser.

The clip is stored in object storage on your site. Your browser fetches it through the dashboard's own HTTPS address, as a signed-in user, so your computer only needs to reach the dashboard.

note

The edge node cuts a clip from the frames it holds in memory. If the edge node restarted around the time of the alert, those frames may be gone and the alert has no clip.

Alert states​

StateMeaning
OpenNew. Nobody has acted on it.
AcknowledgedSomeone has seen it and is looking into it.
ResolvedClosed as handled, with an optional note.
DismissedClosed as noise or a false alarm, with an optional reason.

Resolved and dismissed alerts are closed. A closed alert only changes by being reopened.

Triage an alert​

On an alert card:

  1. Click Assign to take the alert. It is assigned to you.
  2. Click Ack to acknowledge it and show you're on it.
  3. Click Resolve when it's handled, or Dismiss if it was a false alarm. Type a note if you like, and click Confirm.

To reopen a resolved or dismissed alert, click Reopen on its card, type a reason if you like, and click Confirm. The alert goes back to Open.

Every action is recorded under your account, with the time and any note. Click History on a card to see the alert's full history. Triage actions also appear in the audit log.

If someone else changed the alert at the same moment, for example resolved it while you were acknowledging it, your action is refused and the card shows the alert's current state.

Triage many alerts at once​

  1. In Alerts, tick the alerts you want, or tick Select All on Page.
  2. In the bar at the bottom, pick an action:
    • Assign to me
    • Acknowledge All
    • Dismiss All, then type one reason for all of them and click Confirm Dismiss.
    • Resolve All, then type one note for all of them and click Confirm Resolve.

Alerts that can't take the action, for example already acknowledged alerts in an Acknowledge All, are left as they are. A notice lists them. In the Resolved and Dismissed tabs, the bar offers no bulk actions: reopen closed alerts one at a time.

How long clips are kept​

Clips are deleted together with their events by the retention service:

  • An event and its clip are deleted once they are older than the retention window. The default is 30 days.
  • An open alert protects its event and clip from deletion. Acknowledged, resolved and dismissed alerts don't.
  • If you set a hard backstop, events older than the backstop are deleted even when an alert is still open.

Admins set these in Settings. See Retention.

Send alerts to people and other systems​

To email or text people when an alert opens, add a Send Email or Send SMS step to the workflow. To post alerts to a chat tool, ticketing system or your own service, add a Send Webhook or API Call step. See Steps and Notification channels.

Was this page helpful?