Your Change Management Data Template

Jira Service Management
Your Change Management Data Template

Your Change Management Data Template

This template provides a comprehensive guide to collecting the necessary data for analyzing your Change Management process. It outlines essential attributes, key activities to track, and practical guidance for extracting your data from Jira Service Management. Use this resource to build an accurate event log and gain deep insights into your change process.
  • Recommended attributes to collect
  • Key activities to track for your process
  • Extraction guidance for Jira Service Management
New to event logs? Learn how to create a process mining event log.

Change Management Attributes

These are the recommended data fields to include in your event log for a comprehensive analysis of your change management process.
5 Required 8 Recommended 7 Optional
Name Description
Activity
ActivityName
The name of a specific business event or task that occurred within the change management process.
Description

This attribute records the name of the activity that took place at a specific point in time for a change request. These activities are derived from status transitions, workflow steps, or specific log entries within Jira, such as 'Change Submitted For Review' or 'Implementation Started'.

Analyzing the sequence and frequency of these activities is the core of process mining. It allows for the discovery of the actual process flows, identification of bottlenecks between steps, and analysis of process variants against the standard operating procedure.

Why it matters

It defines the steps of the process, which is essential for discovering process maps, analyzing variants, and identifying bottlenecks.

Where to get

Typically derived from the Jira issue history, specifically from status transitions or updates to custom fields that represent process milestones.

Examples
Change Request ApprovedRisk Assessment PerformedChange ImplementedPost-Implementation Review Done
Change Request ID
ChangeRequestId
The unique identifier for a single change request case, grouping all related activities from creation to closure.
Description

The Change Request ID is the primary key that uniquely identifies each change initiative within Jira Service Management. It serves as the case identifier for process mining, linking all events, status changes, and updates into a cohesive end-to-end process view.

In analysis, this ID allows for the reconstruction of the complete lifecycle of every change. It is essential for tracking individual changes through various stages like risk assessment, approval, implementation, and review. All metrics, KPIs, and dashboards rely on this attribute to correctly aggregate and correlate event data for a specific change.

Why it matters

This is the fundamental case identifier, making it possible to trace the full journey of a change request and analyze its performance.

Where to get

This is the standard Jira Issue Key, found in the key field for issues of the Change request type.

Examples
ITSM-1024CHG-2023-001CR-5921
Start Time
EventTime
The exact timestamp indicating when a specific activity or event occurred.
Description

The Start Time, or event timestamp, marks the precise date and time that an activity was recorded for a change request. Every activity in the event log, from creation to closure, has an associated timestamp.

This attribute is critical for all time-based analysis in process mining. It is used to calculate cycle times, durations between activities, waiting times, and to determine the sequence of events. It forms the basis for performance monitoring, SLA adherence calculations, and bottleneck identification.

Why it matters

This timestamp is the foundation for all performance and duration analysis, enabling the calculation of cycle times and identification of delays.

Where to get

The timestamp of each entry in the Jira issue history log. For the creation event, this is the created field.

Examples
2023-10-26T10:00:00Z2023-11-01T14:35:10Z2023-11-05T09:00:00Z
Last Data Update
LastDataUpdate
The timestamp indicating the last time the data for this record was refreshed or extracted.
Description

This attribute records the date and time when the data was last pulled from the source system. It represents the freshness of the data within the process mining tool.

Analyzing this attribute helps users understand how current the process data is, which is important for operational dashboards and real-time monitoring. It provides context for the analysis, ensuring that decisions are not made on stale data.

Why it matters

Indicates the freshness of the data, ensuring that analyses are relevant and based on up-to-date information.

Where to get

This is a metadata field populated by the data extraction tool at the time of the data pull.

Examples
2024-01-15T02:00:00Z2024-01-16T02:00:00Z
Source System
SourceSystem
Identifies the system from which the change management data was extracted.
Description

This attribute specifies the source system where the process data originated. For this context, the value is consistently 'Jira Service Management'.

In a broader enterprise context where data might be merged from multiple systems, this field is crucial for data lineage, troubleshooting, and understanding system-specific process variations. It ensures clarity on the origin of the data being analyzed.

Why it matters

Provides clear data provenance, which is essential when combining data from multiple systems or for auditing purposes.

Where to get

This is a static value added during data extraction to label the origin of the dataset.

Examples
Jira Service Management
Approval Cycle Time
ApprovalCycleTime
The duration from when a change is submitted for review until it is formally approved.
Description

This is a calculated metric that measures the time elapsed between the 'Change Submitted For Review' activity and the 'Change Request Approved' activity. It isolates the approval phase of the change lifecycle for focused analysis.

This metric directly supports the 'Change Approval Cycle Time' dashboard and the corresponding KPI. It is used to identify bottlenecks in the approval process, whether they are with specific approval groups, change types, or risk levels. Reducing this time can significantly accelerate the overall change delivery process.

Why it matters

Directly measures the efficiency of the approval stage, helping to pinpoint and address delays in getting changes authorized.

Where to get

Calculated by subtracting the timestamp of 'Change Submitted For Review' from the timestamp of 'Change Request Approved' for a given Change Request ID.

Examples
2 days 4 hours8 hours 30 minutes5 days
Assignee
Assignee
The user currently responsible for acting on the change request.
Description

The Assignee is the individual user who is responsible for the current step or activity in the change management workflow. The assignee can change multiple times throughout the lifecycle of a change request as it moves between different people and teams.

This attribute is used to analyze workload distribution, identify user-specific bottlenecks, and understand resource allocation. The 'Change Team Activity Workload' dashboard relies on this data to show which individuals or groups are handling the most activities.

Why it matters

This helps analyze resource performance and workload distribution, identifying individual or team bottlenecks.

Where to get

This is the standard assignee field on a Jira issue.

Examples
Alice JohnsonBob WilliamsCharlie Brown
Change Status
ChangeRequestStatus
The current or historical status of the change request at the time of the event.
Description

This attribute indicates the status of the change request, such as 'Awaiting Approval', 'In Progress', or 'Closed'. The status field in Jira is fundamental to its workflow engine, and changes to this field are primary drivers of the process flow.

Analyzing the status allows for tracking the progress of active changes and understanding the outcomes of completed ones, for example, 'Closed - Successful' versus 'Closed - Failed'. It is key to building throughput dashboards and analyzing rework loops where a status reverts to a previous state.

Why it matters

It provides a clear view of a change request's progress and final outcome, which is crucial for throughput and rework analysis.

Where to get

This is the standard status field of a Jira issue. The available statuses are defined in the project's workflow configuration.

Examples
PlanningAwaiting ApprovalImplementingClosedCanceled
Change Type
ChangeRequestType
The classification of the change, such as Standard, Normal, or Emergency.
Description

The Change Type categorizes the change request based on its nature, urgency, and impact. Common types include 'Standard' for pre-approved, low-risk changes, 'Normal' for routine changes requiring full approval, and 'Emergency' for urgent changes to fix incidents.

This attribute is essential for process analysis as different change types often follow different process paths and have different SLAs. It is used to calculate the 'Emergency Change Rate' KPI and to filter dashboards to compare the performance and risk associated with each type.

Why it matters

It enables segmentation of the process to analyze different workflows, such as standard vs. emergency changes, which have unique performance expectations and risks.

Where to get

This is typically a custom field in Jira Service Management projects. The field name may vary but is often named 'Change Type'.

Examples
StandardNormalEmergency
Priority
Priority
The priority level assigned to the change request, indicating its business importance.
Description

The Priority field helps teams determine the order in which to address change requests. It reflects a combination of impact and urgency and guides scheduling and resource allocation.

Analyzing priority allows for performance comparisons between high and low priority changes. For example, one can check if high-priority changes truly have shorter cycle times or if they get stuck in the same bottlenecks as other changes. This is valuable for optimizing resource focus and meeting business expectations.

Why it matters

Enables analysis of process performance based on business priority, ensuring that critical changes are being expedited as expected.

Where to get

This is the standard priority field on a Jira issue.

Examples
HighestHighMediumLow
Risk Level
RiskLevel
The assessed risk level associated with the change, such as Low, Medium, or High.
Description

The Risk Level is a mandatory assessment in most change management processes, categorizing the potential negative impact of a change. The level is determined during the risk assessment phase and often influences the required approval workflow.

In process mining, this attribute is critical for risk-based analysis. It supports the 'Risk Assessment Accuracy & Outcome' dashboard by correlating the initial risk with the actual outcome. It is also the primary dimension for the 'Change Failure Rate by Risk Level' KPI, helping to evaluate if high-risk changes are managed effectively.

Why it matters

Allows for analyzing if process controls and approval workflows are effective for different risk profiles, and helps correlate risk with change failure rates.

Where to get

This is typically a custom field in Jira Service Management. Common names include 'Risk Level' or 'Impact'.

Examples
LowMediumHighCritical
SLA Status
SLAStatus
Indicates whether the change request was completed within its target completion date.
Description

This is a calculated attribute that compares the actual resolution date of a change request with its 'Target Completion Date'. The result is a simple status, such as 'Met' or 'Breached'.

This provides a clear, at-a-glance indicator of performance for the 'Change SLA Performance Monitor' dashboard. It simplifies the creation of KPIs like 'Change SLA Adherence Rate' by pre-calculating the status for each case. This allows for easy filtering and aggregation to see which types of changes, teams, or services are most often associated with SLA breaches.

Why it matters

Provides a clear, binary outcome for SLA performance on each case, simplifying reporting and analysis of SLA adherence.

Where to get

Calculated by comparing the timestamp of the final 'Change Closed' activity with the 'TargetCompletionDate' attribute.

Examples
MetBreached
Target Completion Date
TargetCompletionDate
The planned or Service Level Agreement (SLA) deadline for the change request's completion.
Description

This attribute stores the date by which the change request is expected to be completed to meet its SLA. It is the benchmark against which the actual completion time is measured.

This date is fundamental for monitoring performance against commitments. It is the basis for the 'Change SLA Performance Monitor' dashboard and the 'Change SLA Adherence Rate' KPI. By comparing the actual resolution date with this target, organizations can measure their service delivery effectiveness.

Why it matters

This is the primary data point for calculating SLA adherence and identifying which changes are at risk of breaching their deadlines.

Where to get

This is often the duedate field in Jira or a value from a configured SLA metric in Jira Service Management.

Examples
2023-11-15T17:00:00Z2023-12-01T23:59:59Z2024-01-10T09:00:00Z
Business Service
BusinessService
The business service or application impacted by the change.
Description

This attribute links the change request to a specific business service defined in the Configuration Management Database (CMDB), such as 'Email Service' or 'Customer CRM'. This is a key concept for understanding the business impact of a change.

Analyzing changes by business service helps prioritize efforts and communicate impact to stakeholders. It allows for a view of which services are undergoing the most change, which are most at risk, and where change-related incidents are concentrated. This is vital for managing technical changes from a business-centric standpoint.

Why it matters

Connects technical changes to business impact, allowing for prioritization and risk analysis based on the criticality of the affected service.

Where to get

This is often a custom field in JSM, frequently linked to Jira Assets (formerly Insight) or another CMDB.

Examples
Corporate WebsiteSAP ERPInternal Wiki
Change Reason
ChangeReason
The justification or business reason for proposing the change.
Description

This attribute captures the underlying reason for the change, such as 'New Feature Implementation', 'Bug Fix', or 'Infrastructure Upgrade'. It provides crucial context beyond the summary or description.

In analysis, the reason for a change can be correlated with other metrics like cycle time, failure rate, and risk level. This helps answer questions such as, 'Do changes related to bug fixes get approved faster than new feature implementations?' or 'Do infrastructure upgrades have a higher failure rate?'.

Why it matters

Provides business context that allows for deeper analysis by correlating the purpose of a change with its performance and outcome.

Where to get

This is typically a custom field in Jira Service Management, often a select list or text field.

Examples
Security PatchSoftware UpgradeNew Hardware Installation
Is Rework
IsRework
A boolean flag that is true if the change request has undergone a rework loop.
Description

This calculated attribute identifies change requests that have been sent back to a previous stage for modifications, for example, moving from 'Awaiting Approval' back to 'Planning'. It signals that the initial submission was incomplete, incorrect, or did not meet the necessary criteria.

This flag is the basis for the 'Change Rework Rate' KPI and the 'Change Rework and Rejection Analysis' dashboard. By flagging rework cases, analysts can easily filter for them and investigate the root causes, such as poor initial planning, unclear requirements, or insufficient risk assessment.

Why it matters

Highlights process inefficiency by explicitly flagging cases that required extra, unplanned work, enabling analysis of the root causes of rework.

Where to get

Calculated by analyzing the sequence of activities in the event log. A rework is detected if a later-stage activity is followed by an earlier-stage activity.

Examples
truefalse
Post Implementation Issue
PostImplementationIssue
A flag indicating if an incident or problem was linked to this change after implementation.
Description

This attribute indicates whether the change resulted in a negative outcome, such as a production incident. This often involves linking the change request issue to one or more incident issues in Jira.

This data is essential for calculating the 'Post-Implementation Issue Rate' and 'Change Failure Rate' KPIs. It provides a direct measure of change quality and the effectiveness of the planning, testing, and risk assessment processes. Analyzing which changes lead to issues helps in refining controls and preventing future failures.

Why it matters

Directly measures the quality and success of a change by tracking whether it caused subsequent operational issues.

Where to get

This is typically derived by checking for linked issues in Jira, specifically if a Change issue has 'is caused by' links from Incident issues.

Examples
truefalse
Reporter
Reporter
The user who initially created or submitted the change request.
Description

The Reporter is the individual who created the change request issue in Jira. This is often the change owner or someone initiating the change on behalf of a team.

Analyzing the reporter can help identify which departments, teams, or individuals are initiating the most changes. It can be used to spot trends in change sources and provide feedback or training to groups that frequently submit incomplete or low-quality change requests.

Why it matters

Helps identify the sources of change requests, which can be analyzed to improve the quality of initial submissions.

Where to get

This is the standard reporter field on a Jira issue.

Examples
David MillerEva GreenFrank Wright
Resolution
Resolution
The final outcome of a closed change request, indicating how it was resolved.
Description

When a change request is closed, the Resolution field provides specific information about the outcome. For example, 'Done' indicates success, while 'Won't Do' or 'Duplicate' provide other closure reasons. This provides more context than the 'Closed' status alone.

This attribute is essential for analyzing change success and failure rates. For instance, the 'Post-Implementation Issue Rate' KPI can be better understood by filtering for changes with a 'Failed' or 'Rolled Back' resolution. It helps distinguish successfully implemented changes from those that were canceled or rejected after approval.

Why it matters

Provides detailed context on the final outcome of a change, which is crucial for accurately calculating success and failure rates.

Where to get

This is the standard resolution field in Jira, which is typically set when an issue moves to a 'Done' status category.

Examples
DoneWon't DoDuplicateCanceledRolled Back
Team
Team
The team or group responsible for the change request or a specific activity.
Description

This attribute identifies the team assigned to work on the change. While Jira has an 'Assignee' field for individuals, a 'Team' field is often used to assign work to a functional group, such as 'Network Operations' or 'Database Administrators'.

This is crucial for the 'Change Team Activity Workload' dashboard. It allows for analysis of performance and bottlenecks at a team level, rather than just an individual level, which is often more useful for resource planning and management.

Why it matters

Facilitates workload and performance analysis at the team or department level, highlighting systemic bottlenecks.

Where to get

This is usually a custom field in Jira, as there is no standard 'Team' field. It could be of type 'Group Picker' or a simple select list.

Examples
Infrastructure TeamCore ServicesApplication Support
Required Recommended Optional

Change Management Activities

These are the key process steps and milestones to capture in your event log for accurate change management process discovery.
5 Recommended 8 Optional
Activity Description
Change Awaiting Approval
Indicates that the change request has passed initial review and is now waiting for a formal decision from the Change Advisory Board (CAB) or designated approvers. This is captured from a status change in the workflow, such as moving to 'Pending Approval' or 'Awaiting CAB'.
Why it matters

This activity is key to measuring approval wait times and identifying bottlenecks in the decision-making phase, which directly impacts the Change Approval Cycle Time KPI.

Where to get

Inferred from the Jira issue history by identifying the timestamp when the 'status' field changes to an approval state like 'Pending CAB Approval' or 'Awaiting Approval'.

Capture

Track timestamp of status change to a designated 'Awaiting Approval' status.

Event type inferred
Change Closed
Represents the final closure of the change request, indicating that all associated activities are complete. This is captured when the Jira issue status is changed to a final, resolved state like 'Closed' or 'Done'.
Why it matters

This is the primary end point of the process. It is used to calculate the overall cycle time and determine adherence to SLAs.

Where to get

Inferred from the Jira issue history by identifying the timestamp when the 'status' field changes to a final closed state. The resolution field is also typically set at this time.

Capture

Track timestamp of status change to 'Closed' or 'Done'.

Event type inferred
Change Implemented
A key milestone indicating that the work associated with the change has been completed. This is captured via a status change to a state like 'Implemented' or 'Pending Verification' in the Jira workflow.
Why it matters

This marks the end of the implementation phase and is crucial for calculating implementation lead time. It is also the trigger for post-implementation review and verification activities.

Where to get

Inferred from the Jira issue history by identifying the timestamp when the 'status' field changes to 'Implemented' or 'Pending Post-Implementation Review'.

Capture

Track timestamp of status change to 'Implemented' or similar.

Event type inferred
Change Request Approved
A critical milestone where the change has been formally approved for implementation. This is almost always captured by inferring a status change to a state like 'Approved' or 'Ready for Implementation' in the Jira workflow.
Why it matters

This event marks the end of the approval cycle and the start of the implementation phase. It is essential for measuring approval cycle times and tracking unauthorized changes.

Where to get

Inferred from the Jira issue history by identifying the timestamp when the 'status' field transitions to an 'Approved' state.

Capture

Track timestamp of status change to 'Approved' or 'Ready to Implement'.

Event type inferred
Change Request Created
Represents the initial creation of a change request ticket in Jira Service Management. This event is explicitly logged with a creation timestamp when a new issue of the 'Change' type is saved for the first time.
Why it matters

This is the starting point for all change requests, crucial for measuring the overall lead time and analyzing the volume of incoming changes over time.

Where to get

Captured from the 'created' timestamp on the Jira issue object. This is a standard system field available for every issue and can be retrieved via the issue history or API.

Capture

Use the 'created' field timestamp from the Jira issue.

Event type explicit
Change Canceled
Represents the termination of a change request before implementation or completion. This is captured when the Jira issue status changes to a terminal state like 'Canceled' or 'Withdrawn'.
Why it matters

This alternative end point helps in analyzing why changes are abandoned. A high cancellation rate may indicate poor initial planning or changing business priorities.

Where to get

Inferred from the Jira issue history by identifying the timestamp when the 'status' field changes to a 'Canceled' state and a corresponding resolution is set.

Capture

Track timestamp of status change to 'Canceled' or 'Withdrawn'.

Event type inferred
Change Request Rejected
Represents the formal rejection of a change request, which typically sends it back to the requester for more information or cancels it. This is captured by a status change in the Jira workflow to 'Rejected' or 'Needs More Info'.
Why it matters

Tracking rejections is vital for analyzing the Change Rework Rate. A high frequency of this activity indicates issues with the quality of initial change submissions.

Where to get

Inferred from the Jira issue history by identifying the timestamp when the 'status' field changes to a 'Rejected' or similar terminal state.

Capture

Track timestamp of status change to 'Rejected' or 'Declined'.

Event type inferred
Change Scheduled
Indicates that the approved change has been assigned a specific implementation window. This is inferred from the population or update of 'Planned start date' and 'Planned end date' fields within the Jira issue.
Why it matters

This activity provides visibility into the forward planning of changes. It helps in resource management and assessing the time between approval and scheduled implementation.

Where to get

Inferred from the Jira issue history by capturing the timestamp when date fields like 'Planned start date' or 'Change window' are populated.

Capture

Track timestamp of population for 'Planned start date' field.

Event type inferred
Change Submitted For Review
Marks the point where the initial information for the change request is complete and it is formally submitted for assessment. This is typically captured by inferring a status change in the Jira workflow, for example, from 'Draft' to 'Pending Review'.
Why it matters

This activity initiates the approval cycle. Measuring the time from this point to approval is critical for calculating approval cycle time KPIs and identifying early-stage bottlenecks.

Where to get

Inferred from the Jira issue history by identifying the timestamp when the 'status' field changes to a review state like 'Pending Review' or 'Awaiting Assessment'.

Capture

Track timestamp of status change to 'Pending Review', 'Submitted', or similar.

Event type inferred
Implementation Started
Marks the beginning of the technical implementation of the approved change. This is typically captured by a Jira status change from 'Approved' or 'Scheduled' to 'In Progress' or 'Implementing'.
Why it matters

This activity starts the clock for measuring the Average Implementation Lead Time, helping to identify bottlenecks during the execution phase.

Where to get

Inferred from the Jira issue history by identifying the timestamp when the 'status' field changes to an active implementation state like 'In Progress'.

Capture

Track timestamp of status change to 'In Progress' or 'Implementing'.

Event type inferred
Post-Implementation Review Done
Indicates the completion of the formal review that assesses the success of the change and identifies lessons learned. This is typically captured by a status change in the workflow, such as moving from 'Post-Implementation Review' to 'Verified'.
Why it matters

This activity is essential for process improvement. Measuring the cycle time for this review helps ensure that learnings are captured promptly.

Where to get

Inferred from the Jira issue history by identifying the timestamp when the 'status' field moves out of a 'Post-Implementation Review' state.

Capture

Track timestamp of status change from 'PIR' to a subsequent state.

Event type inferred
Risk Assessment Performed
Represents the completion of the risk and impact analysis for the proposed change. This event is often inferred from the issue history when risk-related custom fields, such as 'Risk Level' or 'Impact', are populated or updated.
Why it matters

Analyzing this activity helps evaluate the accuracy of risk assessments and ensures compliance with change policies. It is essential for calculating risk-based KPIs like the Change Failure Rate by Risk Level.

Where to get

Inferred from the Jira issue history by capturing the timestamp when specific fields like 'Risk Level', 'Impact', or 'Urgency' are set or changed for the first time.

Capture

Track timestamp of first population for fields like 'Risk Level' or 'Impact'.

Event type inferred
Testing Performed
Represents the completion of post-implementation testing to validate the change. This may be a distinct status like 'In Testing' or inferred from comments or updates by a QA team after the 'Change Implemented' event.
Why it matters

Analyzing the duration and outcomes of testing helps evaluate the quality of implementations and the effectiveness of the testing process. It is a key input for calculating the Post-Implementation Issue Rate.

Where to get

This can be inferred from a status change to 'Testing' or 'Under Test', or by analyzing comments and assignee changes in the issue history after implementation.

Capture

Track timestamp of status change to 'In Testing' or from comments.

Event type inferred
Recommended Optional

Extraction Guides

How to get your data from Jira Service Management