cloud
117 lines
2.2 KiB
Markdown
117 lines
2.2 KiB
Markdown
---
|
|
name: edge-observability
|
|
description: edge_collector 运行观测与资源诊断规范。用于排查边缘主机或云服务器 CPU 高、内存占用、磁盘空间、/tmp 清理、进程数量、jq/python/agent 异常、服务日志、端口监听和系统负载时，按只读证据链输出分析结论。
|
|
---
|
|
|
|
# edge_collector 运行观测
|
|
|
|
## 适用场景
|
|
|
|
- CPU 占用高。
|
|
- 内存比其他主机高。
|
|
- `/tmp` 或工程目录占用大。
|
|
- `jq`、Python、agent 进程很多。
|
|
- 服务频繁重启。
|
|
- 网关在线状态异常。
|
|
- 前端或云端接口偶发失败。
|
|
|
|
## 排查顺序
|
|
|
|
1. 系统概况。
|
|
2. CPU 和进程。
|
|
3. 内存。
|
|
4. 磁盘。
|
|
5. systemd 服务。
|
|
6. 应用日志。
|
|
7. 网络端口。
|
|
8. 与对照主机比较。
|
|
|
|
## 常用命令
|
|
|
|
系统：
|
|
|
|
```bash
|
|
uptime
|
|
free -h
|
|
df -h
|
|
uname -a
|
|
date
|
|
```
|
|
|
|
CPU/进程：
|
|
|
|
```bash
|
|
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
|
|
```
|
|
|
|
进程树：
|
|
|
|
```bash
|
|
pstree -ap
|
|
```
|
|
|
|
磁盘：
|
|
|
|
```bash
|
|
du -h --max-depth=1 /home/cat 2>/dev/null | sort -h
|
|
du -h --max-depth=1 /tmp 2>/dev/null | sort -h
|
|
```
|
|
|
|
服务：
|
|
|
|
```bash
|
|
systemctl status edge --no-pager
|
|
journalctl -u edge --since "30 min ago" --no-pager
|
|
systemctl list-units --type=service --state=running
|
|
```
|
|
|
|
端口：
|
|
|
|
```bash
|
|
ss -lntp
|
|
```
|
|
|
|
## 分析规则
|
|
|
|
- 短时尖峰和持续高占用分开判断。
|
|
- 先找父进程，再判断是脚本循环、服务重启还是用户命令。
|
|
- 内存分析区分 RSS、缓存和可用内存。
|
|
- 磁盘清理只给建议，删除必须等用户确认。
|
|
- 与 119.45.4.75 或其他主机对比时，列出相同指标。
|
|
|
|
## 高风险操作
|
|
|
|
以下操作必须用户明确同意：
|
|
|
|
- 删除文件或目录。
|
|
- kill 进程。
|
|
- 重启服务。
|
|
- 清理日志。
|
|
- apt 安装诊断工具。
|
|
|
|
## 报告格式
|
|
|
|
```text
|
|
结论：
|
|
|
|
证据：
|
|
- CPU:
|
|
- 内存:
|
|
- 磁盘:
|
|
- 进程:
|
|
- 日志:
|
|
|
|
判断：
|
|
|
|
建议：
|
|
```
|
|
|
|
## 当前项目常见根因
|
|
|
|
- shell + `jq` 高频轮询导致短时 CPU 尖峰。
|
|
- 未插 SIM/设备缺失导致 4G 脚本重复探测。
|
|
- 前端构建产物或代码仓库占用较大。
|
|
- `/tmp` 离线安装包、构建缓存未清理。
|
|
- 独立 agent 异常退出后被 systemd 频繁拉起。
|