Skip to main content

NIM

Job Guard Notification Tutorial

When a the number of tasks in a job item equals or exceeds its defined threshold, NIM does not execute any of that job item's tasks. In this event, it is useful to send a notification to NIM administrators so that they can examine the job and either adjust the threshold, or fix any potential data issues. Follow the steps in this tutorial to set up this notification.

Create a Notification Template

Before notifications can be sent out to administrators, an email template must be created that will display information about the job thresholds. This email template can be used over and over again for any number of jobs where threshold notifications are necessary.

  1. Navigate to Events > Templates

  2. Click the +Add button to add a new template.

  3. Name the template "Job-Guard-Notification" and click Create.

  4. In the Notification Event dropdown, select a job-guard event for one of your jobs.

  5. Provide a valid From and To address, along with a suitable Subject.

  6. In the email body, click the + button and add the event > job_guard_tasks variable.

    job-guard-tasks-add.png

  7. In the email body, click the + button and add the event > job_threshold_violation variable.

    job-guard-threshold-violation-add.png

  8. Click Save.

Create a Notification Action

  1. Navigate to Events > Actions

  2. Click the +Add button to add a new action

  3. In the Event type dropdown, select job-guard.

    add-event-job-guard.png

  4. In the Event name dropdown, select the job you want this notification to apply to.

  5. Click Add. A new row will be appended to the event actions table.

  6. In the Template dropdown of the new row, select Job-Guard-Notification.

  7. Uncheck the Success checkbox so this notification is only sent when part of the job fails to run due to the thresholds being met or exceeded.

  8. Click Save.

In this section: