Timepiece - Time in Status for Jira

How to Build SLA Metrics Based on Custom Negotiated Start or End Dates

This article explains how to create SLA metrics in Timepiece - Time in Status for Jira using custom date fields as the starting or ending point of an SLA calculation. This approach allows SLA measurements to be based on dates agreed or negotiated for individual work items instead of relying only on workflow events such as status transitions.

Business Need

SLA commitments may be agreed individually for different work items, resulting in different expected start or end dates. You may need to evaluate whether a work item was completed within its agreed timeframe. Using custom date fields as SLA boundaries and targets allows these dates to be included in the SLA evaluation.

Use Case

In this example, the SLA metric is based on three custom date fields defined for each work item:

  • Actual Start Date determines when the SLA measurement begins.

  • Actual End Date determines when the SLA measurement ends.

  • Due Date defines the SLA target date.

This configuration allows the SLA performance of each work item to be evaluated using its actual start and end dates while considering its individually defined due date.

Step 1: Create the SLA Metric

  • Open the Timepiece reporting page and select the SLA Report.

  • Open the Metrics panel and add a new SLA metric.

  • Enter a name for the metric, such as Resolution Time.

  • Set the Start At field to Actual Start Date.

  • Set the Stop At field to Actual End Date.

  • If certain statuses should be excluded from the calculation, select them in the Pause On field.

The SLA metric measures the period between the configured start and end dates.

Timepiece SLA Metrics modal with a red border highlighting Date Field configuration using Actual start and Actual end

Step 2: Set the SLA Target

  • Select Date Field Based as the target type.

  • Select Due Date as the target date field.

  • Save the SLA metric configuration.

Timepiece SLA Metrics modal with a red border highlighting the Target section set to Date Field Based using Due date
  • Run the SLA Report after saving the SLA metric configuration.

Step 3: Generate the SLA Report

The report evaluates each work item using its Actual Start Date, Actual End Date, and Due Date values.

Timepiece SLA report dashboard showing Actual start, Actual end, and Due date fields alongside Resolution Time SLA metrics

The SLA result shows whether the work item meets or breaches the defined target based on its individual dates.

You can add additional SLA metrics to the report when different SLA commitments need to be monitored.

The View Format options can be used to display the Elapsed, Target, and SLA values separately for each metric.

Timepiece SLA report view displaying date fields with the Show SLA Details toggle highlighted in the display format menu

For more information about configuring SLA Metrics and targets, see SLA Metrics.