跳到主要内容

日志

本页面提供有关 Langflow 日志的信息，包括单个流程和 Langflow 应用程序本身的日志。

Langflow 使用 structlog 库进行日志记录。

默认日志文件名为 langflow.log。 Langflow 还会为流程生成日志文件。

日志文件以 JSON 格式存储，包含结构化元数据。

日志存储​

Langflow 日志存储在 LANGFLOW_CONFIG_DIR 环境变量指定的配置目录中。

默认配置目录位置取决于您的操作系统和安装方法：

  • macOS Desktop:/Users/<username>/Library/Logs/com.Langflow
  • Windows Desktop:C:\Users\<username>\AppData\Roaming\com.Langflow\cache
  • OSS macOS/Windows/Linux/WSL (uv pip install):
    • macOS: /Users/<username>/Library/Caches/langflow
    • Linux: /home/<username>/.cache/langflow
    • Windows: C:\Users\<username>\AppData\Local\langflow\langflow\Cache
  • OSS macOS/Windows/Linux/WSL (git clone): <path_to_clone>/src/backend/base/langflow/

要自定义日志存储，请参阅 配置日志选项。

配置日志存储选项​

使用 Langflow 环境变量 在您的 Langflow .env 文件中配置日志选项，然后使用 uv run langflow run --env-file .env 启动 Langflow。

以下环境变量可用于配置日志记录：

VariableFormatDefaultDescription
LANGFLOW_LOG_LEVELStringERROR设置日志级别，可选值为 DEBUG、ERROR、INFO、WARNING 和 CRITICAL。例如，LANGFLOW_LOG_LEVEL=DEBUG。
LANGFLOW_LOG_FILEStringNot set如果您想使用非默认位置，设置日志文件存储位置。例如，LANGFLOW_LOG_FILE=path/to/logfile.log。如果未设置此选项，日志将写入 stdout。
LANGFLOW_LOG_ENVStringdefault控制日志的格式和显示方式。container：Docker/结构化日志的 JSON 格式。container_csv：数据分析的 CSV 格式。default 或未设置：使用 RichHandler 的开发/阅读美观彩色格式。
LANGFLOW_LOG_ROTATIONString1 day控制日志文件轮换的时间，基于时间或文件大小。基于时间的轮换："1 day"、"12 hours"、"1 week"。基于大小的轮换："10 MB"、"1 GB"。禁用轮换："None"（日志文件将无限增长）。
LANGFLOW_LOG_RETRIEVER_BUFFER_SIZEInteger10000设置日志检索的缓冲区大小。仅在启用 LANGFLOW_ENABLE_LOG_RETRIEVAL 时使用。
LANGFLOW_LOG_FORMATStringNot set设置日志格式配置。
LANGFLOW_PRETTY_LOGSBooleanTrue启用带有颜色和丰富控制台输出的美观日志格式。

实时查看日志​

要监控 Langflow 日志的生成情况，您可以使用 tail -f 命令来跟踪日志文件：

  1. 切换到您的 Langflow 配置目录：


    _10
    cd /Users/**USERNAME**/Library/Caches/langflow

  2. 跟踪主日志文件：


    _10
    tail -f langflow.log

    如果您没有看到新的日志条目，请检查 Langflow 是否正在运行并生成日志。您还可以检查启动 Langflow 的终端，查看日志是否在那里显示。

流程和组件日志​

运行流程后，您可以检查每个组件和流程运行的日志。 例如，您可以检查由 输入和输出组件 摄入和生成的 Message 对象。

查看流程日志​

在可视化编辑器中，点击 日志 查看整个流程的日志：

Logs pane

然后，点击 inputs 和 outputs 列中的单元格来检查 Message 对象。 例如，以下 Message 数据可能是 聊天输入 组件的输出：


_12
"messages": [
_12
{
_12
"message": "What's the recommended way to install Docker on Mac M1?",
_12
"sender": "User",
_12
"sender_name": "User",
_12
"session_id": "Session Apr 21, 17:37:04",
_12
"stream_url": null,
_12
"component_id": "ChatInput-4WKag",
_12
"files": [],
_12
"type": "text"
_12
}
_12
],

对于输入/输出组件，原始输入可能不会结构化为 Message 对象。 例如，语言模型 组件可能会将原始文本响应传递给 聊天输出 组件，然后该组件将其转换为 Message 对象。

您可以在 Langflow 安装的日志存储位置找到流程的 .log 文件。 有关文件路径，请参阅 日志存储。

查看聊天记录​

在 Playground 中，您可以检查每个聊天会话的聊天历史。 有关更多信息，请参阅查看聊天历史。

查看单个组件的输出​

当调试流程输出的格式或内容问题时，检查每个组件的输出有助于确定数据丢失或格式错误的位置。

要查看最近运行期间单个组件产生的输出，请在可视化编辑器中点击该组件上的 Inspect output。

访问 Langflow Desktop 日志​

如果您遇到 Langflow Desktop 的问题，可能需要访问启动日志进行调试。 请按照您操作系统的步骤操作。

  1. 打开终端并运行：


    _10
    cd ~/Library/Logs/com.Langflow

  2. 要打开文件夹并查看日志文件，请运行命令：


    _10
    open .

  3. 找到 langflow.log 文件。

您可以使用日志文件自行调查问题，为 GitHub Issue 添加上下文，或将其发送给 support 以获取调试帮助。

日志文件仅在 Langflow Desktop 运行时创建。如果您看不到日志文件，请先尝试启动 Langflow Desktop，然后检查日志文件。

另请参阅​

Search