CI 监控器

监控、触发并分析 CI/CD 流水线状态。

适用场景

✅ 在以下情况下使用该能力：

• 检查构建/流水线状态
• 分析 CI 任务失败原因
• 触发构建或测试运行
• 监控部署进度
• “Jenkins 构建状态怎么样？” / “CI 挂了，看看什么原因”

❌ 请勿在以下情况下使用该能力：

• 编写/编辑 Jenkinsfile 或 CI 配置 → 请直接编辑文件
• 管理基础设施 → 请使用 DevOps 工具
• 代码审查 → 请使用平台 Web UI 或直接使用 gh CLI

Jenkins

配置

# 设置环境变量
export JENKINS_URL="https://jenkins.example.com"
export JENKINS_USER="admin"
export JENKINS_TOKEN="your-api-token"

常用操作

# 列出所有任务（job）
curl -s "$JENKINS_URL/api/json?tree=jobs[name,color]" 
  --user "$JENKINS_USER:$JENKINS_TOKEN" | jq '.jobs[] | "(.name): (.color)"'

# 获取最近一次构建的状态
curl -s "$JENKINS_URL/job/{job-name}/lastBuild/api/json" 
  --user "$JENKINS_USER:$JENKINS_TOKEN" | jq '{result,duration,timestamp,builtOn}'

# 获取最近一次构建的控制台输出（最后 50 行）
curl -s "$JENKINS_URL/job/{job-name}/lastBuild/consoleText" 
  --user "$JENKINS_USER:$JENKINS_TOKEN" | tail -50

# 触发一次构建
curl -s -X POST "$JENKINS_URL/job/{job-name}/build" 
  --user "$JENKINS_USER:$JENKINS_TOKEN"

# 带参数触发构建
curl -s -X POST "$JENKINS_URL/job/{job-name}/buildWithParameters?BRANCH=develop&ENV=staging" 
  --user "$JENKINS_USER:$JENKINS_TOKEN"

# 获取构建队列
curl -s "$JENKINS_URL/queue/api/json" 
  --user "$JENKINS_USER:$JENKINS_TOKEN" | jq '.items[] | {task: .task.name, why}'

失败分析

当构建失败时：

1. 获取构建结果与耗时：

curl -s "$JENKINS_URL/job/{job}/lastBuild/api/json" 
  --user "$JENKINS_USER:$JENKINS_TOKEN" | jq '{result,duration,timestamp}'

2. 获取失败测试报告：

curl -s "$JENKINS_URL/job/{job}/lastBuild/testReport/api/json" 
  --user "$JENKINS_USER:$JENKINS_TOKEN" | jq '{failCount,passCount,skipCount,suites[].cases[] | select(.status=="FAILED") | {name,errorDetails}}'

3. 获取控制台日志（最后 200 行）并筛选错误关键词：

curl -s "$JENKINS_URL/job/{job}/lastBuild/consoleText" 
  --user "$JENKINS_USER:$JENKINS_TOKEN" | tail -200 | grep -i -E "error|fail|exception"

4. 按如下格式汇总分析结果：

🔴 Build #{number} FAILED
⏱️ Duration: Xm Ys
📋 Tests: X passed, Y failed, Z skipped
❌ Failed tests:
  - TestClass.testMethod: error message
  - TestClass.testMethod2: error message
🔍 Root cause: [基于日志的分析]
💡 Suggestion: [修复建议]

GitHub Actions

使用 gh CLI 或 REST API：

# 列出最近的 workflow 运行记录
gh run list --repo owner/repo --limit 10

# 查看指定运行记录
gh run view {run-id} --repo owner/repo

# 查看失败步骤的日志
gh run view {run-id} --repo owner/repo --log-failed

# 重试失败的 job
gh run rerun {run-id} --failed --repo owner/repo

# 触发 workflow
gh workflow run {workflow-name} --repo owner/repo --ref main

GitLab CI

# 设置变量
export GITLAB_URL="https://gitlab.example.com"
export GITLAB_TOKEN="your-private-token"
export PROJECT_ID="123"

# 列出流水线（每页 5 条）
curl -s -H "PRIVATE-TOKEN: $GITLAB_TOKEN" 
  "$GITLAB_URL/api/v4/projects/$PROJECT_ID/pipelines?per_page=5" | jq '.[] | {id,status,ref,created_at}'

# 获取某条流水线的所有 job
curl -s -H "PRIVATE-TOKEN: $GITLAB_TOKEN" 
  "$GITLAB_URL/api/v4/projects/$PROJECT_ID/pipelines/{pipeline-id}/jobs" | jq '.[] | {name,status,duration}'

# 获取 job 的执行日志（最后 100 行）
curl -s -H "PRIVATE-TOKEN: $GITLAB_TOKEN" 
  "$GITLAB_URL/api/v4/projects/$PROJECT_ID/jobs/{job-id}/trace" | tail -100

# 重试失败的流水线
curl -s -X POST -H "PRIVATE-TOKEN: $GITLAB_TOKEN" 
  "$GITLAB_URL/api/v4/projects/$PROJECT_ID/pipelines/{pipeline-id}/retry"

构建状态摘要格式

汇报构建状态时，请使用以下格式：

📊 CI Status Report - {project}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ Build #123 (main)    - PASSED  2m 30s
🔴 Build #122 (develop) - FAILED  5m 10s
🟡 Build #124 (feature) - RUNNING 1m 20s
⚪ Build #125 (hotfix)  - QUEUED