mcpField
S
service-health-check

service-health-check

github.com/revitalb-port云与 DevOps067 次安装10 周前更新
代码仓库

关于 service-health-check

service-health-check 是一项利用 Port 目录生成服务健康概览的技能，汇总服务信息、评分卡、事件、部署和依赖状态，适用于部署评估、值班交接与故障调查。

主要功能

  1. 01获取服务负责人及依赖信息
  2. 02检查生产就绪评分卡
  3. 03汇总近期事件并计算 MTTR
  4. 04查看近期部署记录
  5. 05递归检查依赖服务健康状况

适用场景

  1. 01部署前评估服务
  2. 02准备值班交接
  3. 03调查服务故障
  4. 04评估容量或计划变更

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/revitalb-port/skills-registry-demo --skill service-health-check

安装后在 Claude Code 中输入/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

质量检查清单

  • 获取所有记分卡数据
  • 计算事件指标
  • 检查所有依赖项
  • 提供可执行的建议

评论

支持 Markdown