Ubuntu Jenkins如何生成报告与日志

Ubuntu Jenkins生成报告与日志的实践指南

一、Jenkins报告生成方法

1. 测试报告（JUnit/Allure）

JUnit报告（基础测试报告）：适用于JUnit、TestNG等框架的测试结果展示。需在Pipeline中添加junit步骤，指定测试报告路径（如**/test-reports/*.xml）。示例：
```
stage('Publish Test Report') {
    steps {
        junit '**/test-reports/*.xml'  // 归档并展示测试结果
    }
}
```
构建完成后，可在Job页面的“Test Result” tab查看通过率、失败用例等统计信息。

Allure报告（高级可视化报告）：提供更丰富的测试分析功能（如趋势图、分类统计、缺陷关联）。需先安装Allure Commandline和Allure Jenkins Plugin，然后在Pipeline中配置：

pipeline {
    agent any
    stages {
        stage('Test') {
            steps {
                sh 'pytest --alluredir=./allure-results test_suite/'  // 生成Allure原始数据
            }
        }
        stage('Generate Allure Report') {
            steps {
                allure includeProperties: false, results: [[path: './allure-results']]  // 生成HTML报告
            }
        }
    }
    post {
        always {
            archiveArtifacts artifacts: 'allure-results/**', fingerprint: true  // 归档原始数据（可选）
        }
    }
}

构建完成后，点击“Allure Report” tab即可查看交互式报告（支持用例分类、历史趋势对比）。

2. HTML报告（自定义结果展示）

适用于自定义HTML格式的报告（如Selenium UI测试截图、性能测试结果）。需安装HTML Publisher Plugin，然后在Pipeline中添加publishHTML步骤：

stage('Publish HTML Report') {
    steps {
        publishHTML(target: [
            allowMissing: false,          // 不允许缺失报告
            alwaysLinkToLastBuild: true,  // 始终链接到最新构建
            keepAll: true,                // 保留所有构建的报告
            reportDir: 'test-reports',    // 报告目录（工作空间相对路径）
            reportFiles: 'index.html',    // 报告文件名
            reportName: 'UI Test Report'  // 报告显示名称
        ])
    }
}

构建完成后，在Job页面的“HTML Report” tab查看自定义报告。

二、Jenkins日志管理方法

1. 构建日志（详细执行过程）

Web界面查看：进入Job页面，点击“Build History”中的特定构建编号，再点击“Console Output”即可查看实时构建日志（包括命令输出、错误堆栈）。

命令行查看：通过tail命令实时查看最新日志，或grep搜索特定关键字（如“ERROR”）：

tail -f /var/log/jenkins/jenkins.log  # 实时查看Jenkins主日志
grep "ERROR" /var/log/jenkins/jenkins.log  # 搜索错误日志

2. 系统日志（Jenkins主程序运行信息）

日志文件位置：Ubuntu下Jenkins主日志默认存储在/var/log/jenkins/jenkins.log。

日志轮转配置：使用logrotate工具防止日志无限增长，创建/etc/logrotate.d/jenkins文件，添加以下配置：

/var/log/jenkins/*.log {
    daily                   # 每天轮转
    rotate 7                # 保留7天
    compress                # 压缩旧日志
    missingok               # 文件缺失时不报错
    notifempty              # 空文件不轮转
    create 0644 root adm    # 创建新日志文件权限
    sharedscripts           # 所有日志轮转完成后执行脚本
    postrotate
        if [ -f /var/run/jenkins/jenkins.pid ]; then
            kill -HUP $(cat /var/run/jenkins/jenkins.pid)  # 重新加载日志配置
        fi
    endscript
}

3. 日志分析与优化

内置工具：通过Jenkins Web界面的“Manage Jenkins -> System Log”查看系统级日志（如插件安装、系统错误）。
第三方工具：集成ELK Stack（Elasticsearch+Logstash+Kibana）或Splunk，实现日志的集中存储、可视化分析和告警（如异常日志实时推送）。
最佳实践：
- 调整Jenkins日志级别（在“Manage Jenkins -> System Log”中设置），避免过多无关日志；
- 使用Cron作业定期清理旧日志（如每天删除7天前的.log文件）：
```
0 0 * * * find /var/log/jenkins/ -type f -name "*.log" -mtime 7 -exec rm -f {} \;
```