Create an SLA definition
Create SLA definitions to set the conditions under which SLAs attach, pause, stop, and reset on task records. Use them to track and enforce service commitments across your organization.
Before you begin
When you create an SLA definition, avoid using dot-walked fields that change frequently in any of the SLA conditions (start, stop, pause, and reset). The SLA engine features, such as SLA Timeline and SLA Repair, replay the audit history of the Task record that the task_sla is attached to. The SLA engine does not replay the audit history of any dot-walked fields from that Task, rather only considers the final state of the dot-walk fields.
For example, a pause condition is set to an incident dot-walk field incident.company.cost_center. The value of the Cost Center is first set to Finance and later changed to Engineering. When the SLA repair runs, only the final value of the Cost Center is considered. So, if the SLA pause condition is: incident.company.cost_center is Engineering, SLA Repair pauses immediately, because SLA Repair does not consider the previous Cost Center value: Finance. This condition also applies to SLA Timeline (and when executing the SLA Engine asynchronously).
If the requirement is to pause when incident.company.cost_center is Engineering and not Finance, then the audit history must be on the Task record using a custom field. Create a custom field (in this example on the incident table) such as: u_company_cost_center and a business rule to populate the field when either the company changes or the Cost Center of the company changes. Instead of setting the SLA pause condition to the dot-walked field, set it against the custom field. This approach helps that the task_sla, SLA Repair, and SLA Timeline show consistent results.
Note: The deeper the dot walk, the more business rules are required.
Role required: admin
Procedure
Navigate to All > Service Level Management > SLA > SLA Definitions.
Select New.
The SLA Definition form is displayed.
On the form, fill in the fields.
| Field | Description |
|---|---|
| Name | Name that identifies the SLA definition. |
| Type | The type of agreement being defined: SLA, OLA, or Underpinning contract. Note: Type is used for reporting purposes only. |
| Target | The target of the agreement being defined: None, Response, or Resolution. Target is used for filtering, searching, and reporting purposes only.Note: This feature is available only in new instances starting with Jakarta or a later release. |
| Table | Table that determines the records tracked by the SLA. SLAs can be defined for any table that extends the task table, including incident, change request, and service catalog tasks. You can also create an SLA definition for configuration items \(CIs\) and business services for Event Management. |
| Flow | The flow to run when the SLA definition attaches to a Task record. Selecting a flow disables the Workflow field. |
| Workflow | The workflow to run when the SLA definition attaches to a Task record. Selecting a workflow disables the Flow field. |
| Vendor | The vendor associated with the SLA definition. |
| Service Commitment | Option to differentiate between a normal SLA definition and a service offering SLA definition. |
| Enable logging | Option to activate debug logging for this SLA definition only.The debug logging information includes details of the conditions that have matched or not matched, and the before and after values for the task SLA and task records. |
| Duration type | The method for calculating the duration of the SLA. The duration can be a User specified duration where the working hour and time zone specifies the duration before the SLA is marked as breached.The second type of duration is Relative Duration, where a date and time in the future is configured. For example, Breach on Due Date or End of next business day can be selected. If the date and time in the Due Date field is outside the schedule for the task SLA, the breach time is set to the next available scheduled time. For more information, see SLA duration types. |
| Duration | The length of time the SLA runs before it is marked Breached. This field appears only when the duration is User specified duration. Note: The number of days specified in this field is converted to 24-hour blocks. If the Schedule field identifies a schedule with eight-hour days, a duration of 1 Day sets the SLA to breach three business days later. |
| Relative duration works on | The record that the relative duration should be calculated for. The working hours, date and time zone recorded for relative duration are dependent on either the schedule of related Task record or the defined SLA record. This field appears only when the relative duration is selected in the Duration type field. For more information, see SLA duration types. |
| Schedule source | The schedule to be used when creating task SLAs. You can specify one of the following options:- No schedule: If the No Schedule option is selected, the SLA calculates the schedule duration based on a 24 x 7 schedule. - SLA definition: If the SLA definition option is selected, the Schedule list appears. Schedule: Specify the hours during which the SLA timer runs.
Schedule source field: Select the appropriate field from the task such as an incident or problem that provides the schedule. For example, Configuration item > Schedule. |
| Timezone Source | The time zone source to be used when creating task SLAs. One of the following time zones can be specified:- The caller's timezone. - The SLA definition's timezone: If the The SLA definition's timezone option is selected, the Timezone list appears. Timezone: Specify a time zone for the SLA. The time zone can be the system time zone or active standard geographical time zones.
|
| Tabs | |
| Start condition | Defines the conditions under which the SLA is attached. From the When to cancel list, you can choose the conditions under which the SLA is canceled.
Note: The Retroactive pause time check box is available only when the duration is a user-specified duration. |
| Pause condition | Define the conditions under which the SLA suspends increasing elapsed time. From the When to resume list, you can choose the conditions under which the SLA resumes increasing elapsed time.
|
| Stop condition | Defines the conditions under which the SLA completes. If all these conditions match, then the task SLA completes regardless of whether it is breached. |
| Reset condition | Determines whether the existing task is canceled or completed on task SLA reset. Defines the conditions under which the running SLA is canceled or completed and a new SLA is attached. For a new SLA to be attached, the start condition must match. Reset condition also helps to configure SLAs when the value of any specific field on the task record changes, changes to, or changes from a specific value. For example, the value of the Location field in the task record is 101 Broadway East, Seattle, WA. If you set the SLA reset condition as Location changes from 101 Broadway East, Seattle, WA, any change in the value of the Location field resets the SLA of the task record. |
| Fields that can be added by configuring the form | |
| Condition type | Condition type that determines when an SLA attaches, pauses, completes, or resets. |
Parent Topic:Configure Service Level Agreement (SLA)