docs: record resource status sync runbook

2026-06-12 14:47:00 +00:00
parent 9ab1acbe1d
commit 03aa0433b2
2 changed files with 20 additions and 0 deletions
@@ -34,6 +34,18 @@ bun scripts/cli.ts server status

 低内存时 `swap.warning` 非空，先执行 `server swap ensure`。

+## 节点资源指标同步
+
+资源面板显示旧 CPU/内存/磁盘值时，先对照 provider 上报、backend-core 落库和内部 API 三段：
+
+```bash
+docker logs --tail 120 unidesk-provider-gateway-main | rg 'system_status_sent|docker_status_sent|error'
+docker logs --tail 200 unidesk-backend-core | rg 'provider_system_status|provider_docker_status|provider_message_failed|serializing parameter'
+docker exec unidesk-backend-core sh -lc 'backend-core --fetch-json http://127.0.0.1:8080/api/nodes/system-status?limit=5'
+```
+
+provider 已发送但 backend-core 没有 `provider_system_status` / `provider_docker_status`，优先查 backend-core ingest/DB 写入错误；provider 自身停发时才用 `server restart provider-gateway` 做无构建维护重启。修复 backend-core 后必须用 `server rebuild backend-core` 上线并验证 `stale=false`、`currentCollectedAt` 为当前采样。长期语义见 `docs/reference/observability.md#node-resource-status`。
+
 ---

 ## Swap 管理