中文 集群监控

监控和维护 Axioma Stellaris 集群代理（Merlin、Ezekiel、Morgana）。触发词：'cluster status'、'Ezekiel'、'Morgana'、'agent health'、'check agents'、'tout soit up'。始终在回答关于代理状态或连接性问题前使用。

🔧 Axiomata Cluster Monitor — 集群监控技能

监控和维护 Axioma Stellaris 集群代理

信息	值
版本	1.0.0 — 2026-05-07
状态	运行中

---

1. 目的和范围

目标

监控 Axioma Stellaris 集群中所有代理的健康状态和连接性。

使用时机

触发器	行动
"集群状态"	检查所有代理
"Ezekiel"	检查 Ezekiel 状态
"Morgana"	检查 Morgana 状态
"agent health"	运行健康检查
"check agents"	列出所有代理状态
"tout soit up"	验证集群完全运行

---

2. 集群架构

┌─────────────────────────────────────────────┐
│       AXIOMA STELLARIS CLUSTER             │
├─────────────────────────────────────────────┤
│                                             │
│    🧙‍♂️ MERLIN (集群大脑)                    │
│    ├─ PKM API: localhost:8001             │
│    ├─ Qdrant: localhost:7334               │
│    └─ Gateway: localhost:18790             │
│                                             │
│    ⚒️ EZEKIEL (本地计算)                   │
│    ├─ PKM API: localhost:8003              │
│    ├─ Qdrant: localhost:6333               │
│    └─ SSH: localhost:18791                │
│                                             │
│    🧚 MORGANA (验证者)                      │
│    ├─ PKM API: localhost:8011              │
│    ├─ Qdrant: localhost:6336               │
│    └─ SSH: localhost:19790                │
│                                             │
└─────────────────────────────────────────────┘

---

3. 健康检查协议

必需检查

# 1. 检查 Merlin 本地服务
curl -s http://localhost:8001/health
curl -s http://localhost:7334/collections

# 2. 通过 SSH 隧道检查 Ezekiel
curl -s http://localhost:8003/health

# 3. 通过 SSH 隧道检查 Morgana
curl -s http://localhost:8011/health

# 4. 检查 Ollama（共享服务）
curl -s http://localhost:11434/api/tags

代理状态矩阵

代理	PKM API	Qdrant	Gateway	状态
Merlin	:8001	:7334	:18790	✅
Ezekiel	:8003	:6333	:18791	✅
Morgana	:8011	:6336	:19790	✅

---

4. 监控命令

检查所有代理

# 快速状态检查
for service in "8001:Merlin" "8003:Ezekiel" "8011:Morgana"; do
  port=${service%%:*}
  name=${service##*:}
  status=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:$port/health)
  echo "$name: $status"
done

Qdrant 集合检查

# Merlin Qdrant
curl -s http://localhost:7334/collections | python3 -c "import sys,json; d=json.load(sys.stdin)['result']; print(f'Collections: {len(d[\"collections\"])}')"

# Ezekiel Qdrant
curl -s http://localhost:6333/collections | python3 -c "import sys,json; d=json.load(sys.stdin)['result']; print(f'Collections: {len(d[\"collections\"])}')"

# Morgana Qdrant
curl -s http://localhost:6336/collections | python3 -c "import sys,json; d=json.load(sys.stdin)['result']; print(f'Collections: {len(d[\"collections\"])}')"

OpenClaw Gateway 检查

# 检查所有网关
curl -s http://localhost:18790/health
curl -s http://localhost:18791/health
curl -s http://localhost:19790/health

---

5. 错误处理

服务无响应

问题	原因	解决方案
PKM API 无响应	服务崩溃	重启服务
Qdrant 无响应	端口冲突	检查端口占用
SSH 隧道断开	SSH 连接丢失	重新建立隧道
Gateway 无响应	网关崩溃	重启网关

重启命令

# 重启 PKM API
sudo systemctl restart pkm-api

# 重启 Qdrant
sudo systemctl restart qdrant

# 重启 OpenClaw Gateway
openclaw gateway restart

---

6. 边缘情况

情况	处理方法
所有服务都关闭	首先重启 Qdrant，然后 PKM，最后 Gateway
SSH 隧道断开	使用 ssh -R 重新建立
端口被占用	使用 lsof 查找并终止进程
磁盘已满	清理日志，删除旧数据

---

7. 通知协议

如果检测到服务关闭：

1. 记录问题到 memory.md
2. 尝试重启服务
3. 如果重启失败，通知 Alexandre
4. 记录修复尝试

---

In Altum Per Monitor. 🔧 Axiomata Cluster Monitor v1.0