故障排查
按症状定位服务、入口、模型或数据层问题,修复后使用已知结果复验。
控制台打不开
- 在服务主机检查
systemctl status graphlake和journalctl -u graphlake -n 80 --no-pager。 - 用
/healthz查运行构建,使用/readyz查是否就绪。本机已就绪时,继续检查客户端路径上的 SSH 转发或反向代理。 - 使用 HTTPS 时,确认实际源地址与
--public-url一致,并保留Host和Origin请求头。
集群和业务入口的探测见监控与排障。
找不到模型或发布失败
- 没有发布版本。 打开模型,校验并发布草稿。客户端按自身角色发现已发布模型。
- 数据源或列错误。 从服务端浏览来源字段,检查进程环境变量名、文件路径和读取权限。
- 键重复或边端点错误。 对比映射两端的键类型、租户列和复合键顺序。可先运行小样例确认基础流程。
- 版本冲突。 重新读取当前草稿或生效版本,核对变更后再保存或查询。
查询为空、超时或结果不完整
- 结果为空。 核对生效版本、账户和租户过滤、时间范围及边方向。把查询缩小到一个已知键和一跳关系。
503 source_unavailable。 在运行配置的健康检查中查看来源结果,再从 GraphLake 主机核对连通性和读取凭据。- 超时或超过预算。 从选择性较好的键开始,限制跳数,仅返回用到的字段。先用
EXPLAIN检查计划,再决定是否增加预算。 - 预览截断。 按客户端能力继续加载图批次或导出结果。需要完整 Arrow 时,核对权限和结果快照状态。
- 来源已变更或邻域会话过期。 重跑原查询创建新结果,再展开节点。
三种语言的已知结果见查询示例。
本地表或 CSR 数据落后
检查最后一次成功加载及其水位,确认发布模型确实使用本地副本。源表物理删除和低于水位的迟到行,可能需要全量对账。CSR 代次过旧时,重新构建或查询合适的在线模型。