ActionsPulse

主仪表板提供：

• 🎯 带可视化仪表的 DevOps 成熟度评分
• 📈 DORA 指标摘要（部署频率、前置时间、变更失败率、MTTR）
• ⚡ CI/CD 流水线健康状况概览
• 💰 成本分析要点
• 🔒 安全与合规状态
• 快速导航至详细报告

跟踪四项关键 DORA 指标：

• 部署频率 — 发布到生产环境的频率
• 变更前置时间 — 从提交到部署至生产环境所需的时间
• 变更失败率 — 导致故障的部署所占百分比
• 平均恢复时间 — 从故障中恢复所需的时间 每项指标都包含趋势分析，并与行业标准（精英、高水平、中等、低水平表现者）进行基准比较。

深入了解 CI/CD 流水线：

• 🔄 工作流成功率和趋势
• ⏱️ 平均运行时间及 P95/P99 延迟
• 🚨 失败分析和常见错误模式
• 📊 按仓库和工作流细分的数据
• 🏃 排队时间和运行器利用率

了解并优化 GitHub Actions 支出：

• 💵 按运行器类型统计的总成本（GitHub 托管与自托管）
• 📊 按仓库、工作流和操作系统细分的成本
• 🎯 可执行的节省成本建议
• 📈 支出趋势和预测
• ⚡ 效率指标（每个工作流的成本、每分钟的成本）

确保合规与安全：

• ✅ 合规框架覆盖情况（SOC2、ISO27001、HIPAA、PCI-DSS）
• 🔍 密钥扫描状态和警报
• 🛡️ 代码扫描结果
• 📋 分支保护规则合规情况
• 🔐 GHAS（GitHub Advanced Security）功能采用情况

评估 DevOps 成熟度：

• 📊 综合成熟度评分及可视化仪表
• 🎯 各类别评分（CI/CD、测试、安全、监控等）
• 📈 按影响优先级排列的改进建议
• 🏆 与行业标准进行基准比较
• 📋 可执行的进阶路线图

添加到 VS Code 的 MCP 设置（~/.vscode/mcp.json 或工作区 .vscode/mcp.json）：

{
  "servers": {
    "actions-pulse": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "--env-file", "/path/to/.mcp.env",
        "-e", "GITHUB_ORG=your-org-name",
        "ghcr.io/tsviz/actions-pulse:latest"
      ],
      "type": "stdio"
    }
  }
}

{
  "servers": {
    "actions-pulse": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "GITHUB_TOKEN=ghp_your_token",
        "-e", "GITHUB_ORG=your-org-name",
        "ghcr.io/tsviz/actions-pulse:latest"
      ],
      "type": "stdio"
    }
  }
}

{
  "servers": {
    "actions-pulse": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "--env-file", "/path/to/.mcp.env",
        "-e", "GITHUB_ORG=your-org-name",
        "-e", "DEVOPS_CONFIG_PATH=/app/config",
        "-v", "/path/to/your/config:/app/config:ro",
        "ghcr.io/tsviz/actions-pulse:latest"
      ],
      "type": "stdio"
    }
  }
}

创建 repositories/inventory.yaml，以定义要监控的仓库：

apiVersion: actions-pulse/v1
kind: RepositoryInventory
metadata:
  name: my-inventory
  version: "1.0.0"
  description: "Repositories to monitor"

spec:
  discovery:
    enabled: false  # Only monitor explicit repos

  repositories:
    - name: my-app
      team: platform
      tier: tier-1
      compliance: [SOC2]
      tags: [java, production]

    - name: my-api
      team: backend
      tier: tier-2
      tags: [nodejs, staging]

get_actions_usage_metrics

分析 GitHub Actions 用量和账单数据（基础版）。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- timeframe: '24h' | '7d' | '30d'
- breakdown: 'repository' | 'workflow' | 'runner_type'

get_detailed_usage_metrics ⭐

GitHub Insights 风格的详细用量指标，按工作流、作业、仓库、OS 和运行器细分。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- timeframe: '7d' | '30d' | '90d'
- repo_filter: Comma-separated list of repositories (optional)

get_detailed_performance_metrics ⭐

GitHub Insights 风格的性能指标，包含按工作流/作业/仓库/OS/运行器统计的平均运行时间、排队时间和失败率。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- timeframe: '7d' | '30d' | '90d'
- repo_filter: Comma-separated list of repositories (optional)

get_actions_performance_metrics

获取包含 P95/P99 延迟的工作流性能分析（基础版）。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- repo_name: Specific repository (optional)
- workflow_id: Specific workflow (optional)
- timeframe: '1h' | '6h' | '24h' | '7d'

增强型成本检测：报告现在采用三级系统，以准确计算运行器成本：

• 🎯 API 检测——使用托管运行器 API 获取精确的机器规格
• 🏷️ 标签检测——与运行器目录进行模式匹配
• 📊 默认定价——基于 OS 的回退方案

详情请参阅 配置指南。

analyze_runner_utilization

分析运行器利用率和效率。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- runner_type: 'self-hosted' | 'github-hosted' | 'all'
- include_costs: Include cost analysis (default: true)

get_actions_cache_analytics

分析 Actions 缓存用量和效率。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- repo_name: Specific repository (optional)
- timeframe: '24h' | '7d' | '30d'

get_workflow_insights

获取工作流洞察并检测瓶颈。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- repo_name: Repository name (required)
- workflow_name: Workflow name or filename (required)
- analyze_dependencies: Analyze job dependencies (default: true)

get_team_productivity_metrics

根据 Actions 和提交数据分析团队效率。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- team_slug: Team slug (optional)
- include_individuals: Include individual metrics (default: false)
- timeframe: '7d' | '30d' | '90d'

get_compliance_audit_report

生成合规性和安全审计报告。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- compliance_framework: 'SOC2' | 'ISO27001' | 'HIPAA' | 'PCI-DSS' | 'CUSTOM'
- include_secrets_scan: Include secret scanning (default: true, requires GHAS)

get_dora_metrics

获取 DORA 指标（部署频率、前置时间、变更失败率、恢复时间）。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- timeframe: '7d' | '30d' | '90d'
- repo_filter: Comma-separated list of repositories (optional)

get_enhanced_dora_metrics

使用实际的 GitHub Deployments API 获取 DORA 指标，以实现最高准确性。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- timeframe: '7d' | '30d' | '90d'
- repo_filter: Comma-separated list of repositories (optional)

get_pull_request_metrics

获取拉取请求指标，包括前置时间、合并率和规模分布。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- timeframe: '7d' | '30d' | '90d'
- repo_name: Specific repository (optional)
- include_stale: Include stale PR analysis (optional)

get_issue_metrics

获取问题指标，包括关闭时间、标签分布和待处理工作健康状况。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- timeframe: '7d' | '30d' | '90d'
- repo_name: Specific repository (optional)
- label_filter: Filter by label (optional)

get_deployment_metrics

获取来自 GitHub Deployments API 的部署指标。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- timeframe: '7d' | '30d' | '90d'
- environment: Filter by environment (optional)
- repo_filter: Comma-separated list of repositories (optional)

get_environment_metrics

分析 GitHub 环境配置，包括保护规则。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- repo_filter: Comma-separated list of repositories (optional)

get_discussion_metrics

获取 GitHub Discussions 指标，包括回答率和互动情况。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- repo_name: Specific repository (optional)
- timeframe: '7d' | '30d' | '90d'

get_merge_queue_metrics

获取各个代码库中的合并队列使用情况和采用情况。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- repo_name: Specific repository (optional)

get_org_custom_properties

列出组织的所有自定义属性定义。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)

get_custom_properties_analytics

分析各个代码库中的自定义属性使用情况和覆盖率。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)

get_repos_by_property

按自定义属性值查找代码库。

Parameters:
- org_name: Organization name (optional if GITHUB_ORG is set)
- property_name: Custom property name (e.g., team, tier, compliance)
- property_value: Property value to filter by (optional)

如果你使用 GitHub Enterprise，可以通过添加以下内容启用增强功能：

GITHUB_ENTERPRISE_SLUG=your-enterprise-slug

这将启用：

• 跨组织账单汇总
• 企业范围的 Runner 池
• 汇总审计日志

本地构建

npm install
npm run build
docker build -t actions-pulse:local .

本地运行（不使用 Docker）

export GITHUB_TOKEN=ghp_your_token
export GITHUB_ORG=your-org
npm start

- name: Setup MCP config
  env:
    GITHUB_TOKEN: ${{ secrets.GH_PAT_DEVOPS }}
  run: |
    mkdir -p ~/.copilot
    printf '%s\n' '{
      "mcpServers": {
        "actions-pulse": {
          "command": "docker",
          "args": ["run", "-i", "--rm", "-e", "GITHUB_TOKEN='"$GITHUB_TOKEN"'", "-e", "GITHUB_ORG=your-org", "ghcr.io/tsviz/actions-pulse:latest"],
          "tools": ["*"]
        }
      }
    }' > ~/.copilot/mcp-config.json

- name: Generate DevOps Report
  env:
    GITHUB_TOKEN: ${{ secrets.GH_PAT_DEVOPS }}
    GH_TOKEN: ${{ secrets.GH_PAT_DEVOPS }}
  run: |
    copilot --yolo \
      --disable-builtin-mcps \
      --additional-mcp-config @$HOME/.copilot/mcp-config.json \
      --prompt "Use the actions-pulse MCP tools to generate a DevOps report..."