Failure alerts

Failure alerts send a message to a notification channel when a run of one of your workflows fails or is stopped. Set them up for workflows whose loads you cannot afford to miss.

Before you start

Failure alerts send through notification channels, and a channel must exist before you can use them. Channels are added in Admin > Notifications, see Notifications. Until one is listed, the bell on a workflow card stays disabled, and its tooltip reads Set up notification channels in Admin first.

Set up an alert for a workflow

  1. Open Workflows in the sidebar, see The Workflows screen.
  2. Hover over the workflow card and click the bell. Its tooltip reads Set up failure alerts. The alerts window opens on the Alert tab, named Alerts > followed by the workflow name.
  3. Under Notification channels, tick each channel that should receive the alert.
  4. For an Email channel, the Email recipients window opens. Pick at least one person and click Add channel.
  5. Click Create alert. If the workflow already has channels, the button reads Save. When the save finishes, a toast reads Alerts saved.

The button stays greyed out until you change something. If a save fails, a toast reports Failed to save alerts and nothing is stored.

Choose channels and recipients

The Notification channels section lists the channels set up in Admin > Notifications, each with its name and type: Email, Slack, Discord or Google Chat. A search box appears when there are more than six channels. If the workflow already has alerts, its channels are listed first and the rest appear under Other channels.

An Email alert goes to DataMind OS users. Pick them by name or email, and use Selected only, Select all and Clear to manage the list. An Email channel needs at least one recipient before you can save it; until you pick one, the window shows Pick at least one recipient. Slack, Discord and Google Chat channels post to the destination set up in Admin > Notifications, so there are no recipients to pick. Each workflow keeps its own recipients for each channel, so changing one workflow's alert never changes another's.

Changes stay pending until you save. Each pending change is tagged Adding or Removing, and the footer shows Unsaved changes with a Revert button.

Change recipients

  1. Open the alerts window from the bell.
  2. Click the recipient count on the Email channel, for example 2 recipients. The window is headed Email recipients.
  3. Change the list and click Done.
  4. Click Save.

Turn alerts off

To stop one channel, untick it and click Save. To stop every channel for the workflow:

  1. Untick every channel. The notice No channels selected. Saving removes every alert for this workflow. appears.
  2. Click Remove alerts.
  3. Click Remove in the confirmation.
Warning

Remove alerts clears every channel and recipient for the workflow. The confirmation reads "This workflow will stop sending notifications to every channel. This action cannot be undone." To alert again, you choose them again.

Which runs trigger an alert

A run triggers an alert when its status is Failed, Aborted or Running Error. A run you stop with Stop ends as Aborted, so it alerts too. To find out why a run failed, see Monitor and fix a run.

Each Email message lists every failed run in a table with the columns ID, Workflow Name, Metadata ID, Status, Start Date, End Date and Error. Its subject counts the failed runs, for example Job Failure Alert - 2 Failed Jobs, or Job Failure Alert - 1 Failed Job for a single run. Slack, Discord and Google Chat messages report the failed runs in the channel.

Note

Inactive channels never send. A run whose channels are all inactive is not delivered, and every off channel records a Failed entry on the Execution tab that names it.

Check what was sent

  1. Open the alerts window from the bell and click Execution.
  2. Choose a period with Today, Last 7d, Last 30d or Custom, next to Period.
  3. Read each row's status: Sent, Partial, Failed or Skipped.

If nothing was sent in the period, the tab shows No alert notifications in this period. For the full log across the platform, see Audit, sign-in and notification logs.

Find workflows with alerts

Click the bell on the Workflows toolbar. Its tooltip reads Alerts only, and the list shows only workflows with alerts. Click it again, tooltip Show all workflows, to show every workflow. Each card with alerts shows a bell and the number of active channels that will send.

Settings

SettingWhat it doesDefault
Notification channelsEach ticked channel receives a message when a run of this workflow fails or is stopped.None ticked, so no alerts
Email recipientsThe DataMind OS users who receive the alert through an Email channel.None picked. At least one is required.

Permissions

For the full list, see Workflow permissions.

Questions, answered

Why is the bell greyed out with "Set up notification channels in Admin first"?

No channel is set up, or you cannot see notification channels. Ask an administrator to add a channel in Admin > Notifications, or to give you View Notifications.

A run failed ten minutes ago and no message has arrived. Is something wrong?

Probably not. Failure checks run every 30 minutes, so a message can arrive up to about 30 minutes after the run ends.

I stopped a run myself and got a failure alert. Is that expected?

Yes. A run you stop with Stop ends as Aborted, and aborted runs alert like failed ones.

Five workflows failed overnight. Do I get five messages?

Not necessarily. Each channel gets one message per check, and that message lists every failed run the check found. Failures found in different checks come in separate messages.

My Slack channel stopped receiving alerts. What do I check?

Check that the channel is still active in Admin > Notifications. Inactive channels never send, and the Execution tab records a Failed entry that names the channel when a run is not delivered.

I set up alerts this morning for a run that failed yesterday. Will I be told?

No. Only runs that ended in the last 24 hours are alerted, so older failures are not sent.

Why is Create alert greyed out?

The button stays disabled until you change something. In the Email recipients window, Add channel and Done stay disabled until you pick at least one recipient, and the window shows Pick at least one recipient.

Can I send alerts to someone who is not a DataMind OS user?

No. Email alerts go only to DataMind OS users. For a team room, use a Slack, Discord or Google Chat channel.

The Execution tab is missing. Why?

The tab needs View Notification Logs. Without it, the alerts window shows only the Alert tab.

Will one run send me the same alert twice?

No. Each run is alerted once. A run is tried again only when none of its channels delivers the message.

The Execution tab shows a Skipped row. What does that mean?

Nothing was sent for that run, because the workflow has no alert recipients at all; the row reads No alert recipients configured. Set up an alert on the workflow if you expect messages.

A recipient no longer works here, but their address is still on the list. Why?

The window keeps every saved address while it is selected, even when it no longer matches an active user, so you can see what the alert still sends to. Untick the address, click Done, then Save.