service-health-check

サービスのヘルスチェック スキル

Port のカタログを使用して、あらゆるサービスの包括的な健全性の概要を取得します。

使用するタイミング

• サービスにデプロイする前
• オンコールローテーションの引き継ぎ中
• サービスの問題を調査するとき
• キャパシティや変更を計画するとき

ヘルスチェックのプロセス

ステップ 1：基本的なサービス情報

get_entity(blueprint="service", identifier="service-name", include=[
  "tier", "team", "owner", "on_call", 
  "depends_on", "repository", "scorecard_status"
])

ステップ 2：スコアカードのステータス

本番環境への対応状況を確認します：

get_entity(blueprint="service", identifier="service-name")
# Look at scorecard properties:
# - has_readme
# - has_runbook
# - has_monitoring
# - has_slo
# - security_scan_passed

ステップ 3：最近のインシデント

list_entities(blueprint="incident", query={
  primary_service: "service-name",
  created_at: ">30d"
})

重大度ごとに件数を数え、MTTR を算出します。

ステップ 4：最近のデプロイ

list_entities(blueprint="deployment", query={
  service: "service-name",
  deployed_at: ">7d"
})

ステップ 5：依存関係の健全性

依存関係ごとに：

get_entity(blueprint="service", identifier="dep-service")

依存関係の健全性ステータスを再帰的に確認します。

出力形式

# Service Health: [service-name]

## Overview
| Property | Value |
|----------|-------|
| Tier | Tier1-Critical |
| Team | payments-team |
| Owner | [email protected] |
| On-Call | [email protected] |

## 📊 Scorecard: 4/5 Passing
| Check | Status |
|-------|--------|
| Has README | ✅ |
| Has Runbook | ✅ |
| Has Monitoring | ✅ |
| Has SLO | ✅ |
| Security Scan | ❌ Last scan failed |

## 🚨 Incidents (Last 30 Days)
| Severity | Count | MTTR |
|----------|-------|------|
| Sev1 | 0 | - |
| Sev2 | 1 | 45min |
| Sev3 | 2 | 2h |

## 🚀 Recent Deployments
| Date | Version | Status |
|------|---------|--------|
| 2026-05-04 | v2.3.5 | ✅ Success |
| 2026-05-02 | v2.3.4 | ✅ Success |

## 🔗 Dependencies
| Service | Health | Tier |
|---------|--------|------|
| user-api | 🟢 Healthy | Tier1 |
| db-primary | 🟢 Healthy | Tier1 |
| cache-redis | 🟡 Degraded | Tier2 |

## Recommendations
1. Fix failing security scan
2. Monitor cache-redis degradation

品質チェックリスト

• スコアカードのデータをすべて取得した
• インシデントの指標を算出した
• すべての依存関係を確認した
• 実行可能な推奨事項を提示した