Event Notifications

Obsidian includes powerful notification capabilities to help your organization stay on top of unexpected events that can interfere with your business.

Obsidian's notifications are provided via email, though SMS can be sent with most providers through SMS gateways. Here is a complete listing of SMS gateways.

Email content can be customized for various events types, and even by job.

If you are looking to configure SMTP in Obsidian to get notifications working, see Advanced Configuration.

Obsidian's web application allows you to configure email notifications and view notification history in the Notifications screen.

How notifications are sent out depends on these factors:

• Subscriber settings
  • Active state
  • Email address
• Event category subscriptions
  • Minimum Notification Severity (Info, Warning or Error)
  • Active state
  • Applicable Target Entities (in the case of job categories)
• Job execution subscriptions
  • Trigger states(Completed, Conditional, Failed, Died, Recovery)
    • Job Results Conditions when using Conditional trigger
  • Active state
  • Applicable Jobs

Customizable Notifications

Obsidian allows you to customize your notification email content. You can define separate templates for different event types, and even define a template that applies to specific jobs. This can be useful for emailing the results of certain jobs to interested parties, while sending less detailed emails for other jobs. Full details are documente in Email Templates.

Category-Based Subscriptions

When setting up a notification subscriber in Obsidian, you are able to choose the event categories that need to have notifications sent. This allows you to target specific individuals or groups with notifications instead of creating a lot of email noise, which could result in users ignoring notifications.

The following categories are supported. Some categories are tiered, so that subscribing to a parent category automatically subscribes you to the children. You can also directly subscribe to the child categories.

• Job - Parent category. Notifies you of all child events. The following are direct Job events: conflict state changes, expected run length events, interrupts and resubmissions. In addition, notifies you at the Info level when jobs complete successfully, or at the Error level when they fail.
  • Job Chain - Notifies you when jobs are chained, or fail to chain.
  • Job Config - Notifies you when job configuration is updated including chain and conflict configuration. Useful for tracking changes.
• Job Recovery - Notifies you when job recovery occurs (e.g. when there are outages) and other runtime issues (terminal states Conflict Missed, Abandoned and Died) .
• Licence - Notifies you of licence verification events.
• Queue - Notifies you of queueing issues, which may indicate database or other platform problems. Also used to track startup/shutdown/pause/resume events for scheduler nodes.
• System Parameter - Notifies you of system parameter changes. Useful for tracking changes.

Minimum Notification Severity

The following notification severities are supported for the above categories. Note that some categories do not support all severities.

• Info - Include all notifications
• Warning - Don't include informational notifications (e.g. job completion, configuration updates, etc.)
• Error - Only include error conditions (e.g. job failures, queueing issues, etc.)

Job-Specific Subscriptions

For the Job category and its children, you can choose to subscribe to an individual job, rather than all jobs. In addition, the notification severity can be set separately for each job, so you may choose to be notified of job failures for all jobs, but only be notified of successful completion of a certain set of critical jobs.

This can be used to set up fine-grained notification subscriptions for various stakeholders within your organization.

Job Execution Subscriptions

When setting up a notification subscriber in Obsidian, you have precise control over which job executions will result in notifications. Not only can you target specific jobs or execution states, but you can also trigger notifications based on specific job output results conditions. You can even be alerted when a job succeeds after finishing with a failure state on a previous run.

Job-Specific Subscriptions

For each job execution subscription, you can select specific jobs it applies to, or apply it to all jobs. In addition, you can set up as many subscriptions as you require, each with their own trigger states and job result conditions.

This provides fine-grained control over which specific job execution conditions result in notifications, preventing unwanted email noise.