Button handy | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Button handy | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Panel | ||||||
---|---|---|---|---|---|---|
| ||||||
This page is about Time to SLA for Jira Cloud. Using Jira On-Prem? Click the On-Prem button above. |
Time to SLA allows you to define and track an unlimited number of SLAs, helping you keep promises and improve customer satisfaction. On the SLAs page, which you can access from the app’s top bar, you can define new SLAs, manage your existing SLAs, and manage notifiers.
On this page:
|
---|
SLAs overview
SLAs – Click to access all of your SLAs.
Search bar – Choose a filter from the dropdown, like "Priorities", and then use the search box to find specific elements within that category. For instance, search for "Blocker" to target SLAs with that priority.
Keep in mind that the limits in the search bar are based on the values added in the SLA context.
Hide disabled SLAs – Check this box to hide disabled SLAs from view. To disable an SLA, click the three-dot icon next to it, and select Disable.
List of SLAs – All of the SLAs in your instance are listed here. Clicking on the name of any SLA will take you to its configurations, allowing you to edit it. By clicking on the arrow next to them, you can reveal the details about the SLA, and then use "Columns" on the right-hand side to filter which details you want to see in this view (SLA Context, SLA Conditions, SLA Goals, etc.).
Columns – Add or remove columns that display information about the selected SLA on the SLAs page. You can change their order by dragging and dropping them on the table.
SLA Options Menu – After expanding the details of an SLA by clicking the arrow next to it, you can click the three-dot icon on the right-hand side to reveal the options menu for the SLA.
Edit – Click here to modify the SLA by updating any field. Alternatively, click on the SLA name to open the editing screen.After editing, you must recalculate the SLA data for the issues; otherwise, you may run into miscalculations. Click here to find out how to recalculate SLA data.
Manage notifiers – This option allows you to set up notifications and manage them for your SLA.
Clone – Clicking this optionduplicates that SLA.
Enable/Disable – Click to enable or disable the SLA. When an SLA is disabled, all SLA actions are stopped. The SLA won’t appear in fields, reports, and other configurations. You can use this feature to hide SLAs that are irrelevant to your workflow but might be needed in the future. Disabling such SLAs preserves configurations for potential future use.
Delete – This action is irreversible and will permanently remove the SLA.
Define an SLA
This documentation provides step-by-step instructions on creating an SLA using the Time to SLA app for Jira Cloud.
Log in to your Jira Cloud account.
Click Apps in the header menu and open the Time to SLA app.
Navigate to SLAs from the header menu.
Upon installation, the SLAs page appears empty if no SLAs are imported. Click + SLA or Create your first SLA to define your first SLA.
Step 1: Set up your SLA definition
Enter a clear and concise name for your SLA that reflects its purpose.
Optionally, add a description for the SLA.
Select the project(s) to which the SLA will be applied. As you select the projects, the issues under those projects will be listed below. You can finetune your selection by checking off the boxes next to the issues. If you want to narrow down the scope of the SLA even more, you can do so in the SLA Goals step.
Note |
---|
SLAs created using the old interface (created before June 20) cannot be cloned. You must create new ones using the new system. |
Step 2: Define your SLA goals
Set your SLA goals, which are time limits or deadlines set within your specified context. They are tracked according to your working hours.
Each goal can be a specific timeframe (days, hours, minutes) or a fixed deadline, such as a due date or custom field in Jira issues. If your SLA includes multiple goals, they are prioritized from top to bottom. The remaining issues will be handled under a default goal.
Use the + Add goal button to configure goals. Add SLA goal screen opens.
Goal Name: Enter the name of the goal.
Goal Issues: Select the issues the goal will apply to. If you select Only specific issues in selected projects, a dropdown will be revealed and you’ll need to perform a set of configurations to narrow down the SLA scope. You can directly select the issue types the SLA will be applied to, or click + More to select issues based on:
Request Type – Tailor the SLA to the unique needs of that type of request. For instance, you might want different SLAs for bug fixes, feature requests, or support queries.
Issue Type – Each project can have different Issue Types (e.g., Bug, Task, Story). Choosing an Issue Type ensures that the SLA is applicable to issues falling under that specific category.
Issue Priority – Assigning an SLA to a particular Priority ensures that the defined service levels are applied based on the criticality of the issue (e.g., Highest, High).
Issue Filter – Allows you to apply the SLA to a subset of issues based on a predefined filter, giving you extra flexibility.
JQL (Jira Query Language) – Allows you to create sophisticated queries to filter and retrieve specific sets of issues and apply the SLA to matching the criteria defined in the JQL query. This is particularly useful for advanced users who want to create dynamic and customized SLA conditions.
Goal Calendar: Select the goal calendar. You can also use the Select calendar via Jira issue feature to ensure teams can dynamically select their calendar based on their geographical location.
Goal Target Type: There are five you can choose from. Refer to the related documentation to learn more about each type.
Add other goals as needed to reflect all SLA requirements. Once you’re done, proceed to SLA conditions.
Step 3: Set your SLA conditions
Select your SLA conditions. Time to SLA lists the most widely used conditions inspired by real-world scenarios to save time; however, you can click + More Condition Types to reveal many other options. For example, you might start time when an issue is created, pause time while you wait for the customer to respond, and stop time when the issue is resolved. You can add more than one condition.
Check out the screenshots below to see some examples:
Conditions can be connected using logical operators, with the default being the OR (“Any of the following conditions”) operator, meaning the SLA starts when any of the conditions are met. Alternatively, you can use the AND (“All of the following conditions”) operator. In this case, the SLA will start only when all conditions within a group are met.
You can also create Grouped Conditions to construct intricate SLA use cases by organizing conditions into logical groups with specific connectors.
For more information about SLA conditions, refer to the related documentation.
Once you click Save, your SLA will be created.
Step 4: Dive into advanced configurations
If you want to dive into more advanced configurations, click Edit. The advanced configurations are:
Calculation Method – Select the calculation method for the elapsed duration. Your options are All Cycles, First Cycle, Largest Span, and Last Cycle.
By default, All Cycles are selected. For example, if the SLA starts with an Open status and ends with a Resolved status, the All Cycles method will add up all the cycles between Open and Resolved statuses. Click here to learn more about Calculation Methods.
Critical Zone Percentage – This is a parameter that you can set to signal when an SLA has reached what you would describe as a critical status. When an SLA enters this zone, the SLA Panel’s color will change from blue to orange. Learn more about the SLA Panel here.
➡️ Did you know that you can create special notifications that will alert you and your team when an SLA is in the critical zone? Learn how here.
SLA Custom Field – Add this custom field to screens where you would like to see SLA target date information. Only date/time custom fields can be selected as the target date, hence why only these custom fields are available within the drop-down menu. Please note that this is an optional custom field that will need to be added to the relevant screens. The installation of Time to SLA does not automatically add it to issues. To learn how, refer to this documentation.
Linked Issue SLA – You can select whether to display this SLA in linked issues and specify which link types it’ll be displayed in. When you link two issues, you’ll be able to see the SLA Panel on both of them.
To better understand how this function works, let’s explore an example:
Assume there are two issues: Issue 1 in "Project 1" and Issue 2 in "Project 2". The link created between these issues is as follows:
"Issue 1 blocked by Issue 2" hence "Issue 2 blocks Issue 1 ". The SLA configuration only has "Project 1" defined for the SLA scope Projects and is configured to display Linked Issues Blocks.
With this configuration, the expectation is that you should be able to see the SLA of the linked issue "Issue 1" on "Issue 2".
Don’t forget to click Save.
🚀 Next steps
On this page, we explained how you can set up an SLA. Before we continue, we recommend you try creating two SLAs for your own use:
Time to resolution
First response time
Or you can check out our ready-made SLA templates, and customize them to your specific use case. If you ever encounter any problems while creating them, check out FAQ: SLAs – we may have already listed the answers to some of your questions!