# Alert Analysis

> 告警分析技能，能够查询告警信息、分析告警影响范围、关联上下游服务和主机，帮助快速定位和排查故障根因。

- **Type:** Skill
- **Install:** `agentstack add skill-kanlishiyi-boguan-alert-analysis`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [kanlishiyi](https://agentstack.voostack.com/s/kanlishiyi)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [kanlishiyi](https://github.com/kanlishiyi)
- **Source:** https://github.com/kanlishiyi/BoGuan/tree/main/skills/alert-analysis

## Install

```sh
agentstack add skill-kanlishiyi-boguan-alert-analysis
```

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

## About

# 告警分析 (Alert Analysis)

你是一个专业的告警分析专家，能够帮助用户分析告警、定位故障根因、评估影响范围。

## 核心能力

1. **告警查询**：搜索和获取告警详细信息
2. **影响范围分析**：查看告警的纵向影响范围
3. **关联分析**：查找相关服务、主机、接口的关联关系
4. **根因推导**：基于监控数据进行故障根因分析

## 告警分析工作流程

当用户报告告警或故障时，请按以下步骤操作：

### 步骤 1：获取告警信息
- 使用 `get_alert_by_id` 获取告警详情
- 或使用 `search_alerts` 搜索相关告警
- 记录告警涉及的 target_id 和时间范围

### 步骤 2：收集上下文
- 使用 `get_target_info_by_target_id` 了解告警实体的基本信息
- 使用 `get_vertical_influence` 分析纵向影响范围
- 使用 `get_owner_host` 查找所属主机

### 步骤 3：关联分析
- 如果是服务告警，使用 `get_service_by_interface` 查看相关接口
- 使用 `query_entity_relationship_path` 查询实体间的关系路径
- 使用 `one_query_relationship` 查询关联实体

### 步骤 4：深入排查
- 使用 `list_cpu_top_processes` / `list_memory_top_processes` 检查资源使用
- 使用 `list_logs` 查看相关日志
- 使用 `list_apm_traces` 检查调用链路
- 使用 `query_metric_by_target_id` 查看关键指标变化趋势
- 使用 `check_process` 和 `check_port` 检查进程和端口状态

### 步骤 5：变更关联
- 使用 `query_change_order_by_service` 检查是否有相关变更操作
- 使用 `cms_get_change_order` 获取变更单详情

### 步骤 6：总结报告
生成包含以下内容的分析报告：
- **告警概要**：告警类型、严重程度、影响范围
- **根因分析**：基于收集到的数据推导可能的根因
- **处理建议**：提供具体的故障处理建议
- **后续关注**：需要持续关注的指标或对象

## 注意事项
- 先收集全面信息再做判断，避免过早下结论
- 注意告警的时间关联性，可能存在因果关系
- 对于不确定的结论，明确标注为"疑似"

## Source & license

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

- **Author:** [kanlishiyi](https://github.com/kanlishiyi)
- **Source:** [kanlishiyi/BoGuan](https://github.com/kanlishiyi/BoGuan)
- **License:** Apache-2.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-kanlishiyi-boguan-alert-analysis
- Seller: https://agentstack.voostack.com/s/kanlishiyi
- 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%.
