ActionsPulse

メインダッシュボードには、次の情報が表示されます。

• 🎯 ビジュアルゲージ付き DevOps 成熟度スコア
• 📈 DORA メトリクスの概要（デプロイ頻度、変更のリードタイム、変更失敗率、MTTR）
• ⚡ CI/CD パイプラインの健全性の概要
• 💰 コスト分析のハイライト
• 🔒 セキュリティとコンプライアンスの状況
• 詳細レポートへのクイックナビゲーション

DORA の主要な 4 つのメトリクスを追跡します。

• デプロイ頻度 — 本番環境にリリースする頻度
• 変更のリードタイム — コミットから本番環境に反映されるまでの時間
• 変更失敗率 — デプロイによって障害が発生する割合
• 平均復旧時間 — インシデントからどれだけ早く復旧できるか 各メトリクスには、トレンド分析と業界標準（エリート、高、中、低パフォーマンス）とのベンチマークが含まれます。

CI/CD パイプラインを詳しく分析できます：

• 🔄 ワークフローの成功率とトレンド
• ⏱️ P95/P99 レイテンシを含む平均実行時間
• 🚨 失敗分析と一般的なエラーパターン
• 📊 リポジトリ別、ワークフロー別の内訳
• 🏃 キュー時間とランナーの使用率

GitHub Actions の利用料金を把握し、最適化できます：

• 💵 ランナーの種類別の合計コスト（GitHub ホステッドとセルフホスト）
• 📊 リポジトリ、ワークフロー、OS 別のコスト内訳
• 🎯 コスト削減に向けた実行可能な推奨事項
• 📈 支出のトレンドと予測
• ⚡ 効率性メトリクス（ワークフローあたりのコスト、1 分あたりのコスト）

コンプライアンスとセキュリティを維持できます：

• ✅ コンプライアンスフレームワークの対応状況（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 ⭐

ワークフロー、ジョブ、リポジトリ、OS、ランナーごとの内訳を含む、GitHub Insights 風の詳細な使用状況メトリクスです。

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 ⭐

ワークフロー、ジョブ、リポジトリ、OS、ランナーごとの平均実行時間、キュー時間、失敗率を含む、GitHub Insights 風のパフォーマンスメトリクスです。

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'

コスト検出の強化：レポートでは、ランナーコストを正確に計算するために、次の 3 段階システムを使用します。

• 🎯 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

クローズまでの時間、ラベルの分布、バックログの健全性などの Issue メトリクスを取得します。

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

これにより、次の機能が有効になります。

• 組織をまたいだ請求の集計
• エンタープライズ全体でのランナープール
• 監査ログの統合

ローカルでビルドする

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..."