Langflow 系列 | 第 24 篇：日志、监控与 Tracing

上一篇讲的是鉴权、授权与多租户边界。身份系统解决的是“谁可以访问什么资源”，而这一篇要进入另一个生产环境里同样关键的问题：

当一个 Flow 运行慢了、失败了、没有返回预期结果，或者用户说“刚才那次运行有问题”时，Langflow 到底把哪些信息记录了下来？这些信息在哪里？前端又是如何把这些运行证据组织成可排查的界面？

在 Langflow 里，“日志”不是一个单一概念。至少有六类数据容易被统称为日志：

1. 服务进程日志：后端 stdout、文件日志、结构化日志。
2. Log Retriever 日志：内存缓冲区里的服务日志，可通过/logs查询。
3. Session Logs：Playground 会话消息记录，本质是 Message 数据。
4. Vertex Builds：节点构建结果、参数、产物和错误堆栈。
5. Transactions：节点之间的输入输出、状态和错误记录。
6. Tracing：一次 Flow 运行中的 trace、span、LLM 调用、工具调用和 token 使用量。

如果把它们混在一起看，排障时很容易走错方向。本篇会按源码层级拆开这些信号，并说明它们如何共同支撑 Langflow 的运行可观测性。

1. 本篇关注的源码范围

这一篇主要围绕以下源码展开：