> 持续流程改进 > 问题管理 > Jira Service Management > 数据模板

您的问题管理数据模板

Jira Service Management

您的问题管理数据模板

此模板为分析IT服务管理工作流提供全面指引，帮助您识别Jira Service Management中的关键数据点和流程里程碑。模板梳理了全面了解团队如何处理潜在问题和开展根因分析所需的属性与活动。您可以依照这些指引简化数据收集，确保流程挖掘项目产出可执行的洞察。

深入分析建议使用的属性
建议记录在事件日志中的流程里程碑
数据提取技术指南

刚接触事件日志？了解如何创建流程挖掘事件日志.

下载模板

问题管理属性

为全面分析问题管理生命周期，建议在事件日志中纳入以下数据字段。

5 必填 5 建议填写 10 选填

	名称	说明
	最近数据更新时间 LastDataUpdate	数据提取或最近一次刷新的时间戳。
说明显示数据集最近一次与实时Jira Service Management环境同步的时间，帮助分析人员了解数据的新鲜度。此时间可用于确认分析反映的是流程的最新状态，并发现潜在的数据延迟问题。重要性确保数据保持最新，帮助您信任分析结果。获取途径 ETL时间戳示例 2023-11-01T12:00:00Z2023-11-02T00:00:00Z
	时间戳 EventTimestamp	活动发生的确切日期和时间。
说明此属性记录活动发生的准确时刻，用于按时间顺序排列事件并计算步骤间的时长。准确的时间戳对于计算周期时间至关重要，例如从“记录问题”到“已识别根因”的用时，也可用于分析一段时间内的处理量。重要性用于计算所有基于时间的KPI，并确保事件顺序正确。获取途径 Jira变更日志创建日期或问题创建日期示例 2023-10-15T08:30:00Z2023-10-15T09:15:22Z2023-10-16T14:20:00Z
	活动 ActivityName	问题记录发生的具体操作或状态变更。
说明此属性记录问题管理生命周期中发生的事件或状态转换名称。例如“记录问题”“状态变更为调查中”或“已识别根因”。它对于绘制流程图和识别解决问题所经历的步骤顺序至关重要。在流程挖掘中，这些活动构成流程图中的节点。重要性用于定义流程图中的步骤，并分析流程变体。获取途径 Jira变更日志（History）或问题状态转换记录示例创建问题记录开始调查识别根因更新临时解决方案关闭问题记录
	源系统 SourceSystem	数据来源系统的名称。
说明标识提取流程数据的软件系统。在此场景中，该值始终为“Jira Service Management”。在多系统环境中，此属性有助于区分数据来源；但在当前视图中，它主要用于静态标识数据沿袭。重要性说明数据来源，尤其是在与其他IT服务管理数据合并时。获取途径硬编码或系统配置示例 Jira Service ManagementJira CloudJSM-Prod
	问题记录 ProblemKey	Jira Service Management为问题记录分配的唯一标识符。
说明此属性是流程挖掘分析的核心案例标识符，代表Jira Service Management创建新问题记录时生成的唯一键（例如PM-1001）。系统使用该标识符将所有相关活动、状态变更和更新归入同一个端到端流程实例。分析此属性，可以呈现问题从最初发现、调查到最终关闭的完整生命周期。重要性这是重建流程顺序流并跟踪具体问题记录所需的基础标识符。获取途径问题表，字段Key或Issue Key 示例 PM-1023PM-4099PRB-3321PM-5001
	优先级 Priority	分配给问题记录的严重程度。
说明表示问题的紧急程度和影响范围，通常从“低”到“严重”不等。此字段可用于细分分析，并确保高优先级问题在SLA目标时间内得到解决。分析此属性有助于通过“SLA合规与目标趋势”仪表板，确认关键业务风险是否得到正确的优先处理。重要性可根据业务重要程度细分流程绩效。获取途径问题字段“Priority” 示例最高高中低
	已分配的支持组 SupportGroup	当前负责调查问题的技术团队或小组。
说明标识事件发生时负责处理问题记录的具体团队。在Jira Service Management中，这通常映射到“Component”或“Support Group”等自定义字段。此属性对于“支持组交接瓶颈”仪表板至关重要，可帮助分析人员查看问题在团队间的流转情况，以及问题在哪个团队停留时间最长。重要性对于组织层面的流程挖掘和识别跨团队协作阻力至关重要。获取途径问题字段“Component”或自定义字段“Support Group” 示例数据库管理网络运维应用支持二级
	根本原因类别 RootCauseCategory	对问题根本原因的分类。
说明对导致问题的技术故障或流程失效进行分类，例如“软件缺陷”“人为错误”或“硬件故障”。这通常是Jira Service Management中的自定义字段。此属性支持“根本原因类别分布”仪表板，帮助您决定应在哪些基础设施或培训方面投入资源，以防止问题再次发生。重要性有助于识别系统性问题并制定预防措施。获取途径自定义字段“Root Cause”或“Root Cause Category” 示例软件缺陷配置错误容量问题供应商问题
	用户 UserKey	执行该活动的用户的唯一标识或名称。
说明记录负责执行特定活动的人员或系统账户身份，例如更新记录的“经办人”或更改状态的“作者”。这些数据可用于分析资源利用情况、发现用户之间交接的瓶颈，并确保问题管理流程中的责任明确。重要性对于分析交接、职责分离和资源工作负荷至关重要。获取途径 Jira变更日志中的“author”字段或问题中的“assignee”字段示例 j.smithsystem_automationm.doe
	问题摘要 ProblemSummary	问题记录的简短描述或标题。
说明包含问题记录的摘要。虽然主要是文本内容，但可为分析人员在流程挖掘工具中查看个案提供背景信息。您可以通过关键词搜索和定性分析，了解记录的问题类型。重要性为案例标识提供易于理解的背景信息。获取途径问题字段“Summary” 示例欧盟区域数据库连接超时电子邮件服务延迟激增订单处理队列停滞
	SLA违约状态 SlaBreachStatus	表示问题记录是否违反服务级别协议。
说明用于指示解决时间是否超过约定目标的布尔值或状态字段。此字段可用于“SLA合规与目标趋势”仪表板。它会标示可能使组织面临合规风险或处罚的案例。重要性对于合规和绩效监控至关重要。获取途径 Jira Service Management SLA字段逻辑示例已达标已违约已暂停
	关联事件数 LinkedIncidentCount	与此问题记录关联的事件数量。
说明与问题记录关联的事件工单数量。此属性用于量化问题对用户群体的影响。它可用于“事件与问题关联深度”KPI，优先处理产生大量支持工单的问题。重要性根据事件数量量化业务影响。获取途径 “issuelinks”表中类型为“Problem/Incident”的关联数量示例 011550
	关联变更请求 LinkedChangeRequest	与此问题关联的变更请求标识。
说明存储为实施永久修复方案而创建的变更请求（RFC）ID。此关联对于“变更请求发起延迟”仪表板至关重要。它将问题管理流程与变更管理流程关联起来，支持跨流程分析。重要性将问题调查与变更管理流程中的修复工作关联起来。获取途径类型为“is fixed by”或类似类型的问题关联示例 CR-404CHG-1099CR-5512
	创建日期 CreatedDate	问题记录的创建日期。
说明问题首次录入系统的时间戳。事件时间戳用于记录活动时间，而此属性通常用于高层级筛选，例如“显示第一季度创建的所有问题”。它是账龄分析的起始时间点。重要性用于账龄和问题提交量分析的基准日期。获取途径问题字段“Created” 示例 2023-01-012023-06-15
	发现来源 DetectionSource	问题的发现方式，例如主动发现或被动发现。
说明表示问题被发现的来源。常见值包括“主动监控”“服务台事件”或“供应商通知”。此属性用于“主动与被动发现”仪表板，以衡量问题管理流程的成熟度。重要性衡量流程成熟度和监控系统的有效性。获取途径自定义字段“Source”或“Detection Source” 示例主动监控事件升级供应商通知
	已开展PIR ReviewStatus	表示是否执行了实施后评审（PIR）。
说明跟踪案例中是否存在“实施后评审”活动或标记。此字段对于“实施后评审合规”仪表板至关重要。它可确保组织遵循治理要求，持续改进。重要性衡量组织学习情况的合规指标。获取途径自定义字段“PIR Status”或是否存在“PIR”活动示例已完成待处理不需要
	报告人 ReporterName	最初提交问题记录的用户。
说明标识创建问题记录的人员，与经办人不同。分析报告人有助于了解问题的发现来源，例如服务台专员或系统管理员。这为“主动与被动发现”分析提供了更多背景信息。重要性标识问题的提交来源。获取途径问题字段“Reporter” 示例 monitoring_servicehelpdesk_leadnetwork_admin
	是否重新打开 IsReopened	标记问题是否在关闭后重新打开。
说明布尔标记：如果问题记录从关闭状态重新转为打开状态，则设为true。此字段支持“问题重新打开率分析”。重新打开率较高，可能表明永久修复方案存在质量问题，或验证流程不充分。重要性用于衡量修复效果的质量指标。获取途径根据状态变更推导示例 truefalse
	有可用的临时解决方案 WorkaroundDetails	表示是否已为该问题记录临时解决方案。
说明记录是否存在或已发布临时解决方案的文本。组织可据此跟踪“临时解决方案发布速度”。分析此字段有助于了解团队在找到永久修复方案之前，能否及时恢复服务稳定性。重要性衡量为业务提供临时缓解措施的速度。获取途径自定义字段“Workaround” 示例重启服务清除浏览器缓存未提供
	解决代码 ResolutionCode	表示问题解决方式的代码。
说明指定问题记录的最终结果，例如“已修复”“不予修复”“重复”或“无法复现”。此字段可用于筛选已成功解决的问题，排除因管理原因关闭的问题，从而确保“根本原因平均查明时间”等KPI计算准确。重要性区分有效修复与管理性关闭。获取途径问题字段“Resolution” 示例已完成不予处理重复无法复现

必填建议填写选填

问题管理活动

为准确发现问题解决工作流，建议在事件日志中记录以下关键流程步骤和里程碑。

8 建议填写 6 选填

	活动	说明
	事件关联至问题	将相关事件工单关联至问题记录。可从问题链接表或历史记录中捕获此操作。
重要性用于确定问题的影响和范围，是计算“事件到问题关联深度”KPI以及根据业务影响确定优先级的必要数据。获取途径 Jira问题链接：创建类型为causes或relates to的链接采集创建问题链接时记录事件类型 explicit
	关闭问题记录	问题生命周期的最终结束。状态变更为Closed时会明确记录。
重要性流程实例的最终结束，是计算总周期时间和关闭率的必要数据。获取途径 Jira问题历史记录：状态变更为Closed 采集状态转换为Closed时记录事件类型 explicit
	分配至支持组	将问题记录分配给特定技术团队或支持组。可通过跟踪自定义字段Support Group的变更来记录；若未使用组，则跟踪Assignee字段。
重要性这是分析团队间交接和瓶颈的关键数据。频繁转派可能表明路由效率低下。获取途径 Jira问题历史记录：字段Support Group或Assignee发生变更采集分配字段变更时记录事件类型 explicit
	创建问题记录	在系统中创建问题工单时产生的初始事件。问题历史记录会明确保存创建时间戳。
重要性标记问题管理生命周期的开始，可用于数量分析，也是计算处理量和受理速率的必要数据。获取途径 Jira问题表：Created Date时间戳，或History选项卡：Issue Created事件采集问题创建事务提交时记录事件类型 explicit
	开始调查	问题状态转换为正在调查等活动调查状态（例如Under Investigation或In Progress），标志着实际处理阶段开始。
重要性从此时开始计算调查周期时间，有助于区分积压等待时间与实际分析时间。获取途径 Jira问题历史记录：状态变更为Under Investigation或In Progress 采集比较状态字段更新事件类型 inferred
	更新临时解决方案	填写或更新Workaround文本字段，表示已记录临时修复方案。
重要性衡量为业务缓解问题的速度，是计算“临时解决方案可用周期时间”KPI的关键数据。获取途径 Jira问题历史记录：字段Workaround发生变更（非空）采集 Workaround字段修改时记录事件类型 explicit
	识别根因	正式记录问题根本原因的节点。可根据状态变更为Root Cause Identified，或填写Root Cause字段来推断。
重要性这是调查阶段结束的重要里程碑，也是计算“根因发现平均时间”的必要数据。获取途径 Jira问题历史记录：状态变更为Root Cause Identified，或填写Root Cause字段采集比较状态字段，或检查字段是否已填写事件类型 inferred
	验证解决结果	确认修复方案已有效解决问题。可根据状态转换为Resolved或特定的Verified状态来推断。
重要性这是确保修复有效的质量关卡。此处延误可能表明测试或用户验收存在瓶颈。获取途径 Jira问题历史记录：状态变更为Resolved或Verified 采集比较状态字段更新事件类型 inferred
	关联变更请求	将变更请求（RFC）关联至问题记录，表示永久修复流程已启动。
重要性衡量从识别原因到开始修复之间的延迟，是计算“变更管理转换延迟”KPI的依据。获取途径 Jira问题链接：创建类型为is fixed by的链接，或关联至Change类型的问题采集创建指向Change类型问题的链接时记录事件类型 explicit
	实施后评审	修复方案实施后开展评审。可通过状态变更为In Review或更新PIR专用字段来捕获。
重要性用于确保记录经验教训的合规活动，可用于分析“实施后评审合规情况”。获取途径 Jira问题历史记录：状态变更为In Review，或更新PIR Notes字段采集比较状态字段或PIR字段更新事件类型 inferred
	实施永久修复	表示解决方案已实施的状态转换，通常可根据状态变更为Implementing或Fixed来推断。
重要性标记技术修复工作的结束，用于衡量实施周期时间。获取途径 Jira问题历史记录：状态变更为Implemented、Pending Verification或Fixed 采集比较状态字段更新事件类型 inferred
	违反SLA	表示问题解决时间超过既定服务级别协议的事件。通过比较SLA目标日期与解决日期计算得出。
重要性这是合规报告的关键数据，有助于识别最常未达目标的优先级或类别。获取途径 Jira Service Management SLA日志：Time to Resolution超过目标值，或通过计算得出采集根据SLA字段数据推算，或比较Due Date与Resolution Date 事件类型 calculated
	重新打开问题	问题状态从Resolved或Closed重新变为活动状态，表示修复失败或解决方案未获认可。
重要性这是一项核心质量指标。重新打开率偏高，可能表明根因分析或测试效果不佳。获取途径 Jira问题历史记录：状态从Closed或Resolved变更为Open或In Progress 采集比较状态字段的变更顺序事件类型 inferred
	问题优先级变更	问题记录的Priority字段更新。可通过监控历史记录中Priority字段的变更来捕获。
重要性表示问题升级或降级。分析此项有助于判断初始分诊是否准确，以及高优先级积压问题的滞留情况。获取途径 Jira问题历史记录：字段Priority从旧值变更为新值采集 Priority字段更新时记录事件类型 explicit

建议填写选填

数据提取指南

如何从Jira Service Management获取数据

步骤

使用浏览器登录您的Jira Service Management实例，并使用拥有问题管理项目“浏览项目”权限的账户。
在顶部菜单栏中选择“筛选器”，然后点击“高级问题搜索”打开问题导航器。
如果当前使用的是基本搜索，请切换到JQL（Jira查询语言）模式。
在下方的查询部分输入指定的JQL查询字符串，以筛选问题记录（例如：project = 'Problem Management'）。请确保时间范围符合系统的导出限制。
点击“搜索”，确认结果列表中包含预期的问题记录。
在问题导航器界面的右上角找到“导出”按钮。
在下拉菜单中选择“导出XML”。不要选择CSV，因为标准CSV导出仅包含当前状态数据，不含流程挖掘所需的历史变更日志。
将生成的XML文件（例如jira_export.xml）保存到处理环境可访问的本地目录。
如果尚未安装，请在Python环境中安装所需的pandas库。
执行查询部分提供的Python脚本，并确保文件路径变量与保存的XML文件位置一致。
脚本会解析RSS/XML结构，提取“创建”时间戳、状态/优先级/分配变更的“历史”记录，以及相关事件的“问题链接”。
脚本会比较解决日期与到期日期，计算SLA违约情况，并输出格式化的CSV事件日志，供ProcessMind使用。

配置

导出格式：必须使用XML（RSS）格式导出，不能使用CSV。XML格式包含重建流程所需的<history>和<issuelinks>标签。
行数限制：Jira标准导出通常每次最多导出1,000个问题。对于更大的数据集，您需要调整JQL日期范围（例如：created >= '2023-01-01' AND created < '2023-02-01'）分批提取，并执行多次导出。
JQL筛选条件：确保project键与您的问题管理项目标识符一致（例如：PROB、PM）。
系统时区：请确认执行导出的用户资料时区与系统时区一致，以确保时间戳准确。
字段权限：用户必须拥有查看变更历史和关联问题的权限，才能提取状态变更和事件关联信息。
自定义字段：如果“根本原因”或“临时解决方案”是自定义字段，请确保脚本的字段名称匹配逻辑与您的Jira实例中的字段名称一致。

查询示例 sql

import xml.etree.ElementTree as ET
import pandas as pd
from datetime import datetime
import io

# CONFIGURATION
# Path to the exported Jira XML file
INPUT_FILE = 'jira_export.xml'
OUTPUT_FILE = 'process_mining_event_log.csv'
SOURCE_SYSTEM = 'Jira Service Management'

# JQL USED FOR EXPORT (Reference Only)
# project = "Problem Management" AND created >= "2023-01-01" ORDER BY created DESC

def parse_jira_xml(xml_file):
    tree = ET.parse(xml_file)
    channel = tree.getroot().find('channel')
    
    events = []
    
    # Namespaces are usually not required for standard Jira RSS XML, 
    # but we handle standard tags directly.
    
    for item in channel.findall('item'):
        # 1. Extract Header Attributes
        problem_key = item.find('key').text
        summary = item.find('summary').text if item.find('summary') is not None else ''
        created_str = item.find('created').text
        resolution_date_node = item.find('resolutiondate')
        due_date_node = item.find('duedate')
        
        # Parse base timestamps
        # Jira XML format example: Wed, 4 Oct 2023 14:30:00 +0000
        fmt = '%a, %d %b %Y %H:%M:%S %z'
        created_dt = datetime.strptime(created_str, fmt)
        
        # --- ACTIVITY 1: Problem Record Created ---
        events.append({
            'ProblemKey': problem_key,
            'ActivityName': 'Problem Record Created',
            'EventTimestamp': created_dt,
            'UserKey': item.find('reporter').get('username') if item.find('reporter') is not None else None,
            'SourceSystem': SOURCE_SYSTEM,
            'ProblemSummary': summary,
            'Priority': item.find('priority').text if item.find('priority') is not None else None
        })

        # --- ACTIVITY: Incident Linked / Change Request Linked ---
        # Check <issuelinks> tag
        issue_links = item.find('issuelinks')
        if issue_links is not None:
            for linktype in issue_links.findall('issuelinktype'):
                link_name = linktype.find('name').text # e.g., 'Relates', 'Blocks', 'Caused'
                for outward in linktype.findall('outwardlinks'):
                    for issue_link in outward.findall('issuelink'):
                        linked_key = issue_link.find('issuekey').text
                        # Heuristic: Identify link type based on key pattern or link description
                        activity = None
                        if 'INC' in linked_key: # Customize for your Incident Prefix
                            activity = 'Incident Linked to Problem'
                        elif 'CHG' in linked_key: # Customize for your Change Prefix
                            activity = 'Change Request Linked'
                        
                        if activity:
                             events.append({
                                'ProblemKey': problem_key,
                                'ActivityName': activity,
                                'EventTimestamp': created_dt, # Link timestamp often not in XML, defaulting to created or requires API. fallback.
                                'UserKey': 'System',
                                'SourceSystem': SOURCE_SYSTEM,
                                'ProblemSummary': f'Linked to {linked_key}',
                                'Priority': None
                            })

        # --- PROCESS HISTORY (Status, Priority, Assignment, etc.) ---
        # Note: History is not always in standard RSS. 
        # If utilizing the 'SearchRequestView' XML, history is included inside <customfields> or specific expansion.
        # However, typically standard RSS does NOT include full history.
        # Assuming this XML export includes the Activity Stream or we rely on Custom Field dates for specific milestones.
        
        # LOGIC FOR INFERRING ACTIVITIES FROM CURRENT STATE & DATES (If History missing)
        # Or parsing <subtasks> or <comments> as proxies.
        
        # --- ACTIVITY: SLA Breached ---
        if resolution_date_node is not None and due_date_node is not None:
            res_date = datetime.strptime(resolution_date_node.text, fmt)
            due_date = datetime.strptime(due_date_node.text, fmt)
            
            if res_date > due_date:
                events.append({
                    'ProblemKey': problem_key,
                    'ActivityName': 'SLA Breached',
                    'EventTimestamp': res_date,
                    'UserKey': 'System',
                    'SourceSystem': SOURCE_SYSTEM,
                    'ProblemSummary': summary,
                    'Priority': None
                })

        # --- ACTIVITY: Problem Record Closed / Resolved ---
        if resolution_date_node is not None:
             events.append({
                'ProblemKey': problem_key,
                'ActivityName': 'Problem Record Closed',
                'EventTimestamp': datetime.strptime(resolution_date_node.text, fmt),
                'UserKey': item.find('assignee').get('username') if item.find('assignee') is not None else None,
                'SourceSystem': SOURCE_SYSTEM,
                'ProblemSummary': summary,
                'Priority': None
            })

        # --- MOCKING HISTORY PARSING IF XML HAS HISTORY PLUGIN EXTENSION ---
        # (Standard Jira RSS export is weak on history. 
        # This block assumes the existence of a custom history export or parsing comment logs for keywords).
        
        comments = item.find('comments')
        if comments:
            for comment in comments.findall('comment'):
                body = comment.text.lower()
                c_date = datetime.strptime(comment.get('created'), fmt)
                author = comment.get('author')
                
                act_name = None
                if 'root cause' in body:
                    act_name = 'Root Cause Identified'
                elif 'workaround' in body:
                    act_name = 'Workaround Updated'
                elif 'investigation' in body:
                    act_name = 'Investigation Started'
                
                if act_name:
                    events.append({
                        'ProblemKey': problem_key,
                        'ActivityName': act_name,
                        'EventTimestamp': c_date,
                        'UserKey': author,
                        'SourceSystem': SOURCE_SYSTEM,
                        'ProblemSummary': summary,
                        'Priority': None
                    })

    return pd.DataFrame(events)

# EXECUTION
try:
    df = parse_jira_xml(INPUT_FILE)
    
    # Add global extraction timestamp
    df['LastDataUpdate'] = datetime.now()
    
    # Formatting
    if not df.empty:
        df['EventTimestamp'] = pd.to_datetime(df['EventTimestamp']).dt.strftime('%Y-%m-%d %H:%M:%S')
        
        # Output
        df.to_csv(OUTPUT_FILE, index=False)
        print(f"Success: Extracted {len(df)} events to {OUTPUT_FILE}")
    else:
        print("No events found. Check XML format or JQL.")
        
except Exception as e:
    print(f"Error processing file: {str(e)}")

步骤

准备环境：确保已安装Python 3.x以及requests和pandas库。您需要拥有相关项目读取权限的Jira Service Management账户。对于Jira Cloud，请在Atlassian账户设置中生成API Token；对于Data Center，请生成个人访问令牌（PAT）。
确定自定义字段ID：Jira Service Management的自定义字段使用动态ID（例如，支持组或SLA字段可能为customfield_10012）。运行主要提取程序前，请使用浏览器或Postman查询一个具体的问题记录（/rest/api/2/issue/[ISSUE-KEY]），确定“支持组”“临时解决方案”“根本原因”和SLA字段对应的ID。
配置脚本：打开提供的Python脚本并更新CONFIG字典，替换URL、用户邮箱和API Token。根据第2步确定的实际自定义字段名称或ID，更新FIELD_MAPPING字典。更新JQL_QUERY，以筛选您的具体项目（例如：project = PM AND issuetype = Problem）。
定义状态映射：在脚本的STATUS_MAPPING字典中，将您的Jira工作流状态（例如“调查中”“实施中”“已解决”）映射到ProcessMind的标准活动名称（例如“调查已开始”“已实施永久修复”）。
运行提取程序：通过终端或IDE执行脚本。脚本使用Jira Search API和expand=changelog参数，提取当前状态及每个字段的完整变更历史。
处理逻辑：脚本会遍历每个问题记录。首先根据创建时间戳生成“问题记录已创建”事件，然后解析变更日志历史。对于每条历史记录，脚本会检查变更字段是否属于关注列表（状态、优先级、链接等），并生成相应的事件行。
处理SLA：脚本会检查SLA相关自定义字段的变更，或名称明确为“已违约”的状态转换，以识别SLA违约情况。如果您的系统使用特定自动化规则标记违约，请调整_parse_sla_breach函数中的逻辑。
转换数据：脚本会将嵌套JSON结构展平为Pandas表格，并将时间戳转换为ISO 8601格式。
导出：最终数据集将导出为名为jira_problem_event_log.csv的CSV文件。请打开文件，确认列标题符合ProcessMind的要求。
上传到ProcessMind：将CSV文件导入ProcessMind。将ProblemKey映射为案例ID，将ActivityName映射为活动，将EventTimestamp映射为时间戳。

配置

API端点：使用/rest/api/2/search（兼容Cloud和大多数Data Center版本）。也支持API v3，但v2通常兼容性更广。
分页：脚本使用startAt和maxResults分页，高效处理大型数据集。默认批次大小为50。
展开变更日志：expand=changelog参数至关重要。若不设置此参数，返回的只有当前状态，变更历史和流程顺序流都会丢失。
JQL筛选：查询按issuetype = Problem筛选。建议添加日期范围条件（例如：created >= -180d），以便在初期测试时控制数据量。
身份验证：Cloud支持基本身份验证（邮箱+Token）。对于Data Center，请修改请求头以使用Bearer Token。
字段映射：此项配置至关重要。Jira内部的“状态”和“优先级”字段名称是标准字段，但“支持组”“根本原因”和“SLA”几乎总是自定义字段，且各自拥有唯一ID（例如：customfield_12345）。

查询示例 python

import requests
import pandas as pd
import json
from datetime import datetime
import base64

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># CONFIGURATION
class=class="hl-string">"hl-comment"># ==========================================
CONFIG = {
    class="hl-string">"JIRA_URL": class="hl-string">"https://your-domain.atlassian.net",
    class="hl-string">"USER_EMAIL": class="hl-string">"your-email@example.com",
    class="hl-string">"API_TOKEN": class="hl-string">"your-api-token-or-pat",
    class="hl-string">"PROJECT_KEY": class="hl-string">"PM",  class=class="hl-string">"hl-comment"># Problem Management Project Key
    class="hl-string">"LOOKBACK_DAYS": class="hl-string">"180"
}

class=class="hl-string">"hl-comment"># Mappings: Key = Jira Field Name/ID, Value = Activity Name context
class=class="hl-string">"hl-comment"># You must replace class="hl-string">'customfield_XXXXX' with your actual field IDs found via API
FIELD_MAPPING = {
    class="hl-string">"priority": class="hl-string">"Problem Priority Changed",
    class="hl-string">"assignee": class="hl-string">"Assigned to Support Group", class=class="hl-string">"hl-comment"># Fallback if support group field unused
    class="hl-string">"customfield_10010": class="hl-string">"Assigned to Support Group", class=class="hl-string">"hl-comment"># Replace with Support Group Field ID
    class="hl-string">"customfield_10011": class="hl-string">"Workaround Updated",      class=class="hl-string">"hl-comment"># Replace with Workaround Field ID
    class="hl-string">"customfield_10012": class="hl-string">"Root Cause Identified",   class=class="hl-string">"hl-comment"># Replace with Root Cause Field ID
    class="hl-string">"Link": class="hl-string">"Link Event",                           class=class="hl-string">"hl-comment"># Internal name for issue links
    class="hl-string">"issuelinks": class="hl-string">"Link Event"
}

class=class="hl-string">"hl-comment"># Map Jira Workflow Statuses to Standard Activities
class=class="hl-string">"hl-comment"># Update the keys (left side) to match your actual Jira Status names
STATUS_MAPPING = {
    class="hl-string">"Under Investigation": class="hl-string">"Investigation Started",
    class="hl-string">"In Progress": class="hl-string">"Investigation Started",
    class="hl-string">"Root Cause Identified": class="hl-string">"Root Cause Identified",
    class="hl-string">"Implementing": class="hl-string">"Permanent Fix Applied",
    class="hl-string">"Fixed": class="hl-string">"Permanent Fix Applied",
    class="hl-string">"Resolved": class="hl-string">"Resolution Verified",
    class="hl-string">"Verified": class="hl-string">"Resolution Verified",
    class="hl-string">"In Review": class="hl-string">"Post Implementation Review",
    class="hl-string">"Closed": class="hl-string">"Problem Record Closed",
    class="hl-string">"Breached": class="hl-string">"SLA Breached" class=class="hl-string">"hl-comment"># Only if you have a specific status for this
}

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># EXTRACTION LOGIC
class=class="hl-string">"hl-comment"># ==========================================

def get_auth_header():
    class=class="hl-string">"hl-comment"># For Cloud (Basic Auth)
    creds = fclass="hl-string">"{CONFIG['USER_EMAIL']}:{CONFIG['API_TOKEN']}"
    encoded = base64.b64encode(creds.encode()).decode()
    return {class="hl-string">"Authorization": fclass="hl-string">"Basic {encoded}", class="hl-string">"Content-Type": class="hl-string">"application/json"}
    class=class="hl-string">"hl-comment"># For Data Center (PAT), uncomment below:
    class=class="hl-string">"hl-comment"># return {class="hl-string">"Authorization": fclass="hl-string">"Bearer {CONFIG['API_TOKEN']}", class="hl-string">"Content-Type": class="hl-string">"application/json"}

def fetch_issues():
    url = fclass="hl-string">"{CONFIG['JIRA_URL']}/rest/api/2/search"
    jql = fclass="hl-string">"project = {CONFIG['PROJECT_KEY']} AND issuetype = Problem AND created >= -{CONFIG['LOOKBACK_DAYS']}d"
    
    all_issues = []
    start_at = 0
    max_results = 50
    
    while True:
        params = {
            class="hl-string">"jql": jql,
            class="hl-string">"startAt": start_at,
            class="hl-string">"maxResults": max_results,
            class="hl-string">"expand": class="hl-string">"changelog"
        }
        
        try:
            response = requests.get(url, headers=get_auth_header(), params=params)
            response.raise_for_status()
            data = response.json()
        except Exception as e:
            print(fclass="hl-string">"API Error: {e}")
            break
            
        issues = data.get(class="hl-string">"issues", [])
        if not issues:
            break
            
        all_issues.extend(issues)
        start_at += max_results
        print(fclass="hl-string">"Fetched {len(all_issues)} issues so far...")
        
    return all_issues

def parse_activity(issue):
    events = []
    
    class=class="hl-string">"hl-comment"># Basic Issue Data
    key = issue[class="hl-string">"key"]
    fields = issue[class="hl-string">"fields"]
    summary = fields.get(class="hl-string">"summary", class="hl-string">"")
    class=class="hl-string">"hl-comment"># Current values (for attributes)
    current_priority = fields.get(class="hl-string">"priority", {}).get(class="hl-string">"name", class="hl-string">"")
    current_assignee = fields.get(class="hl-string">"assignee", {}).get(class="hl-string">"displayName") if fields.get(class="hl-string">"assignee") else class="hl-string">"Unassigned"
    
    class=class="hl-string">"hl-comment"># 1. Problem Record Created
    created_time = fields[class="hl-string">"created"]
    events.append({
        class="hl-string">"ProblemKey": key,
        class="hl-string">"ActivityName": class="hl-string">"Problem Record Created",
        class="hl-string">"EventTimestamp": created_time,
        class="hl-string">"UserKey": fields.get(class="hl-string">"creator", {}).get(class="hl-string">"displayName", class="hl-string">"System"),
        class="hl-string">"SupportGroup": current_assignee,
        class="hl-string">"Priority": current_priority,
        class="hl-string">"ProblemSummary": summary,
        class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
    })

    class=class="hl-string">"hl-comment"># Process Changelog
    changelog = issue.get(class="hl-string">"changelog", {}).get(class="hl-string">"histories", [])
    
    for history in changelog:
        timestamp = history[class="hl-string">"created"]
        user = history.get(class="hl-string">"author", {}).get(class="hl-string">"displayName", class="hl-string">"Unknown")
        
        for item in history[class="hl-string">"items"]:
            field = item.get(class="hl-string">"field")
            field_id = item.get(class="hl-string">"fieldId", class="hl-string">"")
            from_str = item.get(class="hl-string">"fromString", class="hl-string">"")
            to_str = item.get(class="hl-string">"toString", class="hl-string">"")
            
            class=class="hl-string">"hl-comment"># 2, 5, 7, 9, 10, 11, 13, 14. Status Changes
            if field == class="hl-string">"status":
                activity = STATUS_MAPPING.get(to_str)
                
                class=class="hl-string">"hl-comment"># Handle Reopened logic explicitly
                if to_str in [class="hl-string">"Open", class="hl-string">"Reopened"] and from_str in [class="hl-string">"Resolved", class="hl-string">"Closed"]:
                    activity = class="hl-string">"Problem Reopened"
                
                if activity:
                    events.append({
                        class="hl-string">"ProblemKey": key,
                        class="hl-string">"ActivityName": activity,
                        class="hl-string">"EventTimestamp": timestamp,
                        class="hl-string">"UserKey": user,
                        class="hl-string">"SupportGroup": current_assignee,
                        class="hl-string">"Priority": current_priority,
                        class="hl-string">"ProblemSummary": summary,
                        class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
                    })

            class=class="hl-string">"hl-comment"># 2. Priority Changed
            elif field == class="hl-string">"priority":
                events.append({
                    class="hl-string">"ProblemKey": key,
                    class="hl-string">"ActivityName": class="hl-string">"Problem Priority Changed",
                    class="hl-string">"EventTimestamp": timestamp,
                    class="hl-string">"UserKey": user,
                    class="hl-string">"SupportGroup": current_assignee,
                    class="hl-string">"Priority": to_str,
                    class="hl-string">"ProblemSummary": summary,
                    class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
                })

            class=class="hl-string">"hl-comment"># 3. Assigned to Support Group (via custom field or Assignee)
            elif field_id == class="hl-string">"customfield_10010" or field == class="hl-string">"assignee":
                events.append({
                    class="hl-string">"ProblemKey": key,
                    class="hl-string">"ActivityName": class="hl-string">"Assigned to Support Group",
                    class="hl-string">"EventTimestamp": timestamp,
                    class="hl-string">"UserKey": user,
                    class="hl-string">"SupportGroup": to_str,
                    class="hl-string">"Priority": current_priority,
                    class="hl-string">"ProblemSummary": summary,
                    class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
                })

            class=class="hl-string">"hl-comment"># 6. Workaround Updated
            elif field_id == class="hl-string">"customfield_10011":
                if to_str: class=class="hl-string">"hl-comment"># Only if value is added/changed to something
                    events.append({
                        class="hl-string">"ProblemKey": key,
                        class="hl-string">"ActivityName": class="hl-string">"Workaround Updated",
                        class="hl-string">"EventTimestamp": timestamp,
                        class="hl-string">"UserKey": user,
                        class="hl-string">"SupportGroup": current_assignee,
                        class="hl-string">"Priority": current_priority,
                        class="hl-string">"ProblemSummary": summary,
                        class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
                    })

            class=class="hl-string">"hl-comment"># 7. Root Cause Identified (via Field Population)
            elif field_id == class="hl-string">"customfield_10012":
                if to_str:
                    events.append({
                        class="hl-string">"ProblemKey": key,
                        class="hl-string">"ActivityName": class="hl-string">"Root Cause Identified",
                        class="hl-string">"EventTimestamp": timestamp,
                        class="hl-string">"UserKey": user,
                        class="hl-string">"SupportGroup": current_assignee,
                        class="hl-string">"Priority": current_priority,
                        class="hl-string">"ProblemSummary": summary,
                        class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
                    })

            class=class="hl-string">"hl-comment"># 4 & 8. Links (Incident Linked / Change Request Linked)
            elif field == class="hl-string">"Link":
                class=class="hl-string">"hl-comment"># This requires heuristic checking of the linked key or link type
                class=class="hl-string">"hl-comment"># Assuming standard keys: INC-xxxx for Incident, CHG-xxxx or CR-xxxx for Change
                if class="hl-string">"INC-" in to_str or class="hl-string">"Incident" in to_str:
                     events.append({
                        class="hl-string">"ProblemKey": key,
                        class="hl-string">"ActivityName": class="hl-string">"Incident Linked",
                        class="hl-string">"EventTimestamp": timestamp,
                        class="hl-string">"UserKey": user,
                        class="hl-string">"SupportGroup": current_assignee,
                        class="hl-string">"Priority": current_priority,
                        class="hl-string">"ProblemSummary": summary,
                        class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
                    })
                elif class="hl-string">"CHG-" in to_str or class="hl-string">"CR-" in to_str or class="hl-string">"Change" in to_str:
                     events.append({
                        class="hl-string">"ProblemKey": key,
                        class="hl-string">"ActivityName": class="hl-string">"Change Request Linked",
                        class="hl-string">"EventTimestamp": timestamp,
                        class="hl-string">"UserKey": user,
                        class="hl-string">"SupportGroup": current_assignee,
                        class="hl-string">"Priority": current_priority,
                        class="hl-string">"ProblemSummary": summary,
                        class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
                    })
            
            class=class="hl-string">"hl-comment"># 12. SLA Breached (Detection Logic)
            class=class="hl-string">"hl-comment"># Detection depends heavily on plugins. Common method: check for SLA status field change
            elif class="hl-string">"SLA" in field or class="hl-string">"Time to Resolution" in field:
                if class="hl-string">"breach" in to_str.lower() or class="hl-string">"fail" in to_str.lower():
                    events.append({
                        class="hl-string">"ProblemKey": key,
                        class="hl-string">"ActivityName": class="hl-string">"SLA Breached",
                        class="hl-string">"EventTimestamp": timestamp,
                        class="hl-string">"UserKey": user,
                        class="hl-string">"SupportGroup": current_assignee,
                        class="hl-string">"Priority": current_priority,
                        class="hl-string">"ProblemSummary": summary,
                        class="hl-string">"SourceSystem": class="hl-string">"Jira Service Management"
                    })

    return events

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># MAIN EXECUTION
class=class="hl-string">"hl-comment"># ==========================================
if __name__ == class="hl-string">"__main__":
    print(class="hl-string">"Starting extraction...")
    issues = fetch_issues()
    
    all_events = []
    for issue in issues:
        all_events.extend(parse_activity(issue))
        
    df = pd.DataFrame(all_events)
    
    class=class="hl-string">"hl-comment"># Add LastDataUpdate
    df[class="hl-string">"LastDataUpdate"] = datetime.now().isoformat()
    
    class=class="hl-string">"hl-comment"># Export
    filename = class="hl-string">"jira_problem_event_log.csv"
    df.to_csv(filename, index=False)
    print(fclass="hl-string">"Extraction complete. Saved {len(df)} rows to {filename}")

准备好开始了吗？

立即将问题管理数据转化为可执行的洞察。下载指南或联系支持团队，开启您的流程挖掘之旅。

返回改进指南

下载模板

立即优化问题管理流程

将周期时间缩短30%，提升IT环境稳定性。

开始免费试用

无需信用卡，几分钟即可完成设置。

您的问题管理数据模板

您的问题管理数据模板

问题管理属性

问题管理活动

数据提取指南

从Jira Service Management问题导航器导出数据

步骤

配置

查询示例 sql

通过Jira REST API和变更日志使用Python提取数据

步骤

配置

查询示例 python

准备好开始了吗？

立即优化问题管理流程