wind_power_cal/.claude/skills/edge-observability/SKILL.md

name, description

name	description
edge-observability	edge_collector 运行观测与资源诊断规范。用于排查边缘主机或云服务器 CPU 高、内存占用、磁盘空间、/tmp 清理、进程数量、jq/python/agent 异常、服务日志、端口监听和系统负载时，按只读证据链输出分析结论。

edge_collector 运行观测

适用场景

• CPU 占用高。
• 内存比其他主机高。
• /tmp 或工程目录占用大。
• jq、Python、agent 进程很多。
• 服务频繁重启。
• 网关在线状态异常。
• 前端或云端接口偶发失败。

排查顺序

1. 系统概况。
2. CPU 和进程。
3. 内存。
4. 磁盘。
5. systemd 服务。
6. 应用日志。
7. 网络端口。
8. 与对照主机比较。

常用命令

系统：

uptime
free -h
df -h
uname -a
date

CPU/进程：

ps -eo pid,ppid,user,stat,pcpu,pmem,rss,etime,cmd --sort=-pcpu | head -30
ps -eo pid,ppid,user,stat,pcpu,pmem,rss,etime,cmd --sort=-rss | head -30

进程树：

pstree -ap

磁盘：

du -h --max-depth=1 /home/cat 2>/dev/null | sort -h
du -h --max-depth=1 /tmp 2>/dev/null | sort -h

服务：

systemctl status edge --no-pager
journalctl -u edge --since "30 min ago" --no-pager
systemctl list-units --type=service --state=running

端口：

ss -lntp

分析规则

• 短时尖峰和持续高占用分开判断。
• 先找父进程，再判断是脚本循环、服务重启还是用户命令。
• 内存分析区分 RSS、缓存和可用内存。
• 磁盘清理只给建议，删除必须等用户确认。
• 与 119.45.4.75 或其他主机对比时，列出相同指标。

高风险操作

以下操作必须用户明确同意：

• 删除文件或目录。
• kill 进程。
• 重启服务。
• 清理日志。
• apt 安装诊断工具。

报告格式

结论：

证据：
- CPU:
- 内存:
- 磁盘:
- 进程:
- 日志:

判断：

建议：

当前项目常见根因

• shell + jq 高频轮询导致短时 CPU 尖峰。
• 未插 SIM/设备缺失导致 4G 脚本重复探测。
• 前端构建产物或代码仓库占用较大。
• /tmp 离线安装包、构建缓存未清理。
• 独立 agent 异常退出后被 systemd 频繁拉起。