JZ_QGNB/DigitalHumanWeb/docs/self-hosting/advanced/observability/langfuse.zh-CN.mdx

---
title: LobeChat 的可观测性和追踪
description: 使用 Langfuse 为你的 LobeChat 应用增强开源可观测性和追踪功能。自动捕获每个请求的详细追踪和指标，以优化和调试你的对话。
tags:
  - 可观测性
  - 追踪
  - Langfuse
---

# 使用 Langfuse 监控你的 LobeChat 应用

## 什么是 Langfuse？

[Langfuse](https://langfuse.com/) 是一个 **开源的 LLM 可观测性平台**。启用 Langfuse 集成后，你可以追踪应用数据，以开发、监控和优化 LobeChat 的使用，包括：

- 应用 [追踪](https://langfuse.com/docs/tracing)
- 使用模式
- 按用户和模型的成本数据
- [评估](https://langfuse.com/docs/scores/overview)

## 快速开始

<Steps>
  ### 设置 Langfuse

  通过注册 [Langfuse Cloud](https://cloud.langfuse.com) 或 [自托管](https://langfuse.com/docs/deployment/self-host) Langfuse 来获取你的 Langfuse API 密钥。

  ### 设置 LobeChat

  有多种方式可以 [自托管 LobeChat](https://lobehub.com/docs/self-hosting/start)。在本示例中，我们将使用 Docker Desktop 部署。

  <Tabs items={["环境变量", "Docker Desktop 示例"]}>
    <Tab>
      在部署 LobeChat 之前，使用你在上一步创建的 Langfuse API 密钥设置以下四个环境变量。

      ```sh
      ENABLE_LANGFUSE = '1'
      LANGFUSE_SECRET_KEY = 'sk-lf...'
      LANGFUSE_PUBLIC_KEY = 'pk-lf...'
      LANGFUSE_HOST = 'https://cloud.langfuse.com'
      ```
    </Tab>

    <Tab>
      在运行 Docker 容器之前，在 Docker Desktop 中设置环境变量，并填入你在上一步创建的 Langfuse API 密钥。

      <Image alt={'Docker Desktop 中的环境变量'} src={'https://langfuse.com/images/docs/lobechat-docker-desktop-env.png'} />
    </Tab>
  </Tabs>

  ### 在设置中启用分析功能

  当 LobeChat 运行后，进入 **设置** 中的 **关于** 选项卡，并启用分析功能。这是将追踪数据发送到 Langfuse 所必需的。

  <Image alt={'LobeChat 设置'} src={'https://langfuse.com/images/docs/lobechat-settings.png'} />

  ### 在 Langfuse 中查看聊天追踪

  设置好 LLM 模型密钥后，你就可以开始与 LobeChat 进行交互。

  <Image alt={'LobeChat 对话'} src={'https://langfuse.com/images/docs/lobechat-converstation.png'} />

  所有对话都会被自动追踪并发送到 Langfuse。你可以在 Langfuse UI 的 [追踪部分](https://langfuse.com/docs/tracing) 查看这些数据。

  <Image alt={'LobeChat Trace 示例'} src={'https://langfuse.com/images/docs/lobechat-example-trace.png'} />
</Steps>

## 反馈

如果你有任何反馈或需求，请在 GitHub 上创建 [Issue](https://langfuse.com/issue)，或在 [Discord](https://discord.langfuse.com/) 上与 Langfuse 社区分享你的想法。