SLA notifications
This page is about Time to SLA for Jira Cloud. Using Data Center? Click here.
You can send notifications about your SLAs to the right people at the right time. When you first define an SLA, two notifications are automatically created. These notifications alert you when reaching predefined milestones within the SLA timeframe:
The first notification triggers at 50% of the SLA duration,
The second one triggers at 75%.
You can also create notifications according to your unique use case.
Video guide
Watch this video for a demo of the steps provided in this article.
Prerequisites
For notifications to work, make sure you have enabled Outgoing Mail in Jira. To do that, click the cog icon in the Jira top bar, and open System > Outgoing Mail > Enable Outgoing Mail.
It is essential to have the related permissions before creating a TTS notification for a specific SLA. The person responsible for creating the notification must have the necessary authorization to access the relevant issues related to the scope of this SLA.
Steps
Open the SLAs page.
Find the SLA you want to add the notifier to, and expand it by clicking on it.
Click the settings button, and then Manage Notifiers.
Click Add New SLA Notification. The SLA Notification pop-up screen appears.
Enable Global Notifier if you want this notification configuration to be applied to all of your SLAs.
If you want repeated notifications at regular intervals, select when you want to be notified and when to stop receiving repeated notifications. The options are:
is breached – you’ll receive a notification when the SLA is breached.
will be breached in – you'll be able to get notifications before the Target Date is reached. TTS uses this value to send a notification before the SLA Goal is met. For example, if you enter 1h, you will be notified 1 hour before the Target Date is reached.
has been breached for – you’ll receive a notification when your SLA has been breached for the time period you’ve chosen.
has reached – you’ll be notified when SLA reaches the percentage you’ve chosen. For example, if you enter 90% as the SLA Goal Ratio, the notification will be sent when 90 percent of the SLA goal has elapsed.
is over – you’ll be notified when the SLA is finished.
All time values must be in the Jira time format (for example, 1d 2h 30m
).
Check the Repeat every... box to get notifications at the intervals you define.
Check the Stop repeating after... box to stop sending notifications after a certain number of notifications are sent.
Tick the Enable working calendar box if you only want TTS to send notifications during working hours.
Select the action TTS should take when the notifier is triggered. TTS can:
Send an email – You can customize the subject and content of the email. Here you can use dynamic parameters with
$
. Afterward, you can choose the recipients or add custom recipients. TTS offers a flexible way of creating dynamic email content. This page lists the notification parameters you can use.Trigger a Jira Automation Rule – For example, when an SLA is breached, you can automatically trigger a Jira automation rule to perform actions like adding comments to issues or creating incident reports. For more details on how to set this up, refer to this documentation.
Send a Slack message – Add the Slack webhook URL and, optionally, customize the Slack message.
To find or create a Slack channel webhook URL, follow these steps:
Create a Slack app:
Navigate to the Slack API: Your Apps page.
Click Create an App, and select From scratch.
Provide a name for your app, and select the workspace where you want to post messages.
Enable Incoming Webhooks:
Go to the Incoming Webhooks in your app's settings.
Toggle the Activate Incoming Webhooks switch to ON.
Generate a Webhook URL for a channel:
Click Add New Webhook to Workspace.
Select the channel where the app will post messages.
Click Allow to authorize.
After authorization, you'll receive a unique webhook URL in the format
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
that you can copy and paste into the Slack message field in TTS.
For more details, refer to Slack’s Incoming Webhooks documentation.
Click Save.
After you've saved your notification, you can use the Notifications page to edit, clone, or delete your notifications. From there, you can associate your notifications with different goals as well.