Skip to main content

Spark Job Notifications

Job notification subscriptions let you register one or more email recipients to receive alerts for specific events on a Spark job or Spark Streaming job. Point them at any email address, including team distribution lists or on-call rotations, and pick exactly which events should trigger an alert.

Prerequisites

An SMTP server must be configured before notifications can be sent. See Email Configuration to set it up.

Subscribing to a Job​

Notifications tab on a job detail page showing the Email and Event types table with Silence and Subscribe buttons | IOMETENotifications tab on a job detail page showing the Email and Event types table with Silence and Subscribe buttons | IOMETE
  1. Open a job from the left sidebar via Applications → Job Templates → job name, or Applications → Streaming Jobs → job name.
  2. Click the Notifications tab in the job detail.
  3. Click Subscribe.
  4. The Subscribe to job notifications modal opens.
  5. Select one or more Event Types using the checkboxes, or click Select all to subscribe to every event. Available event types: On Success, On Failure, On Abort, On Startup Timeout, On Execution Timeout.
  6. Enter a Recipient email address. Your own email is pre-filled, but you can replace it with any valid address.
  7. Click Subscribe to save.
Subscribe to job notifications modal showing event type checkboxes and a recipient email field | IOMETESubscribe to job notifications modal showing event type checkboxes and a recipient email field | IOMETE

On success, a Job subscription created successfully notification appears and the new entry shows up in the table.

warning

Each (job, recipient) pair must be unique. If a subscription already exists for the same recipient on the same job, the request is rejected with "Notification setting already exists for recipient {email}".

Managing Subscriptions​

Notifications tab showing a subscription row with the action menu open, revealing Edit and Delete options | IOMETENotifications tab showing a subscription row with the action menu open, revealing Edit and Delete options | IOMETE
  1. On the Notifications tab, open the action menu on the subscription row.
  2. Click Edit to reopen the subscription modal with existing values pre-filled, change the events or recipient, and click Save. A success notification confirms Job subscription updated successfully.
  3. Click Delete and confirm in the popup dialog to remove the subscription. A success notification confirms Job subscription deleted successfully.

Silencing Job Notifications​

Silencing temporarily suppresses email delivery for every subscription on a job without removing the subscriptions themselves. Reach for it during planned maintenance or known incidents to prevent alert noise.

  1. On the Notifications tab, click Silence.
  2. A Silence notifications popover opens with a grid of duration choices: 15 min, 30 min, 1 hour, 2 hours, 4 hours, 8 hours, 12 hours, 1 day, 2 days, and 1 week.
  3. Click a duration to silence notifications for that period. A Job subscription silenced successfully notification confirms the silence is active.
Silence notifications popover showing a grid of duration options from 15 minutes to 1 week | IOMETESilence notifications popover showing a grid of duration options from 15 minutes to 1 week | IOMETE

When a silence is active, the Silence button shows a yellow badge with the end date, time, and remaining duration (for example, 4/28/2026, 9:07 PM (0h 14m left)). To end the silence early, click it again and select Remove silence in the popover.

Notifications tab with an active silence, showing the Silence button with a yellow badge displaying the end time and remaining duration | IOMETENotifications tab with an active silence, showing the Silence button with a yellow badge displaying the end time and remaining duration | IOMETE
info

You cannot stack silences. If a silence is already active for the job, you must remove it before starting a new one.

ON THIS PAGE