编辑“︁Jenkins构建统计”︁

{{DISPLAYTITLE:Jenkins构建统计}}  
{{Note|本文适用于Jenkins初学者及需要系统了解构建统计的开发者，涵盖基础概念、实现方法和实际案例。}}  

== 概述 ==  
'''Jenkins构建统计'''是通过收集、分析和可视化构建任务（Job）的历史数据，帮助团队评估系统健康度、识别性能瓶颈并优化CI/CD流程的技术实践。核心统计指标包括：  
* 构建成功率/失败率  
* 构建平均耗时  
* 构建触发频率  
* 测试通过率关联分析  

== 核心统计指标详解 ==  
=== 1. 构建成功率 ===  
计算公式：  
<math>\text{成功率} = \frac{\text{成功构建次数}}{\text{总构建次数}} \times 100\%</math>  

=== 2. 构建耗时分析 ===  
常用统计维度：  
* 最近10次构建的平均耗时  
* 历史峰值耗时  
* 阶段耗时占比（如代码编译、测试、部署）  

<mermaid>  
pie  
    title 构建阶段耗时占比  
    "代码编译" : 35  
    "单元测试" : 25  
    "集成测试" : 30  
    "部署" : 10  
</mermaid>  

== 统计实现方法 ==  
=== 通过Jenkins原生功能 ===  
1. 查看单个Job的统计：  
   - 访问 <code>Job名称 → Build History → Build Time Trend</code>  
   - 示例输出：  
     <syntaxhighlight lang="text">  
     Last 10 builds:  
     #42 - SUCCESS (Duration: 5m 12s)  
     #41 - FAILURE (Duration: 3m 45s)  
     ...  
     Average duration: 4m 28s  
     </syntaxhighlight>  

2. 使用Jenkins API获取原始数据：  
   <syntaxhighlight lang="bash">  
   # 获取最近5次构建状态  
   curl -s "http://jenkins-server/job/my-job/api/json?tree=builds[number,result,duration]{0,5}"  
   </syntaxhighlight>  

=== 通过插件扩展 ===  
推荐插件：  
* '''Build History Metrics Plugin'''：提供成功率/失败率仪表盘  
* '''Global Build Stats Plugin'''：跨项目聚合统计  

配置示例：  
<syntaxhighlight lang="xml">  
<!-- Global Build Stats配置片段 -->  
<buildStats>  
  <excludedJobs>temp-.*</excludedJobs>  
  <chartWidth>800</chartWidth>  
  <chartHeight>400</chartHeight>  
</buildStats>  
</syntaxhighlight>  

== 实际案例 ==  
=== 案例1：识别测试阶段瓶颈 ===  
某团队发现构建耗时从平均6分钟突增至15分钟，通过统计发现：  
* 集成测试阶段耗时增长300%  
* 根本原因：新增了未优化的端到端测试  

=== 案例2：资源调度优化 ===  
统计显示80%的构建集中在工作日10:00-12:00，导致资源争用。解决方案：  
* 配置构建触发器分散调度  
* 结果：平均构建等待时间从8分钟降至2分钟  

== 高级技巧 ==  
=== 自定义统计脚本 ===  
使用Groovy脚本提取构建数据：  
<syntaxhighlight lang="groovy">  
import jenkins.model.Jenkins  
def job = Jenkins.instance.getItem("my-job")  
def stats = job.builds.collect { build ->  
    [  
        number: build.number,  
        result: build.result?.toString() ?: "RUNNING",  
        duration: build.duration  
    ]  
}  
println "Top 5 longest builds:"  
stats.sort { -it.duration }.take(5).each { println it }  
</syntaxhighlight>  

=== 与监控系统集成 ===  
将Jenkins统计数据推送到Prometheus的配置示例：  
<syntaxhighlight lang="yaml">  
# prometheus-jenkins-exporter配置  
metrics:  
  - name: jenkins_build_duration_seconds  
    help: "Build duration in seconds"  
    type: gauge  
    labels:  
      - job_name  
      - result  
    path: '{.duration}'  
</syntaxhighlight>  

== 常见问题 ==  
{{Q&A  
|question = 如何统计跨多个Jenkins实例的数据？  
|answer = 使用Jenkins API聚合数据或采用中央监控系统（如ELK Stack）  
}}  

{{Q&A  
|question = 构建统计会影响Jenkins性能吗？  
|answer = 大规模历史数据查询可能增加负载，建议：  
* 定期清理旧构建  
* 对超过1万次构建的Job使用抽样统计  
}}  

== 最佳实践 ==  
1. '''基线建立'''：记录正常状态下的统计指标作为基准  
2. '''告警阈值'''：当成功率连续3次低于85%时触发告警  
3. '''定期复盘'''：每周分析构建趋势，识别潜在问题  

{{Tip|结合构建统计与版本控制系统（如Git）的提交信息，可进一步分析代码变更与构建稳定性的关联。}}

[[Category:集成部署]]
[[Category:Jenkins]]
[[Category:Jenkins监控与维护]]