从jira中提取的敏捷度量和摘要数据
jira-agile-metrics的Python项目详细描述
JIRA敏捷指标
从JIRA项目中提取敏捷度量和图表的工具。
安装
需要Python3.6或更高版本。
安装python 3和pip
包管理器。然后运行:
$ pip install jira-agile-metrics
您可以在全局范围内执行此操作,但可能需要使用虚拟python环境
(venv
)而不是保持事物的独立性。
有关 有关如何安装python和venvs的全部详细信息。
这应该在相关的bin中安装一个名为
jira agile metrics
的二进制文件
目录。您可以使用:
$ jira-agile-metrics --help
它应该会打印一条帮助消息。
使用Docker
如果您愿意,您可以使用docker来安装和运行
jira agile metrics
以及所有相关的依赖项。后
安装Docker,运行:
$ docker run -it --rm -v $PWD:/data optilude/jira-agile-metrics:latest config.yml
这将运行jira agile metrics
和配置文件config.yml
from
当前目录,将输出也写入当前目录。这个
参数-v$pwd:/data
装入/data
卷,其中输出文件
写入,到当前工作目录。你当然可以指定
不同的绑定安装。
在批处理模式下使用Docker
有第二个docker镜像,可以用来运行多个配置文件 在批处理模式下,例如一夜之间生成度量。
要使用它,请创建包含一个或多个配置文件的目录,其中
输出的扩展名.yml
或.yaml
和不同的目录。
假设它们是/path/to/config
和/path/to/output
,则可以运行
以下docker命令定期执行,例如使用cron或其他
计划程序:
$ docker run --rm -v /path/to/config:/config -v /path/to/output:/data optilude/jira-agile-metrics:batch-latest
完成后,您应该在output
目录下看到一个目录
对于config
目录中的每个配置文件,包含报告
和图表。您还将找到一个名为metrics.log
的文件,其中包含
在运行期间输出,这可能有助于诊断任何问题。
在映像名之后传递给docker run
的任何命令行参数都将是
直接传递给jira agile metrics。例如,如果你想
-n
选项用于限制从JIRA获取的结果数(用于测试
目的),您可以在
上面是命令行。
用法
基本的使用模式是使用配置运行jira agile metrics 文件,以yaml格式编写(见下文),说明:
- 如何连接到远程jira实例(也可以使用命令设置 行选项);
- 要输出哪些指标(电子表格,如数据文件、图表和图像);
- 用于计算这些指标的各种设置;以及
- 相关JIRA票证的工作流程阶段说明 通过。
然后,该工具将使用其web服务api连接到jira,运行一个查询来 相关票据及其历史记录,并计算所需的度量。
输出被写入本地文件系统文件。数据文件可以写入 csv、xlsx或json格式(取决于所需输出的扩展名 当图表被写成PNG图像时。
服务器模式
jira agile metrics
附带了一个简单的web服务器,可以用来生成
通过上载配置文件和下载包含数据的zip文件来度量
和图表。要启动它,请运行:
$ jira-agile-metrics --server 5000
这将在端口5000
上启动服务器(您还可以指定绑定主机名
或IP地址,例如0.0.0:5000
)。在Web浏览器中访问此地址并
上传一个FIle</P>
在此模式下,将忽略所有其他命令行选项。
注意:Web服务器仅为低容量使用而设计,而不是 有一个复杂的安全模型。它只是一个更容易接近的前端 命令行工具的功能。服务器将同步等待, 同时查询jira并生成图表,这可能需要很长时间。 在此期间,浏览器将等待,线程将阻塞。
警告:Web服务器不加密请求,这意味着
默认的jira凭证以纯文本传输。强烈建议你
配置反向代理(例如nginx
)并在其前面启用ssl。
使用Docker运行Web服务器
有一个单独的docker映像用于运行web服务器,它使用nginx
和uwsgi
以提高性能和稳定性(但仍然不是ssl
需要配置一个特定于域的证书:
$ docker run -d --rm -p 8080:80 --name jira_metrics optilude/jira-agile-metrics:server-latest
这将在后台程序模式下运行服务器,并将其绑定到本地 宿主。要停止,请运行:
$ docker stop jira_metrics
有关详细信息,请参见docker文档。
有关密码的重要说明
该工具使用简单的用户名/密码组合连接到jira。你 需要确保此用户存在于远程jira实例中,并且 所需权限。
有三种方法可以为jira提供证书——特别是 密码,应保存为scrret。你应该仔细考虑一下 方法对您最有意义。
- 最安全的选项是不要在配置文件中设置它,或者 命令行选项。在这种情况下,系统将提示您输入 密码(和用户名,如果你也没有设置的话)每次工具 运行。
- 您可以使用
--username
和/或--password
命令行选项来设置 当您调用jira agile metrics
命令时出现credentails。这样保持 它们不在配置文件中,但如果在交互中执行此操作 记录命令历史(即几乎所有命令)的shell 密码可能以明文形式存储在命令历史记录中! - 如果您确信可以对配置文件保密,则可以
将它们存储在
连接
部分下(请参见下文)。
你应该包括哪些问题?
最常见的用例是使用jira问题计算团队的度量
类型调用类似于story
的内容,通过一个包含如下阶段的工作流
backlog
,committed
,精化
,构建
,代码评审
,测试
,以及完成
,
并允许一组解决方案,如completed
、revacted
和duplicate
jira agile metrics
允许您使用jira jql语法指定哪些问题
有兴趣。有关更多详细信息,请参阅jira文档(或构造
使用jira用户界面进行搜索,然后让jira向您显示相应的jql)。
创建配置文件
下面是使用工作流的基本示例的配置文件示例 以上:
# How to connect to JIRA. Can also include `Username` and `Password`
Connection:
Domain: https://myjira.atlassian.net # your JIRA instance
# What issues to search for. Uses JQL syntax.
Query: Project=ABC AND IssueType=Story AND (Resolution IS NULL OR Resolution IN (Completed, Withdrawn))
# The workflow we want to analyse. By convention, the first stage should be
# the backlog / initial state, and the final stage should indicate the work
# is done.
#
# We map analytics names to JIRA status names. It's possible to collapse
# multiple JIRA statuses into a single workflow stage, as with `QA` below.
Workflow:
Backlog: Backlog
Committed: Committed
Elaboration: Elaboration
Build: Build
QA:
- Code review
- Test
Done: Done
# What outputs to produce. These are all optional. If an option isn't set
# the relevant metric will not be produced.
Output:
# CSV files with raw data for input to other tools or further analysis in a spreadsheet
# If you use .json or .xlsx as the extension, you can get JSON data files or Excel
# spreadsheets instead
Cycle time data:
- cycletime.csv
- cycletime.json
CFD data: cfd.csv
Scatterplot data: scatterplot.csv
Histogram data: histogram.csv
Throughput data: throughput.csv
Percentiles data: percentiles.csv
# Various charts
Scatterplot chart: scatterplot.png
Scatterplot chart title: Cycle time scatter plot
Histogram chart: histogram.png
Histogram chart title: Cycle time histogram
CFD chart: cfd.png
CFD chart title: Cumulative Flow Diagram
Throughput chart: throughput.png
Throughput chart title: Throughput trend
Burnup chart: burnup.png
Burnup chart title: Burn-up
Burnup forecast chart: burnup-forecast.png
Burnup forecast chart title: Burn-up forecast
Burnup forecast chart trials: 100 # number of Monte Carlo trials to run to estimate completion date
# Burnup forecast chart throughput window: 60 # Days in the past to use for calculating historical throughput
# Burnup forecast chart throughput window end: 2018-06-01 # Calculate throughput window to this date (defaults to today)
# Burnup forecast chart target: 100 # items to complete in total; by default uses the current size of the backlog
# Burnup forecast chart deadline: 2018-06-01 # deadline date, in ISO format; if not set, no deadline is drawn.
# Burnup forecast chart deadline confidence: .85 # percentile to use to compare forecast to deadline
WIP chart: wip.png
WIP chart title: Work in Progress
Ageing WIP chart: ageing-wip.png
Ageing WIP chart title: Ageing WIP
Net flow chart: net-flow.png
Net flow chart title: Net flow
提示:如果您希望将查询管理为jira中保存的过滤器,则可以
使用特殊的jql语法filter=123
,其中123
是过滤器id。
如果将此文件保存为例如config.yaml
,则可以运行:
$ jira-agile-metrics config.yaml
这将提示您输入用户名和密码,然后连接到
jira实例,获取与查询匹配的问题,计算度量,以及
将一些csv和png文件写入当前工作目录(您可以
使用--output directory
选项写入另一个目录。
在测试配置时,通常有助于获取少量
加速事情的问题。您可以通过使查询更
限制性,或使用-n
标志来限制获取的问题数:
$ pip install jira-agile-metrics
0
如果您想了解更多有关情况的信息,请使用-v
标志:
$ pip install jira-agile-metrics
1
如果你真的很好奇:
$ pip install jira-agile-metrics
2
可用指标
jira agile metrics
可以生成许多数据文件和图表,这些数据文件和图表可以
在配置文件的输出
部分启用,或使用
相应的命令行选项。
注意:在配置文件中,可以指定输出文件名,但是 不是绝对的或相对的路径。文件将始终写入当前 工作目录。这是为了防止未经授权的行为和 在上移动或使用配置文件时覆盖其他文件 一台远程机器。在中指定的输出文件不受此类限制 命令行参数。
循环时间详细信息
有关每张票据及其进入工作流每个阶段的日期的详细信息。 此文件的csv和json版本都可以由 可操作的敏捷分析工具 对敏捷流程进行强大的交互式分析。
在配置文件中:
$ pip install jira-agile-metrics
3
您还可以使用.json
或.xlsx
格式。要输出多个文件,请使用
列表如下:
$ pip install jira-agile-metrics
4
注意:"阻塞天数"的计算依赖于jira中的"标记"功能, 显示每个 票被标记为受阻。当车票在 积压或完成不算数。
累积流程图(CFD)
用于以电子表格格式创建有效累积流程图的原始数据, 和/或相同的图像文件。cfd显示了 每个阶段的流程都是一个堆积的面积图,一天一天。这样我们就可以 可视化WIP、周期时间和吞吐量。
在配置文件中:
$ pip install jira-agile-metrics
5
您还可以对数据文件使用.json
或.xlsx
格式。输出
多个文件,使用如下列表:
$ pip install jira-agile-metrics
6
只显示图表中最近的30天:
$ pip install jira-agile-metrics
7
循环时间散点图
用于创建有效周期时间散点图和/或图像的原始数据 同样的文件。此图表绘制了端到端循环时间(不包括时间 在待办事项中花费),针对每个工作项的完成日期,以及 覆盖分位数(例如,85%的门票花费18天或更少)
在配置文件中:
$ pip install jira-agile-metrics
8
您还可以对数据文件使用.json
或.xlsx
格式。输出
多个文件,使用如下列表:
$ pip install jira-agile-metrics
9
默认情况下,使用的分位数是第50、85和95个百分点,但是
可以使用输出下的
分位数选项指定不同的列表:
$ jira-agile-metrics --help
0
请注意,此选项会影响使用分位数的所有图表。
要获取数据文件中的分位数值(每个分位数的天数),请使用:
$ jira-agile-metrics --help
1
只显示图表中最近的30天:
$ jira-agile-metrics --help
2
循环时间直方图
这是循环时间的不同视图,计算和/或绘制为 直方图。
在配置文件中:
$ jira-agile-metrics --help
3
你也可以使用数据文件的de>.json或.xlsx
格式。输出
多个文件,使用如下列表:
$ jira-agile-metrics --help
4
这也符合分位数选项(见上文)。
只显示图表中最近的30天:
$ jira-agile-metrics --help
5
吞吐量
周吞吐量,即每周完成的项目数。图表 还显示趋势线。
在配置文件中:
$ jira-agile-metrics --help
6
您还可以为数据文件使用.json
或.xlsx
格式。
要将频率从每周更改为其他频率,请使用:
$ jira-agile-metrics --help
7
这里,1d
表示每天。默认值为1w-mon
,这意味着每周从
星期一. < /P>
只显示图表中最近的6个周期(如周):
$ jira-agile-metrics --help
8
在制品盒图
显示每周WIP(或其他频率)的方框图。
在配置文件中:
$ jira-agile-metrics --help
9
要将频率从每周更改为其他频率,请使用:
$ docker run -it --rm -v $PWD:/data optilude/jira-agile-metrics:latest config.yml
0
这里,1d
表示每天。默认值为1w-mon
,这意味着每周从
星期一. < /P>
只显示图表中最近的6个周期(如周):
$ docker run -it --rm -v $PWD:/data optilude/jira-agile-metrics:latest config.yml
1
净流程图
显示每周到达和离开之间的差异。在一个 完全稳定的系统,净流量为0。
在配置文件中:
$ docker run -it --rm -v $PWD:/data optilude/jira-agile-metrics:latest config.yml
2
要将频率从每周更改为其他频率,请使用:
$ docker run -it --rm -v $PWD:/data optilude/jira-agile-metrics:latest config.yml
3
这里,1d
表示每天。默认值为1w-mon
,这意味着每周从
星期一. < /P>
只显示图表中最近的6个周期(如周):
$ docker run -it --rm -v $PWD:/data optilude/jira-agile-metrics:latest config.yml
4
老化在制品图表
显示每个工作项到目前为止的周期时间,分组到 工作流程。这有助于识别慢行车票。
在配置文件中:
$ docker run -it --rm -v $PWD:/data optilude/jira-agile-metrics:latest config.yml
5
燃尽图
一个基本的敏捷燃耗图,基于已完成项的计数和 待办事项。
在配置文件中:
$ docker run -it --rm -v $PWD:/data optilude/jira-agile-metrics:latest config.yml
6
只显示图表中最近的30天:
$ docker run -it --rm -v $PWD:/data optilude/jira-agile-metrics:latest config.yml
7
带预测线的燃尽图
燃烧图的更高级版本,将运行蒙特卡洛 基于历史吞吐量的模拟以预测 范围。
可以使用一系列选项来校准模拟:
- 要运行的测试数。每项试验都将作为一项 燃烧至完成。
- 采样历史吞吐量的时间窗口。这应该 代表不久的将来,最好是6-12周。
- 要瞄准的目标,如一些故事要完成。默认值 但可以设置为假定的数字。
- 一个截止日期,如果设置了,它可以与给定时间的预测进行比较 置信区间。
在配置文件中:
$ docker run -it --rm -v $PWD:/data optilude/jira-agile-metrics:latest config.yml
8
只显示最近30天图表:
$ docker run -it --rm -v $PWD:/data optilude/jira-agile-metrics:latest config.yml
9
障碍
如果您使用JIRA中的"标记"功能将票证标记(和取消标记)为受阻 当障碍物被阻挡时,你可以制作图表来显示障碍物的数量 筹款,而累积的票款使用时间受到阻碍, 按月份细分,标志集或工作流将票证放置在后台 当旗子升起的时候。你也可以把障碍事件写在 文件
图表可以通过以下方式启用:
$ docker run --rm -v /path/to/config:/config -v /path/to/output:/data optilude/jira-agile-metrics:batch-latest
0
注意,默认情况下,只有一个值("defective"
)可用于
在jira中标记了字段,而且在使用
"set flag"
选项。但是,您可以启用
相关字段的字段配置中的值,并使该字段
在"问题编辑"屏幕上提供。
障碍物窗口(可选)可用于将图表限制为
仅显示最近几个月的数据:本例中为6。
障碍图表
和障碍状态图表
将计算
每月都有活动的障碍事件,即一张罚单被标记为
在本月的某个时间点受阻。
障碍天数图表和
障碍状态天数图表使用相同的
基本逻辑,但它不是计算障碍,而是将
每月所有障碍的天数。
请注意:
- 对积压订单或"完成"栏中的票提出的障碍是 未显示。
- 如果一张票被标记,然后在未被标记之前被解决,阻碍 时间计算到解决日期。
- 如果在生成图表时仍标记票据,则 日数将持续到今天。
- 阻塞时间总是四舍五入到最近的一整天。
缺陷密度
分析已打开缺陷数量的三个图表 历史上,以各种方式分组成堆叠条形图。
这些图表都依赖于单独的jira查询:
$ docker run --rm -v /path/to/config:/config -v /path/to/output:/data optilude/jira-agile-metrics:batch-latest
1
同样,您可以使用filter=123
jql语法来委托查询细节
到指定的筛选对象。
三个可用分组是:
- 显示每月仍有多少缺陷未解决,按优先级分组
- 显示每个月仍有多少缺陷处于打开状态,按类型分组
- 显示每个月仍有多少缺陷处于打开状态,按环境分组
它们都要求您指定相关字段的名称和图表 输出。您也可以选择指定fy每个字段的允许值列表, 这样你就可以控制顺序了。最后,您可以指定一个"窗口"来说明 最近几个月中的许多要显示(默认为显示 有数据)。下面是一个示例,它启用所有图表,并限制 显示每个月的最近六个月:
$ docker run --rm -v /path/to/config:/config -v /path/to/output:/data optilude/jira-agile-metrics:batch-latest
2
如果省略任何图表名称,则不会生成相关图表。如果 如果忽略任何字段名,则不会堆叠相关图表。如果你 省略值列表,将显示所有唯一值。
技术债务
显示记录(未解决)技术债务的性质和期限的两个图表。
这需要单独的jira查询。你还应该确定这个领域 指示优先级:
$ docker run --rm -v /path/to/config:/config -v /path/to/output:/data optilude/jira-agile-metrics:batch-latest
3
与以往一样,使用filter=123
来代替使用命名过滤器。如果你忽略了
债务优先级值
选项,将在
按字母顺序排列。
第一个图表以堆积条形图的形式显示每月未结技术债务项目 按优先级分组的图表。您可以选择指定一个"窗口"以仅显示 最近几个月的数量有限:
$ docker run --rm -v /path/to/config:/config -v /path/to/output:/data optilude/jira-agile-metrics:batch-latest
4
第二张图表显示了当前未结技术债务项目的数量 以天为单位,按优先级细分,并堆叠到"箱子"中:
$ docker run --rm -v /path/to/config:/config -v /path/to/output:/data optilude/jira-agile-metrics:batch-latest
5
这将使用0-30天、31-60天、61-90天和90天以上的年龄段 天(这也是默认值)。
废物(回收物品)
此图表显示下班后撤回或取消的工作项数量
已经开始了。它依赖于一个单独的jira查询,并假设
工作项都在jira中"解决"。此外,它假设这些工作
项目遵循与其他图表和文件相同的工作流,
即,在配置文件的工作流
部分中映射。
下面是一个示例:
$ docker run --rm -v /path/to/config:/config -v /path/to/output:/data optilude/jira-agile-metrics:batch-latest
6
这将显示按所属期间细分的已收回项目
在最近的10个时期撤回。默认期间长度为
一个月,但这里我们将其设置为2w-wed
,这意味着两周
从星期三开始。废物窗口和
废物频率都是
可选。
进度报告
在EPIC使用蒙特卡罗模拟预测的状态报告 级别:
报告显示为一个独立的HTML文件,其中嵌入了 图像。它依赖于少量常用的外部托管 库(引导程序css/js库及其jquery依赖项; FontAwesome(图标字体),但可以从任何静态Web服务器或打开 作为任何现代Web浏览器上的本地文件。它也应该印刷得相当好, 尽管嵌入的图像显示特定于上下文的累积流图 循环时间散点图只能通过点击相关的 浏览器中的图标。
状态报告基于结果原则(例如项目, 发行版,目标)被分解成史诗 进一步细分为个故事。Epics被认为是由 只有一个团队。史诗和故事以吉拉的票为代表 发现者e by jql查询在配置文件中指定,而 结果和团队直接在配置文件中列出。
然后,通过计算 史诗中假定的故事数(在最小值之间随机抽样 以及在吉拉史诗票上设定的最大故事数,或使用 针对史诗的故事总数(如果更高);的数量 迄今为止完成的反对史诗的故事;以及 相关团队的假定吞吐量(随机抽样,从一个范围 团队每周可以完成的最少到最多故事数,或 通过识别团队历史性能的jql查询)。这是 在蒙特卡洛模拟中多次进行,以确定 合理的完成日期。如果史诗电影设定了最后期限,那么 完整的将与之进行比较,以突出击中 截止日期。
模拟考虑到一个团队可能有多个 完成。团队可以配置为EPIC WIP限制为1(默认值) 或更多。如果团队一次开发多个epic,则假定 将其大致均匀地分布在所有活跃的史诗中 按照它们各自的结果在 配置文件,然后按照 用于查找它们的查询。
下面是生成类似于 上面的截图:
$ docker run --rm -v /path/to/config:/config -v /path/to/output:/data optilude/jira-agile-metrics:batch-latest
7
有关配置文件格式的详细信息
配置文件是以yaml格式编写的。如果你不熟悉 yaml,知道:
- 注释以
- 节定义为名称后跟冒号,然后缩进
在下面堵住。
连接
,输出
,工作流
和属性
区域 以上示例中的所有部分。 - 缩进必须使用空格,而不是制表符!
- 可以使用
键:value
对设置单个值。例如,燃尽图:burnup.png
以上将键设置为值burnup.png
- 值列表可以通过缩进新块并在前面放置
-
来设置 每个列表值的。在上面的示例中,qa
列表包含 值code review
和test
工作流
的部分是必需的。另外,您必须指定
单个查询
,或一组查询
(见下文)。连接详细信息必须
在连接文件中或作为命令行参数设置。
在"工作流"下,至少需要两个步骤。按顺序指定步骤。
您可以指定单个工作流值或列表(如qa
在这种情况下,多个JIRA状态将折叠为一个
用于分析的状态。
文件以及工作流状态和属性等的值都是case 不敏感。
提取其他属性
您可能需要将其他字段添加到周期时间输出数据中。使用一个
属性
阻止执行此操作:
$ docker run --rm -v /path/to/config:/config -v /path/to/output:/data optilude/jira-agile-metrics:batch-latest
8
在这里,将添加另外三列:优先级
,发布
和团队
,
对应于jira字段priority
,fix version/s
和team name
,
分别是。
指定属性时,使用字段的名称(如屏幕上所呈现的
在jira中),而不是它的id(就像在jql中一样),因此,例如使用component/s
not
组件
属性type
(问题类型)、status
和resolution
总是
包括在内。
多值字段
jira中的某些字段可以包含多个值,例如fixversion
。默认情况下,
如果在
属性
块。但是,您可能只想提取特定值。
为此,请添加如下块:
$ docker run --rm -v /path/to/config:/config -v /path/to/output:/data optilude/jira-agile-metrics:batch-latest
9
提取器将选择为字段找到的第一个"已知值"。如果没有 已知值匹配时,单元格将为空。
组合多个查询
如果很难构造一组返回所有
必需的问题,可以将多个查询添加到查询
块中,如下所示:
$ jira-agile-metrics --server 5000
0
在本例中,将基于两个过滤器运行两个查询
124
(您可以使用任何有效的jql)。
在循环时间输出中,将按指定添加名为team
的新列
通过查询下的
属性
字段。对于
第一个查询,根据值
字段,值将是第1组
,对于
第二个查询返回的所有项,将是team 2
故障排除
如果excel抱怨一个
sylk
格式错误,请忽略它。单击确定。见 https://support.microsoft.com/en-us/kb/215591jira错误消息可以在控制台中作为html打印出来。错误是 在那里的某个地方,但可能很难看到。很可能,这是 身份验证失败(用户名/密码不正确或帐户被阻止), 或者
查询选项中的错误导致无效的jql。
如果没有得到预期的问题,请使用
-v
选项 查看发送给jira的jql。将此粘贴到jira问题筛选器搜索中 框("高级模式")查看jira如何评估它。在工作流之后,旧工作流状态仍然可以是问题历史记录的一部分 已被修改。使用
-v
选项了解 尚未映射。excel有时会为csv文件中的数据选择有趣的格式。把它们调成 任何有意义的。
如果您在mac上,并且您得到一个关于python未安装为 一个框架,尝试用 以下内容:
后端:agg
要在Mac上安装图表依赖项,可能需要安装
gfortran
compiler forscipy
。使用自制程序并安装gcc
brew.
输出设置参考
可以在配置的输出中设置以下选项:
部分
文件
一般选项
这些选项会影响多个图表和文件。
分位数:<;list>;
–计算百分位数时使用的分位数。backlog列:<;name>;
--backlog列的名称。默认为第一列。提交列:<;name>;
–考虑工作的列的名称 坚信的。默认为第二列。最后一列:<;name>;
–最后一个"work"列的名称。默认为 倒数第二列。完成列:<;name>;
–完成列的名称。默认为最后一列。
数据文件
这些选项命名要写入的数据文件。使用扩展名.csv
,.xlsx
,或
.json
根据所需的文件格式。可以指定为列表
或单个文件名。
循环时间数据:<;文件名>;[csv,xlsx,json]
–适合 处理可操作的敏捷。包含所有问题由 配置文件、元数据和周期中每个状态的输入日期。CFD数据:<;filename>;[csv,xlsx,json]
–计算数据以绘制累积 流程图和写入文件。提示:绘制为(非堆叠)面积图。散点图数据:<;filename>;[csv,xlsx,json]
–计算数据以绘制 循环时间散点图和写入文件。提示:绘制散点图。直方图数据:<;filename>;[csv,xlsx,json]
–计算数据以绘制循环 时间直方图和写入文件。提示:绘制为柱形图。吞吐量数据:<;filename>;[csv,xlsx,json]
–计算每日吞吐量 数据和写入文件。提示:绘制为柱形图。尊重吞吐量频率
设置(见下文)。百分位数据:<;filename>;[csv,xlsx,json]
–计算周期时间 百分比和写入文件。障碍数据:<;filename>;[csv,xlsx,json]
–输出障碍启动和 结束日期与门票对比。
散点图
散点图窗口:<;number>;
–要在散点图中显示的最近天数。 默认显示所有数据。散点图:<;filename>;.png
–绘制周期时间散点图。散点图标题:<;标题>;
–循环时间标题 散点图。
直方图
直方图窗口:要在直方图中显示的最近天数。 默认显示所有数据。
直方图:<;filename>;.png
–绘制周期时间直方图。直方图标题:<;标题>;
–循环时间标题 直方图。
累积流程图
CFD窗口:<;number>;
–要在CFD中显示的最近时段数。 默认显示所有期间。CFD图表:<;filename>;.png
–绘制累积流程图。CFD图表标题:<;title>;
–CFD标题。
吞吐量图表
吞吐量频率:<;freq>;
–用于计算频率的间隔, 例如,每日1d或每周1w。吞吐量窗口:<;number>;
–要在吞吐量图表中显示的最近时段数。 默认显示所有期间。吞吐量图表:<;filename>;.png
–根据趋势绘制每周吞吐量图表 线<<LI>吞吐量图表标题:<;title>;
–吞吐量图表标题。
燃耗图
燃耗窗口:<;number>;
–要在燃耗中显示的最近时段数。 默认显示所有期间。燃尽图:<;filename>;.png
–绘制简单的燃尽图。燃尽图标题<;标题>;
–燃尽图标题散点图。
燃耗预测图
燃耗预测窗口:<;number>;
–要显示在 燃耗预测图。默认显示所有期间。燃耗预测图:<;filename>;.png
–使用蒙特卡洛绘制燃耗图 模拟预测完成。燃耗预测图表标题:<;title>;
–燃耗预测图表标题。燃耗预测图表目标:<;number>;
–的目标完成范围 预测。默认为待办事项的当前大小。燃耗预测图表截止日期:<;日期>;
–完成的截止日期 积压。如果设置,它将显示在图表上,并且预测增量将 也会显示出来。使用ISO日期格式,例如2018-01-02
用于2018年1月2日。燃耗预测图表截止日期置信度:<;number>;
–要在何时使用的分位数 比较截止日期和预测。使用分数打开,例如0.85
燃耗预测图表试验:<;number>;
–monte中的迭代次数 卡罗模拟。燃耗预测图表吞吐量窗口:<;number>;
–在 过去用于计算吞吐量。燃耗预测图表吞吐量窗口结束:<;日期>;
–默认情况下, 吞吐量窗口运行到今天。使用此选项设置备选方案 窗口的结束日期。使用ISO日期格式,例如1月份的2018-01-02
2018年2月。
在制品图表
在制品频率:<;freq>;
–在制品图表的频率间隔。1w周一
意味着一周,从周一开始。WIP窗口:<;number>;
–要在WIP图表中显示的最近期间数。 默认显示所有期间。WIP图表:<;filename>;.png
–绘制每周WIP方框图。WIP图表标题:<;title>;
–WIP图表标题
老化在制品图表
老化在制品图表:<;filename>;.png
–绘制当前老化在制品图表。老化在制品图表标题:<;title>;
–老化在制品图表标题。
净流程图
净流量频率:<;freq>;
–净流量图的频率间隔。1w mon
表示从周一开始的一周。净流量窗口:<;number>;
–要在净流量中显示的最近时段数 图表。默认显示所有期间。网络流程图:<;filename>;.png
–绘制每周网络流程条形图。网络流程图标题:<;标题>;
–网络流程条形图标题。
障碍图
障碍物窗口:<;number>;
–显示的月数。障碍图表:<;filename>;.png
–绘制一个条形图,显示 每个月的活动障碍,按设置的障碍标志堆叠。障碍图表标题:<;title>;
–障碍图表标题。障碍天数图表:<;filename>;.png
–绘制总障碍天数的条形图 每月活动的所有障碍的天数,按 障碍物标志设置。障碍天数图表标题:<;title>;
–障碍天数标题 图表,障碍物状态图:<;filename>;.png
–绘制一个条形图,显示 每个月的活动障碍,按 提出障碍的时间。障碍物状态图表标题:<;title>;
–障碍物状态的标题 图表,障碍状态日图表:<;filename>;.png
–绘制 每月活动的所有障碍的总天数,堆叠 根据每一障碍物出现时的票务状态。障碍状态日图表标题:<;title>;
–障碍标题 状态日图表。
缺陷密度图
缺陷查询:<;query>;
–用于识别缺陷的jql查询。缺陷窗口:<;number>;
–显示的月数。缺陷优先级字段:字段名 缺陷优先级。
缺陷优先级值:<;list>;
–按顺序列出有效值, 对于缺陷优先级。缺陷类型字段:<;field name>;
–标识缺陷的字段名称 类型:缺陷类型值:<;list>;
–有效值列表,依次为 缺陷值。缺陷环境字段:字段名 发现缺陷的环境。
<代码>defecTS环境值:<;list>;–有效值列表,在 订购,针对缺陷环境。
按优先级排列的缺陷图表:<;filename>;.png
–绘制 按优先级随时间分组的缺陷。按优先级列出的缺陷图表标题:<;title>;
–按优先级列出的缺陷标题 图表,缺陷类型图表:<;filename>;.png
–绘制缺陷堆积条形图 按类型随时间分组。按类型列出的缺陷图表标题:<;title>;
–按类型列出的缺陷标题图表。按环境列出的缺陷图表:<;filename>;.png
–绘制 随时间推移按环境分组的缺陷。按环境列出的缺陷图表标题:<;title>;
–缺陷标题- 环境图。
债务密度图
债务查询:<;查询>;
–用于标识技术债务项的JQL查询。债务窗口:要在债务图表中显示的月数。默认值 显示有数据的所有月份。
债务优先级字段:<;field name>;
–标识技术债务的字段名称 项目优先级。债务优先级值:<;list>;
–有效值列表,依次为 技术债务项目优先级。债务图表:<;filename>;.png
–绘制技术债务堆积条形图 按优先级随时间分组。债务图表标题:<;title>;
–技术债务图表标题。债务期限图表:<;filename>;.png
–绘制技术债务的堆积条形图 按年龄按优先级分组。债务期限图表标题:<;title>;
–技术债务期限图表的标题。债务期限图表箱:<;list>;
–用于放置所示年龄的箱列表。 默认为30
,60
和90
,将年龄分组为0-30天,
31-60天
,61-90天
和91天或以上
废物图表
废物查询:<;query>;
–用于标识废物项目的jql查询,例如。 那些在工作开始后退出的人。废物频率:<;freq>;
–废物图表分组的频率。默认为 月份开始(ms
)。例如,使用2w-wed
按两周开始分组 星期三。废物窗口:<;number>;
–显示的月数。废物图表:<;filename>;.png
–绘制废物堆积条形图, 按上次未解决状态分组。废物图表标题:<;title>;
–废物图表标题。
进度报告
进度报告:<;filename>;.html
–将进度报告写入独立的 HTML文件。进度报告标题:<;title>;
–进度报告页的标题。进度报告史诗般的截止日期字段:<;field name>;
–日期字段的名称 给史诗的最后期限。进度报告epic团队字段:<;field name>;
–提供 负责史诗的团队名称。进度报告epic min stories字段:<;field name>;
–整数的名称 为史诗提供最少故事数的字段 预测目的。进度报告epic max stories字段:<;field name>;
–整数名称 为史诗提供最大预期故事数的字段 预测目的。进度报告epic查询模板:<;query>;
–用于标识epic的查询 为了一个结果。占位符将替换为给定的 结果键(如果设置)或名称。进度报告故事查询模板:<;query>;
–用于标识 史诗故事。占位符{epic}
将替换 给定的epic密钥(jira引用)。占位符{outcome}
和{team}
也可用于分别标识结果键/名称和团队名称。进度报告组:<;list>;
–带有键的记录列表名称
,在制品
,最小吞吐量
,最大吞吐量
,吞吐量示例
和/或吞吐量示例窗口 史诗。
名称
是必需的,您必须指定最小/最大吞吐量
(以每周故事为单位的数值)或吞吐量示例
,这是一个jql查询,用于标识给定 用于计算历史吞吐量的团队。如果吞吐量示例窗口
指定进入的周数 计算历史吞吐量时使用的过去(从今天开始)。 您可以使用吞吐量示例中的占位符
{team}
作为快捷方式 重复团队名称。WIP
默认为1。进度报告结果:<;list>;
–带有键名称的记录列表,
键
,和/或epic查询
,指定要在进度中列出的结果 报告。键
将默认为与名称
相同的值。epic查询
,如果 给定时,优先于进度报告epic查询模板 为这个结果寻找史诗。
更改日志
0.21
- 允许按团队和结果查看进度报告输出。
0.20
- 使用百分比的累积分布函数定义时 计算到达死亡线的几率(基本上:如果最后期限是 在预测最坏情况日期的同一周内,按100%而不是50%处理 可能)< /李>
0.19
- 使用新版本的pandas计算cfd图表修复崩溃
0.18
- 不显示已完成的Epics的预测
0.17
- 重新设置日志输出日期/时间和日志记录级别,以便于调试
0.16
- 尝试修复某些边缘情况下的吞吐量计算器崩溃问题
0.15
- 棕色包
0.14
- 强制最小/最大故事字段为整数,即使jira中的字符串字段也是如此
- 记录导致向后移动的状态更改
0.13
- 确保更改历史总是按日期顺序迭代,即使jira返回 它们不同。
0.12
- 在进度报告的打印css中保留背景色
- 允许在团队吞吐量示例查询中使用
{team}
占位符。
0.11
- 添加了进度报告计算器
- 修复了Web服务器的问题,如果包是 作为蛋安装(即不是从源安装)
0.10
- 可以选择指定多个输出文件(通过yaml列表)
对于
*数据:
文件名。这里的用例是输出csv/xlsx和 例如,json版本的cycletime
计算。 - 停止吞咽计算器中的异常(但在编写时继续这样做 输出文件)。调试问题太麻烦了。
0.9</H3>- 使默认障碍图表使用阻碍标志值作为细分,
并添加了具体的障碍状态图
0.8</H3>- 在命令l中添加了
--http proxy
和--https proxy
选项和
相应的http proxy
和https proxy
在connection
部分中。
0.7</H3>- 将吞吐量图表转换为折线图
0.6</H3>- 在调试时不要记录每个列表值分辨率
0.5</H3>- 添加了批处理模式Docker图像
0.4</H3>- 增加了障碍图表
0.3</H3>- 增加债务、缺陷和浪费图表。
- 向大多数图表添加了
窗口
选项。
0.2</H3>- 增加了输出目录选项。
0.1</H3>- 来源于jira敏捷度量
- 在命令l中添加了
--http proxy
和--https proxy
选项和 相应的http proxy
和https proxy
在connection
部分中。
0.7</H3>- 将吞吐量图表转换为折线图
0.6</H3>- 在调试时不要记录每个列表值分辨率
0.5</H3>- 添加了批处理模式Docker图像
0.4</H3>- 增加了障碍图表
0.3</H3>- 增加债务、缺陷和浪费图表。
- 向大多数图表添加了
窗口
选项。
0.2</H3>- 增加了输出目录选项。
0.1</H3>- 来源于jira敏捷度量
- 在调试时不要记录每个列表值分辨率
0.5</H3>- 添加了批处理模式Docker图像
0.4</H3>- 增加了障碍图表
0.3</H3>- 增加债务、缺陷和浪费图表。
- 向大多数图表添加了
窗口
选项。
0.2</H3>- 增加了输出目录选项。
0.1</H3>- 来源于jira敏捷度量
- 增加了障碍图表
0.3</H3>- 增加债务、缺陷和浪费图表。
- 向大多数图表添加了
窗口
选项。
0.2</H3>- 增加了输出目录选项。
0.1</H3>- 来源于jira敏捷度量
窗口
选项。- 增加了输出目录选项。