# Health Check

> >

- **Type:** Skill
- **Install:** `agentstack add skill-aws-samples-sample-aws-ops-skills-for-agents-health-check`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [aws-samples](https://agentstack.voostack.com/s/aws-samples)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT-0
- **Upstream author:** [aws-samples](https://github.com/aws-samples)
- **Source:** https://github.com/aws-samples/sample-aws-ops-skills-for-agents/tree/main/health-check

## Install

```sh
agentstack add skill-aws-samples-sample-aws-ops-skills-for-agents-health-check
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Health Check — 主动健康巡检

直接查 CloudWatch 指标判断服务健康，不依赖告警配置。

## 和其他 skills 的关系

- **env-discovery**: "有什么资源" → **health-check**: "资源健不健康"
- **health-check** 发现异常 → **log-diagnosis** 下钻日志 → **aws-troubleshooting** 深度排查
- **health-check** 发现告警 → **incident-triage** 分诊

## 工作流程

### Step 0 — 确认范围

MUST:
- 确认巡检范围：全局 vs 单服务
- 确认 region（默认 ap-northeast-1）
- 确认时间窗口（默认最近 1 小时）

### Step 1 — 执行健康检查

MUST:
- 运行 `scripts/check-health.sh  ` 获取健康摘要
- 如果单服务，加 `--service ` 过滤
- 脚本自动发现 EKS / RDS / ALB 资源并查指标

SHOULD:
- 如果脚本返回 UNKNOWN（无指标数据），提示用户可能未开启 Container Insights 或相关监控

### Step 2 — 分析指标

MUST:
- 读 `references/health-metrics.md` 了解各指标含义和阈值
- 判断每个服务的健康等级：HEALTHY / DEGRADED / CRITICAL / UNKNOWN
- 如果有 SLO 定义，对比实际值 vs 目标。**优先读 `references/slo-targets.local.yaml`**（你环境的真实目标，已 gitignore），不存在时回退到示例 `references/slo-targets.yaml`

SHOULD:
- 关注趋势——指标在恶化还是稳定
- 检查多个指标的关联（如 CPU 高 + 内存低 可能是内存泄漏导致 GC 频繁）

### Step 3 — 输出报告

MUST:
- 用 `assets/health-report-template.md` 格式输出
- 包含：总体状态、每服务健康状态、异常详情、告警状态、SLO 达标情况
- 突出 CRITICAL 和 DEGRADED 的服务

### Step 4 — 联动建议

SHOULD:
- DEGRADED/CRITICAL → 建议使用 log-diagnosis 查日志
- 有告警触发 → 建议使用 incident-triage 分诊
- 需要深度排查 → 路由到 aws-troubleshooting（实时查 aws-knowledge MCP / SSM Automation）
- 无数据（UNKNOWN）→ 建议开启监控（Container Insights、RDS Enhanced Monitoring 等）

## 查询参考

- 各服务健康指标和阈值：`references/health-metrics.md`
- SLO 目标定义：`references/slo-targets.local.yaml`（真实，gitignore）优先，否则 `references/slo-targets.yaml`（示例模板）

## Automation Boundary

### auto-safe
- `aws cloudwatch get-metric-data` / `get-metric-statistics`
- `aws cloudwatch describe-alarms`
- `aws eks list-clusters` / `describe-cluster`
- `aws rds describe-db-instances` / `describe-db-clusters`
- `aws elbv2 describe-load-balancers` / `describe-target-health`
- 运行 `scripts/check-health.sh`
- 生成健康报告

### human-required
- 无（纯只读 skill）

## Gotchas
- Container Insights 不是默认开启的——如果 EKS 指标全部 UNKNOWN，不是集群有问题，是没开监控
- RDS FreeableMemory 在 Aurora 上的行为和标准 RDS 不同——Aurora 主动使用内存做缓存，低 FreeableMemory 不一定是问题
- CloudWatch 指标有 ~2 分钟延迟，最近几分钟的数据可能不完整
- ALB 的 p99 延迟需要开启 Extended Statistics，标准 statistics 只有 Average/Sum/Min/Max
- 没有告警配置（ap-northeast-1 当前 0 个告警）不代表环境健康——这就是为什么本 skill 直接查指标
- check-health.sh 使用 macOS 兼容的命令（sed 而非 grep -P）。如果在 Linux 上遇到 sed 行为差异，检查 GNU vs BSD sed

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [aws-samples](https://github.com/aws-samples)
- **Source:** [aws-samples/sample-aws-ops-skills-for-agents](https://github.com/aws-samples/sample-aws-ops-skills-for-agents)
- **License:** MIT-0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-aws-samples-sample-aws-ops-skills-for-agents-health-check
- Seller: https://agentstack.voostack.com/s/aws-samples
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.