hmo/AgentsMeeting
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add HEALTH-PIPELINE + DASHBOARD, update DEPLOY/OPS/QUICKSTART/README — Linux 246 as production standard

Browse Source
This commit is contained in:
hmo
2026-07-19 10:09:42 +08:00
parent 94250e9dda
commit 0b345c2ca1
6 changed files with 438 additions and 73 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/OPS.md
+36 -25
View File
@@ -1,6 +1,6 @@
# AgentsMeeting — 运维手册
> 版本: v2.0 | 日期: 2026-06-12
> 版本: v2.1 | 日期: 2026-07-19
---
@@ -38,10 +38,16 @@ Dashboard (:5803, Linux)
│
├── Docker exec ejabberdctl → 在线 JID 列表（跨平台权威）
├── GET 192.168.1.16:5802/health → xmpp_bot XMPP 连接状态
├── GET 192.168.1.16:5801/health → wechat_agent hermes 连接状态
└── TCP connect 192.168.1.16:8787 → api_proxy 端口可达性
├── GET 192.168.1.16:5810/health → article_processor 文章抓取服务
└── crontab 定时管线
├── */5 agents_health_check.py → Tier1 快速检查
├── 0 8 agents_daily_health.py → Tier2 每日全面检查
├── */10 self_todo_executor.py → TODO 自修复
└── */5 auto_heal.py → systemd/docker 自动重启
```
> 详见 `docs/HEALTH-PIPELINE.md`
---
## systemd 服务（Linux）
@@ -49,38 +55,43 @@ Dashboard (:5803, Linux)
| 服务 | 命令 |
|------|------|
| agentsmeeting-dashboard | `systemctl status/restart agentsmeeting-dashboard` |
| hermes-gateway@main | `systemctl status hermes-gateway@main` |
| hermes-gateway@mohe | `systemctl status hermes-gateway@mohe` |
| hermes-gateway@zhiwei | `systemctl status hermes-gateway@zhiwei` |
| hermes-gateway@xiaoguo | `systemctl status hermes-gateway@xiaoguo` |
| xmpp-bot-mohe | `systemctl status xmpp-bot-mohe` |
| xmpp-bot-zhiwei | `systemctl status xmpp-bot-zhiwei` |
**Docker 服务**: `docker restart wxBotWebhook`（微信桥接）、`docker compose restart`（ejabberd）
---
## 健康端点
| 服务 | URL | 含义 |
|------|-----|------|
| xmpp_bot | `GET :5802/health` | `xmpp_connected` = XMPP 是否在线 |
| wechat_agent | `GET :5801/health` | `hermes_connected` = 到莫荷 gateway 是否通 |
| Dashboard | `GET :5803/api/health` | Dashboard 自身是否正常 |
| Dashboard | `GET :5803/api/ejabberd` | ejabberd 在线用户列表 |
| Dashboard | `GET :5803/api/platform` | 平台服务状态 |
---
| 端点 | 说明 |
|------|------|
| `GET :5803/api/health` | Dashboard 自身健康 |
| `GET :5803/api/services` | 所有注册服务实时状态 |
| `GET :5803/api/expected` | 期望状态矩阵（含 key/spec） |
| `GET :5803/api/monitor` | 聚合监控（tasks + Tier1 + Tier2） |
| `GET :5803/api/autoheal` | 最近自动修复记录 |
| `GET :5803/api/ejabberd` | ejabberd 在线用户列表 |
| `GET :5803/api/platform` | 平台服务状态 |
| `gateway/temp/last_health_check.json` | Tier1 报告文件 |
| `gateway/temp/last_daily_health.json` | Tier2 报告文件 |
## 日志位置
| 日志 | Windows 路径 | 用途 |
|------|-------------|------|
| xmpp_bot.log | `gateway\logs\` | bot 连接/消息/HTTP 桥 |
| bridge.log | `gateway\logs\` | LLM API 调用 |
| watchdog.log | `gateway\logs\` | 看门狗启停 |
| health_check.log | `gateway\logs\` | 5 分钟健康检查 |
| dashboard.log | `gateway\logs\` | Dashboard 运行日志 |
| mohe_inbox.log | `gateway\logs\` | 莫荷消息记录 |
| 日志 | 路径（Linux 246） | 用途 |
|------|-------------------|------|
| health_check.log | `gateway/logs/` | Tier1 健康检查 |
| daily_health.log | `gateway/logs/` | Tier2 每日检查 |
| auto_heal.log | `gateway/logs/` | 自动修复引擎 |
| todo_executor.log | `gateway/logs/` | TODO 自修复执行器 |
| dashboard | `sudo journalctl -u agentsmeeting-dashboard -f` | Dashboard 运行日志 |
Linux Dashboard 日志：`sudo journalctl -u agentsmeeting-dashboard -f`
**Windows 端日志**（192.168.1.16）:
| 日志 | 路径 | 用途 |
|------|------|------|
| xmpp_bot.log | `gateway\logs\` | bot 连接/消息 |
| watchdog.log | `gateway\logs\` | 看门狗启停 |
---