pikasTech-unidesk/docs/reference/observability.md

UniDesk Observability Reference

UniDesk 的可观测性优先级高于静默成功。CLI、服务日志、Docker 日志和数据库状态都必须能通过短命令查询。

CLI Logs

异步 job 的 stdout 和 stderr 位于 .state/jobs/。job status 会返回有限尾部，避免输出爆炸，同时保留完整日志文件路径便于继续排查。

Service Logs

服务日志位于 logs/{YYYYMMDD}/，每次 server start 都生成新的本地时间戳前缀。backend-core、frontend 和 provider-gateway 输出 JSONL 文件；database 通过 PostgreSQL logging collector 写入同一目录。

Log Access

bun scripts/cli.ts server logs 同时读取文件日志和 Docker logs 尾部。文件日志是服务崩溃时的第一现场，Docker logs 是容器启动失败和 stdout/stderr 的辅助来源。