How to troubleshoot common issues with SLAs?

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問


プラットフォームについて: Cloud のみ - この記事は クラウド プラットフォームのアトラシアン製品に適用されます。

目的

This article aims to explain how to quickly troubleshoot issues with your SLA configuration and help analyze the SLAs you see in the issue view.

前提条件

At least have a basic understanding of how to use SLA in Jira Service Management. Please refer to Create service level agreements (SLAs) to manage goals for further information about this.

Here are some steps that help debug the cause

  1. Identify what is wrong with your SLA on an issue. Is it missing/incorrect/in the wrong state(completed/running/paused)?
  2. Review your SLA configuration under Project settings > SLA 

    a
    . START/PAUSE and STOP conditions: Are these aligned with your business needs? Are the same triggers used for multiple conditions?
    For example, having the same conditions defined for START and STOP can trigger multiple cycles of SLA on the issue
    In such cases, you can see multiple cycles on the SLA for each START and STOP condition met in the issue history. Click on the tab "within 4h" to get a list of all completed cycles.
    Now verify if these cycles match your configuration


    b. The target that is supposed to be displayed on the issue, you would need to match the JQL of each goal to figure it out
    For example, if the ticket is supposed to have 8h on TIme to first response SLA but shows 4 hrs then verify the goals to see if the issue matches any in the top-down order. The one that matches first is applied


  3. Check the SLA entries stored on the issue

    You can perform a GET API call to retrieve all SLA information

    Using Postman or curl perform the below call to retrieve the SLA records on an issue

    Using this response, we can see that there are two completed cycles and one ongoing cycle of Time to First response SLA. You can then use these times(startTime, stopTime, elapsedTime, etc) as reference to cross check for events in the issue history tab.

  4. If you find a mismatch, that is, wrong SLA on the issue or the SLA panel empty then we would need to manually recalculate the SLA using the steps from SLAs in Jira Service Management that are missing or disappear
  5. Check if you need to modify your SLA (if the existing is causing issues) and perform a recalculation on the tickets

    Modifying the SLA configuration will automatically re-index the ongoing cycles to match the new configuration. However, you might need to run the recalculation manually for the ones with completed cycles as shown in SLAs in Jira Service Management that are missing or disappear

Common Issues

課題原因ソリューション
SLA missing on issue
  • Missing SLAs would many times be caused due to inconsistent state of the SLA
  • Sometimes, the issue doesn't match any of the goals defined in the SLA and ends up with the last default goal "All remaining issues" = No target
  • Issues could have been moved between projects or imported causing some inconsistencies

SLAs in Jira Service Management that are missing or disappear

SLA incorrectly applied
  • Multiple start conditions can cause different cycles created when either of the condition is encountered. In some cases, you might have set the conditions purposely to roll back the SLA or keep track of the time taken for each update made on the ticket. Often we can see that such configurations can lead to a new cycle being triggered but not completed which leaves the SLA in the running state and messes up the SLA reports
  • SLA matches multiple goals and this might reflect the wrong SLA target
  • In some cases, the cycles might have been accidentally triggered due to an automation update or triggered event while you were unaware of the concept of SLA cycles leaving the SLA clock ticking.
Review the SLA configuration following steps 1-4 and fix the configuration as needed. 

You may have to manually trigger recalculation on issues where the SLA has been met already
SLA continues to tick even after the issue is closed/stopped condition is met
  • In some cases, you might have set the conditions purposely to roll back the SLA or keep track of the time taken for each update made on the ticket. Often we can see that such configurations can lead to a new cycle being triggered but not completed which leaves the SLA in the running state and messes up the SLA reports
  • In some cases, the SLA continues to tick despite meeting the stop condition.Agents/Users added in the fields such as Approvers, Request Participants, Organization member, or the Reporter would be considered customers on the issue. Therefore, if an agent is part of these fields then "Comment: For Customer" can't stop the SLA when the agent adds a comment. Verify if this is the cause 
  • In some cases, the SLA continues to tick even if the issue is Closed. Verify if the SLA stop conditions match the Issue's history
Review the SLA configuration and verify if it aligns with the issue activity.

After making the necessary correction, a recalculation might be required to correct the SLA

Some Known Bugs

Other articles related to SLA

If you need further assistance, please contact Atlassian Support along with the below information included

  • Affected Project
  • Affected SLAs
  • Sample issue keys
  • Any troubleshooting steps performed before reaching out
最終更新日: 2025 年 1 月 29 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.