xiaokang commented on code in PR #3239:
URL: https://github.com/apache/doris-website/pull/3239#discussion_r2660695456
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/ecosystem/observability/langfuse.md:
##########
@@ -0,0 +1,599 @@
+---
+{
+ "title": "Langfuse on Doris",
+ "language": "zh-CN"
+}
+---
+
+# Langfuse on Doris
+
+## 关于 Langfuse
+
+Langfuse 是一个开源的 LLM 工程平台，专门为大语言模型应用提供全面的可观测性解决方案。它主要提供以下核心功能：
+
+- **链路追踪**：完整记录 LLM 应用的调用链路和执行流程
+- **性能评估**：提供多维度的模型性能评估和质量分析
+- **提示管理**：集中管理和版本控制提示词模板
+- **指标监控**：实时监控应用性能、成本和质量指标
+
+本文档将详细介绍如何部署基于 Apache Doris 作为分析后端的 Langfuse 解决方案，充分利用 Doris 强大的 OLAP
分析能力来处理大规模的 LLM 应用数据。
+
+
+## 系统架构
+
+Langfuse on Doris 解决方案采用微服务架构，包含以下核心组件：
+
+| 组件 | 端口 | 功能说明
|
+|-----------------|-----------|----------------------------------------------------------------------------------|
+| Langfuse Web | 3000 | Web 界面和 API 服务，提供用户交互和数据接入
|
+| Langfuse Worker | 3030 | 异步任务处理，负责数据处理和分析任务
|
+| PostgreSQL | 5432 | 事务性数据存储，保存用户配置和元数据
|
+| Redis | 6379 | 缓存层和消息队列，提升系统响应性能
|
+| MinIO | 9090 | 对象存储服务，存储原始事件和多模态附件
|
+| Doris Fe | 9030 8030 | Doris frontend， Doris
架构的一部分，主要负责接收用户请求、查询解析和规划、元数据管理以及节点管理 |
+| Doris Be | 8040 8050 | Doris Backends ，Doris
架构的一部分，主要负责数据存储和查询计划的执行。数据会被切分成数据分片（Shard），在 BE 中以多副本方式存储。 |
+
+::: note
+
+在部署 Apache Doris 时，可以根据硬件环境与业务需求选择存算一体架构或存算分离架构。
+在 Langfuse 部署中，生产环境不建议使用 Docker Doris，Docker 中带有的 Fe，Be 部分为了方便用户快速体验Langfuse
on Doris 的能力
+
+:::
+
+```mermaid
+flowchart TB
+ User["UI, API, SDKs"]
+ subgraph vpc["VPC"]
+ Web["Web Server<br/>(langfuse/langfuse)"]
+ Worker["Async Worker<br/>(langfuse/worker)"]
+ Postgres["Postgres - OLTP<br/>(Transactional Data)"]
+ Cache["Redis/Valkey<br/>(Cache, Queue)"]
+ Doris["Doris - OLAP<br/>(Observability Data)"]
+ S3["S3 / Blob Storage<br/>(Raw events, multi-modal attachments)"]
+ end
+ LLM["LLM API/Gateway<br/>(optional)"]
+
+ User --> Web
+ Web --> S3
+ Web --> Postgres
+ Web --> Cache
+ Web --> Doris
+ Web -.->|"optional for playground"| LLM
+
+ Cache --> Worker
+ Worker --> Doris
+ Worker --> Postgres
+ Worker --> S3
+ Worker -.->|"optional for evals"| LLM
+```
+
+## 部署要求
+
+### 软件环境
+
+| 组件 | 版本要求 | 说明 |
+|------|----------|------|
+| Docker | 20.0+ | 容器运行环境 |
+| Docker Compose | 2.0+ | 容器编排工具 |
+| Apache Doris | 2.1.10+ | 分析数据库，需独立部署 |
+
+### 硬件资源
+
+| 资源类型 | 最低要求 | 推荐配置 | 说明 |
+|----------|----------|----------|------|
+| 内存 | 8GB | 16GB+ | 支持多服务并发运行 |
+| 磁盘 | 50GB | 100GB+ | 存储容器数据和日志 |
+| 网络 | 1Gbps | 10Gbps | 确保数据传输性能 |
+
+### 前置条件
+
+1. **Doris 集群准备**
+ - 确保 Doris 集群正常运行且性能稳定
+ - 验证 FE HTTP 端口（默认 8030）和查询端口（默认 9030）网络可达
+ - Langfuse 启动后将自动在 Doris 中创建所需的数据库和表结构
+
+2. **网络连通性**
+ - 部署环境能够访问 Docker Hub 拉取镜像
+ - Langfuse 服务能够访问 Doris 集群的相关端口
+ - 客户端能够访问 Langfuse Web 服务端口
+
+:::tip 部署建议
+推荐使用 Docker 部署 Langfuse 服务组件（Web、Worker、Redis、PostgreSQL），但 Doris
建议独立部署以获得更好的性能和稳定性。详细的 Doris 部署指南请参考官方文档。
+:::
+
+## 配置参数
+
+Langfuse 服务需要配置多个环境变量来支持各个组件的正常运行：
+
+### 基础服务配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `DATABASE_URL` |
`postgresql://postgres:postgres@langfuse-postgres:5432/postgres` | PostgreSQL
数据库连接地址 |
+| `NEXTAUTH_SECRET` | `your-debug-secret-key-here-must-be-long-enough` |
NextAuth 认证密钥，用于会话加密 |
+| `SALT` | `your-super-secret-salt-with-at-least-32-characters-for-encryption`
| 数据加密盐值（至少32字符） |
+| `ENCRYPTION_KEY` |
`0000000000000000000000000000000000000000000000000000000000000000` |
数据加密密钥（64字符） |
+| `NEXTAUTH_URL` | `http://localhost:3000` | Langfuse Web 服务地址 |
+| `TZ` | `Asia/Shanghai` | 系统时区设置 |
+
+### Redis 缓存配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|------------------|------|
+| `REDIS_HOST` | `langfuse-redis` | Redis 服务主机地址 |
+| `REDIS_PORT` | `6379` | Redis 服务端口 |
+| `REDIS_AUTH` | `myredissecret` | Redis 认证密码 |
+| `REDIS_TLS_ENABLED` | `false` | 是否启用 TLS 加密 |
+| `REDIS_TLS_CA` | `-` | TLS CA 证书路径 |
+| `REDIS_TLS_CERT` | `-` | TLS 客户端证书路径 |
+| `REDIS_TLS_KEY` | `-` | TLS 私钥路径 |
+
+### 数据迁移配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `LANGFUSE_AUTO_CLICKHOUSE_MIGRATION_DISABLED` | `true` | 禁用 ClickHouse 自动迁移 |
+| `LANGFUSE_ENABLE_BACKGROUND_MIGRATIONS` | `false` | 禁用后台迁移（使用 Doris 时需要关闭） |
+| `LANGFUSE_AUTO_DORIS_MIGRATION_DISABLED` | `false` | 启用 Doris 自动迁移 |
+
+### Doris 分析后端配置
Review Comment:
Move it to the first config. If the default value for other configs is
enough, you can skip them in the document and just told users to see docker
config file.
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/ecosystem/observability/langfuse.md:
##########
@@ -0,0 +1,599 @@
+---
+{
+ "title": "Langfuse on Doris",
+ "language": "zh-CN"
+}
+---
+
+# Langfuse on Doris
+
+## 关于 Langfuse
+
+Langfuse 是一个开源的 LLM 工程平台，专门为大语言模型应用提供全面的可观测性解决方案。它主要提供以下核心功能：
+
+- **链路追踪**：完整记录 LLM 应用的调用链路和执行流程
+- **性能评估**：提供多维度的模型性能评估和质量分析
+- **提示管理**：集中管理和版本控制提示词模板
+- **指标监控**：实时监控应用性能、成本和质量指标
+
+本文档将详细介绍如何部署基于 Apache Doris 作为分析后端的 Langfuse 解决方案，充分利用 Doris 强大的 OLAP
分析能力来处理大规模的 LLM 应用数据。
+
+
+## 系统架构
+
+Langfuse on Doris 解决方案采用微服务架构，包含以下核心组件：
+
+| 组件 | 端口 | 功能说明
|
+|-----------------|-----------|----------------------------------------------------------------------------------|
+| Langfuse Web | 3000 | Web 界面和 API 服务，提供用户交互和数据接入
|
+| Langfuse Worker | 3030 | 异步任务处理，负责数据处理和分析任务
|
+| PostgreSQL | 5432 | 事务性数据存储，保存用户配置和元数据
|
+| Redis | 6379 | 缓存层和消息队列，提升系统响应性能
|
+| MinIO | 9090 | 对象存储服务，存储原始事件和多模态附件
|
+| Doris Fe | 9030 8030 | Doris frontend， Doris
架构的一部分，主要负责接收用户请求、查询解析和规划、元数据管理以及节点管理 |
+| Doris Be | 8040 8050 | Doris Backends ，Doris
架构的一部分，主要负责数据存储和查询计划的执行。数据会被切分成数据分片（Shard），在 BE 中以多副本方式存储。 |
+
+::: note
+
+在部署 Apache Doris 时，可以根据硬件环境与业务需求选择存算一体架构或存算分离架构。
+在 Langfuse 部署中，生产环境不建议使用 Docker Doris，Docker 中带有的 Fe，Be 部分为了方便用户快速体验Langfuse
on Doris 的能力
+
+:::
+
+```mermaid
+flowchart TB
+ User["UI, API, SDKs"]
+ subgraph vpc["VPC"]
+ Web["Web Server<br/>(langfuse/langfuse)"]
+ Worker["Async Worker<br/>(langfuse/worker)"]
+ Postgres["Postgres - OLTP<br/>(Transactional Data)"]
+ Cache["Redis/Valkey<br/>(Cache, Queue)"]
+ Doris["Doris - OLAP<br/>(Observability Data)"]
+ S3["S3 / Blob Storage<br/>(Raw events, multi-modal attachments)"]
+ end
+ LLM["LLM API/Gateway<br/>(optional)"]
+
+ User --> Web
+ Web --> S3
+ Web --> Postgres
+ Web --> Cache
+ Web --> Doris
+ Web -.->|"optional for playground"| LLM
+
+ Cache --> Worker
+ Worker --> Doris
+ Worker --> Postgres
+ Worker --> S3
+ Worker -.->|"optional for evals"| LLM
+```
+
+## 部署要求
+
+### 软件环境
+
+| 组件 | 版本要求 | 说明 |
+|------|----------|------|
+| Docker | 20.0+ | 容器运行环境 |
+| Docker Compose | 2.0+ | 容器编排工具 |
+| Apache Doris | 2.1.10+ | 分析数据库，需独立部署 |
+
+### 硬件资源
+
+| 资源类型 | 最低要求 | 推荐配置 | 说明 |
+|----------|----------|----------|------|
+| 内存 | 8GB | 16GB+ | 支持多服务并发运行 |
+| 磁盘 | 50GB | 100GB+ | 存储容器数据和日志 |
+| 网络 | 1Gbps | 10Gbps | 确保数据传输性能 |
+
+### 前置条件
+
+1. **Doris 集群准备**
+ - 确保 Doris 集群正常运行且性能稳定
+ - 验证 FE HTTP 端口（默认 8030）和查询端口（默认 9030）网络可达
+ - Langfuse 启动后将自动在 Doris 中创建所需的数据库和表结构
+
+2. **网络连通性**
+ - 部署环境能够访问 Docker Hub 拉取镜像
+ - Langfuse 服务能够访问 Doris 集群的相关端口
+ - 客户端能够访问 Langfuse Web 服务端口
+
+:::tip 部署建议
+推荐使用 Docker 部署 Langfuse 服务组件（Web、Worker、Redis、PostgreSQL），但 Doris
建议独立部署以获得更好的性能和稳定性。详细的 Doris 部署指南请参考官方文档。
+:::
+
+## 配置参数
+
+Langfuse 服务需要配置多个环境变量来支持各个组件的正常运行：
+
+### 基础服务配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `DATABASE_URL` |
`postgresql://postgres:postgres@langfuse-postgres:5432/postgres` | PostgreSQL
数据库连接地址 |
+| `NEXTAUTH_SECRET` | `your-debug-secret-key-here-must-be-long-enough` |
NextAuth 认证密钥，用于会话加密 |
+| `SALT` | `your-super-secret-salt-with-at-least-32-characters-for-encryption`
| 数据加密盐值（至少32字符） |
+| `ENCRYPTION_KEY` |
`0000000000000000000000000000000000000000000000000000000000000000` |
数据加密密钥（64字符） |
+| `NEXTAUTH_URL` | `http://localhost:3000` | Langfuse Web 服务地址 |
+| `TZ` | `Asia/Shanghai` | 系统时区设置 |
+
+### Redis 缓存配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|------------------|------|
+| `REDIS_HOST` | `langfuse-redis` | Redis 服务主机地址 |
+| `REDIS_PORT` | `6379` | Redis 服务端口 |
+| `REDIS_AUTH` | `myredissecret` | Redis 认证密码 |
+| `REDIS_TLS_ENABLED` | `false` | 是否启用 TLS 加密 |
+| `REDIS_TLS_CA` | `-` | TLS CA 证书路径 |
+| `REDIS_TLS_CERT` | `-` | TLS 客户端证书路径 |
+| `REDIS_TLS_KEY` | `-` | TLS 私钥路径 |
+
+### 数据迁移配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `LANGFUSE_AUTO_CLICKHOUSE_MIGRATION_DISABLED` | `true` | 禁用 ClickHouse 自动迁移 |
Review Comment:
Clickhouse related config should be avoid.
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/ecosystem/observability/langfuse.md:
##########
@@ -0,0 +1,599 @@
+---
+{
+ "title": "Langfuse on Doris",
+ "language": "zh-CN"
+}
+---
+
+# Langfuse on Doris
+
+## 关于 Langfuse
+
+Langfuse 是一个开源的 LLM 工程平台，专门为大语言模型应用提供全面的可观测性解决方案。它主要提供以下核心功能：
+
+- **链路追踪**：完整记录 LLM 应用的调用链路和执行流程
+- **性能评估**：提供多维度的模型性能评估和质量分析
+- **提示管理**：集中管理和版本控制提示词模板
+- **指标监控**：实时监控应用性能、成本和质量指标
+
+本文档将详细介绍如何部署基于 Apache Doris 作为分析后端的 Langfuse 解决方案，充分利用 Doris 强大的 OLAP
分析能力来处理大规模的 LLM 应用数据。
+
+
+## 系统架构
+
+Langfuse on Doris 解决方案采用微服务架构，包含以下核心组件：
+
+| 组件 | 端口 | 功能说明
|
+|-----------------|-----------|----------------------------------------------------------------------------------|
+| Langfuse Web | 3000 | Web 界面和 API 服务，提供用户交互和数据接入
|
+| Langfuse Worker | 3030 | 异步任务处理，负责数据处理和分析任务
|
+| PostgreSQL | 5432 | 事务性数据存储，保存用户配置和元数据
|
+| Redis | 6379 | 缓存层和消息队列，提升系统响应性能
|
+| MinIO | 9090 | 对象存储服务，存储原始事件和多模态附件
|
+| Doris Fe | 9030 8030 | Doris frontend， Doris
架构的一部分，主要负责接收用户请求、查询解析和规划、元数据管理以及节点管理 |
+| Doris Be | 8040 8050 | Doris Backends ，Doris
架构的一部分，主要负责数据存储和查询计划的执行。数据会被切分成数据分片（Shard），在 BE 中以多副本方式存储。 |
+
+::: note
+
+在部署 Apache Doris 时，可以根据硬件环境与业务需求选择存算一体架构或存算分离架构。
+在 Langfuse 部署中，生产环境不建议使用 Docker Doris，Docker 中带有的 Fe，Be 部分为了方便用户快速体验Langfuse
on Doris 的能力
+
+:::
+
+```mermaid
+flowchart TB
+ User["UI, API, SDKs"]
+ subgraph vpc["VPC"]
+ Web["Web Server<br/>(langfuse/langfuse)"]
+ Worker["Async Worker<br/>(langfuse/worker)"]
+ Postgres["Postgres - OLTP<br/>(Transactional Data)"]
+ Cache["Redis/Valkey<br/>(Cache, Queue)"]
+ Doris["Doris - OLAP<br/>(Observability Data)"]
+ S3["S3 / Blob Storage<br/>(Raw events, multi-modal attachments)"]
+ end
+ LLM["LLM API/Gateway<br/>(optional)"]
+
+ User --> Web
+ Web --> S3
+ Web --> Postgres
+ Web --> Cache
+ Web --> Doris
+ Web -.->|"optional for playground"| LLM
+
+ Cache --> Worker
+ Worker --> Doris
+ Worker --> Postgres
+ Worker --> S3
+ Worker -.->|"optional for evals"| LLM
+```
+
+## 部署要求
+
+### 软件环境
+
+| 组件 | 版本要求 | 说明 |
+|------|----------|------|
+| Docker | 20.0+ | 容器运行环境 |
+| Docker Compose | 2.0+ | 容器编排工具 |
+| Apache Doris | 2.1.10+ | 分析数据库，需独立部署 |
+
+### 硬件资源
+
+| 资源类型 | 最低要求 | 推荐配置 | 说明 |
+|----------|----------|----------|------|
+| 内存 | 8GB | 16GB+ | 支持多服务并发运行 |
+| 磁盘 | 50GB | 100GB+ | 存储容器数据和日志 |
+| 网络 | 1Gbps | 10Gbps | 确保数据传输性能 |
+
+### 前置条件
+
+1. **Doris 集群准备**
+ - 确保 Doris 集群正常运行且性能稳定
+ - 验证 FE HTTP 端口（默认 8030）和查询端口（默认 9030）网络可达
+ - Langfuse 启动后将自动在 Doris 中创建所需的数据库和表结构
+
+2. **网络连通性**
+ - 部署环境能够访问 Docker Hub 拉取镜像
+ - Langfuse 服务能够访问 Doris 集群的相关端口
+ - 客户端能够访问 Langfuse Web 服务端口
+
+:::tip 部署建议
+推荐使用 Docker 部署 Langfuse 服务组件（Web、Worker、Redis、PostgreSQL），但 Doris
建议独立部署以获得更好的性能和稳定性。详细的 Doris 部署指南请参考官方文档。
+:::
+
+## 配置参数
+
+Langfuse 服务需要配置多个环境变量来支持各个组件的正常运行：
+
+### 基础服务配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `DATABASE_URL` |
`postgresql://postgres:postgres@langfuse-postgres:5432/postgres` | PostgreSQL
数据库连接地址 |
+| `NEXTAUTH_SECRET` | `your-debug-secret-key-here-must-be-long-enough` |
NextAuth 认证密钥，用于会话加密 |
+| `SALT` | `your-super-secret-salt-with-at-least-32-characters-for-encryption`
| 数据加密盐值（至少32字符） |
+| `ENCRYPTION_KEY` |
`0000000000000000000000000000000000000000000000000000000000000000` |
数据加密密钥（64字符） |
+| `NEXTAUTH_URL` | `http://localhost:3000` | Langfuse Web 服务地址 |
+| `TZ` | `Asia/Shanghai` | 系统时区设置 |
Review Comment:
Avoid Asia timezone.
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/ecosystem/observability/langfuse.md:
##########
@@ -0,0 +1,599 @@
+---
+{
+ "title": "Langfuse on Doris",
+ "language": "zh-CN"
+}
+---
+
+# Langfuse on Doris
+
+## 关于 Langfuse
+
+Langfuse 是一个开源的 LLM 工程平台，专门为大语言模型应用提供全面的可观测性解决方案。它主要提供以下核心功能：
+
+- **链路追踪**：完整记录 LLM 应用的调用链路和执行流程
+- **性能评估**：提供多维度的模型性能评估和质量分析
+- **提示管理**：集中管理和版本控制提示词模板
+- **指标监控**：实时监控应用性能、成本和质量指标
+
+本文档将详细介绍如何部署基于 Apache Doris 作为分析后端的 Langfuse 解决方案，充分利用 Doris 强大的 OLAP
分析能力来处理大规模的 LLM 应用数据。
+
+
+## 系统架构
+
+Langfuse on Doris 解决方案采用微服务架构，包含以下核心组件：
+
+| 组件 | 端口 | 功能说明
|
+|-----------------|-----------|----------------------------------------------------------------------------------|
+| Langfuse Web | 3000 | Web 界面和 API 服务，提供用户交互和数据接入
|
+| Langfuse Worker | 3030 | 异步任务处理，负责数据处理和分析任务
|
+| PostgreSQL | 5432 | 事务性数据存储，保存用户配置和元数据
|
+| Redis | 6379 | 缓存层和消息队列，提升系统响应性能
|
+| MinIO | 9090 | 对象存储服务，存储原始事件和多模态附件
|
+| Doris Fe | 9030 8030 | Doris frontend， Doris
架构的一部分，主要负责接收用户请求、查询解析和规划、元数据管理以及节点管理 |
+| Doris Be | 8040 8050 | Doris Backends ，Doris
架构的一部分，主要负责数据存储和查询计划的执行。数据会被切分成数据分片（Shard），在 BE 中以多副本方式存储。 |
+
+::: note
+
+在部署 Apache Doris 时，可以根据硬件环境与业务需求选择存算一体架构或存算分离架构。
+在 Langfuse 部署中，生产环境不建议使用 Docker Doris，Docker 中带有的 Fe，Be 部分为了方便用户快速体验Langfuse
on Doris 的能力
+
+:::
+
+```mermaid
+flowchart TB
+ User["UI, API, SDKs"]
+ subgraph vpc["VPC"]
+ Web["Web Server<br/>(langfuse/langfuse)"]
+ Worker["Async Worker<br/>(langfuse/worker)"]
+ Postgres["Postgres - OLTP<br/>(Transactional Data)"]
+ Cache["Redis/Valkey<br/>(Cache, Queue)"]
+ Doris["Doris - OLAP<br/>(Observability Data)"]
+ S3["S3 / Blob Storage<br/>(Raw events, multi-modal attachments)"]
+ end
+ LLM["LLM API/Gateway<br/>(optional)"]
+
+ User --> Web
+ Web --> S3
+ Web --> Postgres
+ Web --> Cache
+ Web --> Doris
+ Web -.->|"optional for playground"| LLM
+
+ Cache --> Worker
+ Worker --> Doris
+ Worker --> Postgres
+ Worker --> S3
+ Worker -.->|"optional for evals"| LLM
+```
+
+## 部署要求
+
+### 软件环境
+
+| 组件 | 版本要求 | 说明 |
+|------|----------|------|
+| Docker | 20.0+ | 容器运行环境 |
+| Docker Compose | 2.0+ | 容器编排工具 |
+| Apache Doris | 2.1.10+ | 分析数据库，需独立部署 |
+
+### 硬件资源
+
+| 资源类型 | 最低要求 | 推荐配置 | 说明 |
+|----------|----------|----------|------|
+| 内存 | 8GB | 16GB+ | 支持多服务并发运行 |
+| 磁盘 | 50GB | 100GB+ | 存储容器数据和日志 |
+| 网络 | 1Gbps | 10Gbps | 确保数据传输性能 |
+
+### 前置条件
+
+1. **Doris 集群准备**
+ - 确保 Doris 集群正常运行且性能稳定
+ - 验证 FE HTTP 端口（默认 8030）和查询端口（默认 9030）网络可达
+ - Langfuse 启动后将自动在 Doris 中创建所需的数据库和表结构
+
+2. **网络连通性**
+ - 部署环境能够访问 Docker Hub 拉取镜像
+ - Langfuse 服务能够访问 Doris 集群的相关端口
+ - 客户端能够访问 Langfuse Web 服务端口
+
+:::tip 部署建议
+推荐使用 Docker 部署 Langfuse 服务组件（Web、Worker、Redis、PostgreSQL），但 Doris
建议独立部署以获得更好的性能和稳定性。详细的 Doris 部署指南请参考官方文档。
+:::
+
+## 配置参数
+
+Langfuse 服务需要配置多个环境变量来支持各个组件的正常运行：
+
+### 基础服务配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `DATABASE_URL` |
`postgresql://postgres:postgres@langfuse-postgres:5432/postgres` | PostgreSQL
数据库连接地址 |
+| `NEXTAUTH_SECRET` | `your-debug-secret-key-here-must-be-long-enough` |
NextAuth 认证密钥，用于会话加密 |
+| `SALT` | `your-super-secret-salt-with-at-least-32-characters-for-encryption`
| 数据加密盐值（至少32字符） |
+| `ENCRYPTION_KEY` |
`0000000000000000000000000000000000000000000000000000000000000000` |
数据加密密钥（64字符） |
+| `NEXTAUTH_URL` | `http://localhost:3000` | Langfuse Web 服务地址 |
+| `TZ` | `Asia/Shanghai` | 系统时区设置 |
+
+### Redis 缓存配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|------------------|------|
+| `REDIS_HOST` | `langfuse-redis` | Redis 服务主机地址 |
+| `REDIS_PORT` | `6379` | Redis 服务端口 |
+| `REDIS_AUTH` | `myredissecret` | Redis 认证密码 |
+| `REDIS_TLS_ENABLED` | `false` | 是否启用 TLS 加密 |
+| `REDIS_TLS_CA` | `-` | TLS CA 证书路径 |
+| `REDIS_TLS_CERT` | `-` | TLS 客户端证书路径 |
+| `REDIS_TLS_KEY` | `-` | TLS 私钥路径 |
+
+### 数据迁移配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `LANGFUSE_AUTO_CLICKHOUSE_MIGRATION_DISABLED` | `true` | 禁用 ClickHouse 自动迁移 |
+| `LANGFUSE_ENABLE_BACKGROUND_MIGRATIONS` | `false` | 禁用后台迁移（使用 Doris 时需要关闭） |
+| `LANGFUSE_AUTO_DORIS_MIGRATION_DISABLED` | `false` | 启用 Doris 自动迁移 |
+
+### Doris 分析后端配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `LANGFUSE_ANALYTICS_BACKEND` | `doris` | 指定使用 Doris 作为分析后端 |
+| `DORIS_FE_HTTP_URL` | `http://localhost:8030` | Doris FE HTTP 服务地址 |
+| `DORIS_FE_QUERY_PORT` | `9030` | Doris FE 查询端口 |
+| `DORIS_DB` | `langfuse` | Doris 数据库名称 |
+| `DORIS_USER` | `root` | Doris 用户名 |
+| `DORIS_PASSWORD` | `123456` | Doris 密码 |
+| `DORIS_MAX_OPEN_CONNECTIONS` | `100` | 最大数据库连接数 |
+| `DORIS_REQUEST_TIMEOUT_MS` | `300000` | 请求超时时间（毫秒） |
+
+## Docker Compose 部署
+
+### 启动前准备
+
+配置根据需求进行修改，这里我们提供一个可以直接启动的compose 示例
+
+启动此 compose 需要映射 fe_custom.conf 配置文件
+
+```shell
+## compose 文件与配置文件路径结构如下
+
+docker-langfuse-doris
+├── docker-compose.yml
+└── doris-config
+ └── fe_custom.conf
+```
+
+```shell
+## 创建目录结构
+mkdir doris-langfuse-doris
+mkdir doris-langfuse-doris/doris-config
+```
+### 创建 fe_custom.conf
+
+fe_custom.conf 文件内容如下
+
+```shell
+# Doris FE Custom Configuration
+# This file will be loaded by Doris FE on startup
+
+# Disable backend blacklist to prevent BE nodes from being marked as
unavailable
+# This is useful in development/test environments where BE might have
temporary connection issues
+disable_backend_black_list = true
+```
+
+### Compose 配置文件
+
+创建 `docker-compose.yaml` 文件，包含完整的 Langfuse 服务栈配置。以下配置已经过优化，可以直接使用：
+
+```yaml
+services:
+ langfuse-web:
+ image: selectdb/langfuse-web:latest
+ container_name: langfuse-web
+ hostname: langfuse-web
+ depends_on: &langfuse-depends-on
+ postgres:
+ condition: service_healthy
+ minio:
+ condition: service_healthy
+ redis:
+ condition: service_healthy
+ doris_fe:
+ condition: service_healthy
+ doris_be:
+ condition: service_healthy
+ ports:
+ - "3000:3000"
+ environment: &langfuse-web-env
+ DATABASE_URL:
postgresql://postgres:postgres@langfuse-postgres:5432/postgres
+ NEXTAUTH_SECRET:
${NEXTAUTH_SECRET:-your-debug-secret-key-here-must-be-long-enough}
+ SALT:
${SALT:-your-super-secret-salt-with-at-least-32-characters-for-encryption}
+ ENCRYPTION_KEY:
${ENCRYPTION_KEY:-0000000000000000000000000000000000000000000000000000000000000000}
+ NEXTAUTH_URL: ${NEXTAUTH_URL:-http://localhost:3000}
+ TELEMETRY_ENABLED: ${TELEMETRY_ENABLED:-false}
+ LANGFUSE_ENABLE_EXPERIMENTAL_FEATURES:
${LANGFUSE_ENABLE_EXPERIMENTAL_FEATURES:-false}
+ LANGFUSE_INIT_ORG_ID: ${LANGFUSE_INIT_ORG_ID:-}
+ LANGFUSE_INIT_ORG_NAME: ${LANGFUSE_INIT_ORG_NAME:-}
+ LANGFUSE_INIT_PROJECT_ID: ${LANGFUSE_INIT_PROJECT_ID:-}
+ LANGFUSE_INIT_PROJECT_NAME: ${LANGFUSE_INIT_PROJECT_NAME:-}
+ LANGFUSE_INIT_PROJECT_PUBLIC_KEY:
${LANGFUSE_INIT_PROJECT_PUBLIC_KEY:-}
+ LANGFUSE_INIT_PROJECT_SECRET_KEY:
${LANGFUSE_INIT_PROJECT_SECRET_KEY:-}
+ LANGFUSE_INIT_USER_EMAIL: ${LANGFUSE_INIT_USER_EMAIL:-}
+ LANGFUSE_INIT_USER_NAME: ${LANGFUSE_INIT_USER_NAME:-}
+ LANGFUSE_INIT_USER_PASSWORD: ${LANGFUSE_INIT_USER_PASSWORD:-}
+ CLICKHOUSE_MIGRATION_URL:
${CLICKHOUSE_MIGRATION_URL:-clickhouse://clickhouse:clickhouse@localhost:9000}
+ CLICKHOUSE_URL: ${CLICKHOUSE_URL:-http://localhost:8123}
+ CLICKHOUSE_USER: ${CLICKHOUSE_USER:-clickhouse}
+ CLICKHOUSE_PASSWORD: ${CLICKHOUSE_PASSWORD:-clickhouse}
+ CLICKHOUSE_CLUSTER_ENABLED: ${CLICKHOUSE_CLUSTER_ENABLED:-false}
+ LANGFUSE_S3_EVENT_UPLOAD_BUCKET:
${LANGFUSE_S3_EVENT_UPLOAD_BUCKET:-langfuse}
+ LANGFUSE_S3_EVENT_UPLOAD_REGION:
${LANGFUSE_S3_EVENT_UPLOAD_REGION:-us-east-1}
+ LANGFUSE_S3_EVENT_UPLOAD_ACCESS_KEY_ID:
${LANGFUSE_S3_EVENT_UPLOAD_ACCESS_KEY_ID:-minio}
+ LANGFUSE_S3_EVENT_UPLOAD_SECRET_ACCESS_KEY:
${LANGFUSE_S3_EVENT_UPLOAD_SECRET_ACCESS_KEY:-miniosecret}
+ LANGFUSE_S3_EVENT_UPLOAD_ENDPOINT: http://langfuse-minio:9000
+ LANGFUSE_S3_EVENT_UPLOAD_FORCE_PATH_STYLE:
${LANGFUSE_S3_EVENT_UPLOAD_FORCE_PATH_STYLE:-true}
+ LANGFUSE_S3_EVENT_UPLOAD_PREFIX:
${LANGFUSE_S3_EVENT_UPLOAD_PREFIX:-events/}
+ REDIS_HOST: langfuse-redis
+ REDIS_PORT: 6379
+ REDIS_AUTH: ${REDIS_AUTH:-myredissecret}
+ REDIS_TLS_ENABLED: ${REDIS_TLS_ENABLED:-false}
+ REDIS_TLS_CA: ${REDIS_TLS_CA:-}
+ REDIS_TLS_CERT: ${REDIS_TLS_CERT:-}
+ REDIS_TLS_KEY: ${REDIS_TLS_KEY:-}
+
+ # Time zone configuration
+ TZ: Asia/Shanghai
+
+
+ LANGFUSE_AUTO_CLICKHOUSE_MIGRATION_DISABLED: true
+
+
+ LANGFUSE_ENABLE_BACKGROUND_MIGRATIONS: false
+
+
+ LANGFUSE_AUTO_DORIS_MIGRATION_DISABLED: false
+
+ # Doris configuration
+ # Note: Doris is enabled automatically when
LANGFUSE_ANALYTICS_BACKEND="doris"
+ LANGFUSE_ANALYTICS_BACKEND: ${LANGFUSE_ANALYTICS_BACKEND:-doris}
+ DORIS_URL: ${DORIS_FE_HTTP_URL:-}
+ DORIS_FE_HTTP_URL: ${DORIS_FE_HTTP_URL:-http://172.30.0.2:8030}
+ DORIS_FE_QUERY_PORT: ${DORIS_FE_QUERY_PORT:-9030}
+ DORIS_DB: ${DORIS_DB:-langfuse}
+ DORIS_USER: ${DORIS_USER:-root}
+ DORIS_PASSWORD: ${DORIS_PASSWORD:-}
+ DORIS_MAX_OPEN_CONNECTIONS: ${DORIS_MAX_OPEN_CONNECTIONS:-100}
+ DORIS_REQUEST_TIMEOUT_MS: ${DORIS_REQUEST_TIMEOUT_MS:-30000}
+ HOSTNAME: "0.0.0.0"
+ PORT: "3000"
+ restart: always
+ healthcheck:
+ test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider",
"--timeout=10", "http://127.0.0.1:3000/api/public/health";]
+ interval: 30s
+ timeout: 10s
+ retries: 3
+ start_period: 30s
+ networks:
+ - default
+ - doris_internal
+
+ langfuse-worker:
+ image: selectdb/langfuse-worker:latest
+ container_name: langfuse-worker
+ hostname: langfuse-worker
+ depends_on: *langfuse-depends-on
+ ports:
+ - "3030:3030"
+ environment:
+ <<: *langfuse-web-env
+ restart: always
+ healthcheck:
+ test: ["CMD-SHELL", "ps aux | grep 'node worker/dist/index.js' | grep
-v grep || exit 1"]
+ interval: 30s
+ timeout: 10s
+ retries: 3
+ start_period: 30s
+ networks:
+ - default
+ - doris_internal
+
+ minio:
+ image: minio/minio
+ container_name: langfuse-minio
+ hostname: langfuse-minio
+ restart: always
+ entrypoint: sh
+ # create the 'langfuse' bucket before starting the service
+ command: -c 'mkdir -p /data/langfuse && minio server --address ":9000"
--console-address ":9001" /data'
+ environment:
+ MINIO_ROOT_USER: minio
+ MINIO_ROOT_PASSWORD: miniosecret # CHANGEME
+ ports:
+ - 19090:9000
+ - 127.0.0.1:19091:9001
+ volumes:
+ - langfuse_minio_data:/data
+ healthcheck:
+ test: ["CMD", "mc", "ready", "local"]
+ interval: 1s
+ timeout: 5s
+ retries: 5
+ start_period: 1s
+
+ redis:
+ image: redis:7
+ container_name: langfuse-redis
+ hostname: langfuse-redis
+ restart: always
+ # CHANGEME: row below to secure redis password
+ command: >
+ --requirepass ${REDIS_AUTH:-myredissecret}
+ ports:
+ - 127.0.0.1:16379:6379
+ healthcheck:
+ test: ["CMD", "redis-cli", "ping"]
+ interval: 3s
+ timeout: 10s
+ retries: 10
+
+ postgres:
+ image: postgres:${POSTGRES_VERSION:-latest}
+ container_name: langfuse-postgres
+ hostname: langfuse-postgres
+ restart: always
+ healthcheck:
+ test: ["CMD-SHELL", "pg_isready -U postgres"]
+ interval: 3s
+ timeout: 3s
+ retries: 10
+ environment:
+ POSTGRES_USER: postgres
+ POSTGRES_PASSWORD: postgres # CHANGEME
+ POSTGRES_DB: postgres
+ ports:
+ - 127.0.0.1:5432:5432
+ volumes:
+ - langfuse_postgres_data:/var/lib/postgresql
+
+ doris_fe:
+ image: apache/doris:fe-2.1.11
+ hostname: doris_fe
+ container_name: doris_fe
+ environment:
+ - FE_SERVERS=fe1:172.30.0.2:9010
+ - FE_ID=1
+ ports:
+ - "8030:8030"
+ - "9030:9030"
+ - "9010:9010"
+ networks:
+ doris_internal:
+ ipv4_address: 172.30.0.2
+ volumes:
+ # Persist FE metadata
+ - doris_fe_meta:/opt/apache-doris/fe/doris-meta
+ # Mount custom configuration
+ -
./doris-config/fe_custom.conf:/opt/apache-doris/fe/conf/fe_custom.conf:ro
+ healthcheck:
+ test: [ "CMD-SHELL", "mysql -h 127.0.0.1 -P 9030 -uroot -e 'SELECT 1'
2>/dev/null || exit 1" ]
+ interval: 10s
+ timeout: 5s
+ retries: 18
+ start_period: 120s
+
+ doris_be:
+ image: apache/doris:be-2.1.11
+ hostname: doris_be
+ container_name: doris_be
+ environment:
+ - FE_SERVERS=fe1:172.30.0.2:9010
+ - BE_ADDR=172.30.0.3:9050
+ depends_on:
+ doris_fe:
+ condition: service_healthy
+ ports:
+ - "8040:8040"
+ - "8060:8060"
+ - "9050:9050"
+ - "9060:9060"
+ networks:
+ doris_internal:
+ ipv4_address: 172.30.0.3
+ volumes:
+ # Persist BE data storage
+ - doris_be_storage:/opt/apache-doris/be/storage
+ # Optional: mount custom configuration
+ # - ./be_custom.conf:/opt/apache-doris/be/conf/be_custom.conf:ro
+ restart: unless-stopped
+ healthcheck:
+ test: [ "CMD-SHELL", "mysql -h 172.30.0.2 -P 9030 -uroot -e 'SHOW
BACKENDS\\G' | grep -A 20 'Host: 172.30.0.3' | grep -q 'Alive: true'" ]
+ interval: 10s
+ timeout: 5s
+ retries: 5
+ start_period: 150s
+
+volumes:
+ langfuse_postgres_data:
+ driver: local
+ langfuse_minio_data:
+ driver: local
+ doris_fe_meta:
+ driver: local
+ doris_be_storage:
+ driver: local
+
+networks:
+ default:
+ driver: bridge
+ ipam:
+ driver: default
+ config:
+ - subnet: 10.200.0.0/24
+ gateway: 10.200.0.1
+ doris_internal:
+ driver: bridge
+ ipam:
+ config:
+ - subnet: 172.30.0.0/24
+```
+
+
+### 部署步骤
+
+### 1 . 启动 compose
+
+```Bash
+docker compose up -d
+```
+
+```Bash
+# 检查
+$ docker compose up -d
Review Comment:
It's not necessary to list output of command in document.
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/ecosystem/observability/langfuse.md:
##########
@@ -0,0 +1,599 @@
+---
+{
+ "title": "Langfuse on Doris",
+ "language": "zh-CN"
+}
+---
+
+# Langfuse on Doris
+
+## 关于 Langfuse
+
+Langfuse 是一个开源的 LLM 工程平台，专门为大语言模型应用提供全面的可观测性解决方案。它主要提供以下核心功能：
+
+- **链路追踪**：完整记录 LLM 应用的调用链路和执行流程
+- **性能评估**：提供多维度的模型性能评估和质量分析
+- **提示管理**：集中管理和版本控制提示词模板
+- **指标监控**：实时监控应用性能、成本和质量指标
+
+本文档将详细介绍如何部署基于 Apache Doris 作为分析后端的 Langfuse 解决方案，充分利用 Doris 强大的 OLAP
分析能力来处理大规模的 LLM 应用数据。
+
+
+## 系统架构
+
+Langfuse on Doris 解决方案采用微服务架构，包含以下核心组件：
+
+| 组件 | 端口 | 功能说明
|
+|-----------------|-----------|----------------------------------------------------------------------------------|
+| Langfuse Web | 3000 | Web 界面和 API 服务，提供用户交互和数据接入
|
+| Langfuse Worker | 3030 | 异步任务处理，负责数据处理和分析任务
|
+| PostgreSQL | 5432 | 事务性数据存储，保存用户配置和元数据
|
+| Redis | 6379 | 缓存层和消息队列，提升系统响应性能
|
+| MinIO | 9090 | 对象存储服务，存储原始事件和多模态附件
|
+| Doris Fe | 9030 8030 | Doris frontend， Doris
架构的一部分，主要负责接收用户请求、查询解析和规划、元数据管理以及节点管理 |
+| Doris Be | 8040 8050 | Doris Backends ，Doris
架构的一部分，主要负责数据存储和查询计划的执行。数据会被切分成数据分片（Shard），在 BE 中以多副本方式存储。 |
+
+::: note
+
+在部署 Apache Doris 时，可以根据硬件环境与业务需求选择存算一体架构或存算分离架构。
+在 Langfuse 部署中，生产环境不建议使用 Docker Doris，Docker 中带有的 Fe，Be 部分为了方便用户快速体验Langfuse
on Doris 的能力
+
+:::
+
+```mermaid
+flowchart TB
+ User["UI, API, SDKs"]
+ subgraph vpc["VPC"]
+ Web["Web Server<br/>(langfuse/langfuse)"]
+ Worker["Async Worker<br/>(langfuse/worker)"]
+ Postgres["Postgres - OLTP<br/>(Transactional Data)"]
+ Cache["Redis/Valkey<br/>(Cache, Queue)"]
+ Doris["Doris - OLAP<br/>(Observability Data)"]
+ S3["S3 / Blob Storage<br/>(Raw events, multi-modal attachments)"]
+ end
+ LLM["LLM API/Gateway<br/>(optional)"]
+
+ User --> Web
+ Web --> S3
+ Web --> Postgres
+ Web --> Cache
+ Web --> Doris
+ Web -.->|"optional for playground"| LLM
+
+ Cache --> Worker
+ Worker --> Doris
+ Worker --> Postgres
+ Worker --> S3
+ Worker -.->|"optional for evals"| LLM
+```
+
+## 部署要求
+
+### 软件环境
+
+| 组件 | 版本要求 | 说明 |
+|------|----------|------|
+| Docker | 20.0+ | 容器运行环境 |
+| Docker Compose | 2.0+ | 容器编排工具 |
+| Apache Doris | 2.1.10+ | 分析数据库，需独立部署 |
+
+### 硬件资源
+
+| 资源类型 | 最低要求 | 推荐配置 | 说明 |
+|----------|----------|----------|------|
+| 内存 | 8GB | 16GB+ | 支持多服务并发运行 |
+| 磁盘 | 50GB | 100GB+ | 存储容器数据和日志 |
+| 网络 | 1Gbps | 10Gbps | 确保数据传输性能 |
+
+### 前置条件
+
+1. **Doris 集群准备**
+ - 确保 Doris 集群正常运行且性能稳定
+ - 验证 FE HTTP 端口（默认 8030）和查询端口（默认 9030）网络可达
+ - Langfuse 启动后将自动在 Doris 中创建所需的数据库和表结构
+
+2. **网络连通性**
+ - 部署环境能够访问 Docker Hub 拉取镜像
+ - Langfuse 服务能够访问 Doris 集群的相关端口
+ - 客户端能够访问 Langfuse Web 服务端口
+
+:::tip 部署建议
+推荐使用 Docker 部署 Langfuse 服务组件（Web、Worker、Redis、PostgreSQL），但 Doris
建议独立部署以获得更好的性能和稳定性。详细的 Doris 部署指南请参考官方文档。
+:::
+
+## 配置参数
+
+Langfuse 服务需要配置多个环境变量来支持各个组件的正常运行：
+
+### 基础服务配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `DATABASE_URL` |
`postgresql://postgres:postgres@langfuse-postgres:5432/postgres` | PostgreSQL
数据库连接地址 |
+| `NEXTAUTH_SECRET` | `your-debug-secret-key-here-must-be-long-enough` |
NextAuth 认证密钥，用于会话加密 |
+| `SALT` | `your-super-secret-salt-with-at-least-32-characters-for-encryption`
| 数据加密盐值（至少32字符） |
+| `ENCRYPTION_KEY` |
`0000000000000000000000000000000000000000000000000000000000000000` |
数据加密密钥（64字符） |
+| `NEXTAUTH_URL` | `http://localhost:3000` | Langfuse Web 服务地址 |
+| `TZ` | `Asia/Shanghai` | 系统时区设置 |
+
+### Redis 缓存配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|------------------|------|
+| `REDIS_HOST` | `langfuse-redis` | Redis 服务主机地址 |
+| `REDIS_PORT` | `6379` | Redis 服务端口 |
+| `REDIS_AUTH` | `myredissecret` | Redis 认证密码 |
+| `REDIS_TLS_ENABLED` | `false` | 是否启用 TLS 加密 |
+| `REDIS_TLS_CA` | `-` | TLS CA 证书路径 |
+| `REDIS_TLS_CERT` | `-` | TLS 客户端证书路径 |
+| `REDIS_TLS_KEY` | `-` | TLS 私钥路径 |
+
+### 数据迁移配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `LANGFUSE_AUTO_CLICKHOUSE_MIGRATION_DISABLED` | `true` | 禁用 ClickHouse 自动迁移 |
+| `LANGFUSE_ENABLE_BACKGROUND_MIGRATIONS` | `false` | 禁用后台迁移（使用 Doris 时需要关闭） |
+| `LANGFUSE_AUTO_DORIS_MIGRATION_DISABLED` | `false` | 启用 Doris 自动迁移 |
+
+### Doris 分析后端配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `LANGFUSE_ANALYTICS_BACKEND` | `doris` | 指定使用 Doris 作为分析后端 |
+| `DORIS_FE_HTTP_URL` | `http://localhost:8030` | Doris FE HTTP 服务地址 |
+| `DORIS_FE_QUERY_PORT` | `9030` | Doris FE 查询端口 |
+| `DORIS_DB` | `langfuse` | Doris 数据库名称 |
+| `DORIS_USER` | `root` | Doris 用户名 |
+| `DORIS_PASSWORD` | `123456` | Doris 密码 |
+| `DORIS_MAX_OPEN_CONNECTIONS` | `100` | 最大数据库连接数 |
+| `DORIS_REQUEST_TIMEOUT_MS` | `300000` | 请求超时时间（毫秒） |
+
+## Docker Compose 部署
+
+### 启动前准备
+
+配置根据需求进行修改，这里我们提供一个可以直接启动的compose 示例
+
+启动此 compose 需要映射 fe_custom.conf 配置文件
+
+```shell
+## compose 文件与配置文件路径结构如下
+
+docker-langfuse-doris
+├── docker-compose.yml
+└── doris-config
+ └── fe_custom.conf
+```
+
+```shell
+## 创建目录结构
+mkdir doris-langfuse-doris
+mkdir doris-langfuse-doris/doris-config
+```
+### 创建 fe_custom.conf
+
+fe_custom.conf 文件内容如下
+
+```shell
+# Doris FE Custom Configuration
+# This file will be loaded by Doris FE on startup
+
+# Disable backend blacklist to prevent BE nodes from being marked as
unavailable
+# This is useful in development/test environments where BE might have
temporary connection issues
+disable_backend_black_list = true
+```
+
+### Compose 配置文件
+
+创建 `docker-compose.yaml` 文件，包含完整的 Langfuse 服务栈配置。以下配置已经过优化，可以直接使用：
+
+```yaml
+services:
+ langfuse-web:
+ image: selectdb/langfuse-web:latest
+ container_name: langfuse-web
+ hostname: langfuse-web
+ depends_on: &langfuse-depends-on
+ postgres:
+ condition: service_healthy
+ minio:
+ condition: service_healthy
+ redis:
+ condition: service_healthy
+ doris_fe:
+ condition: service_healthy
+ doris_be:
+ condition: service_healthy
+ ports:
+ - "3000:3000"
+ environment: &langfuse-web-env
+ DATABASE_URL:
postgresql://postgres:postgres@langfuse-postgres:5432/postgres
+ NEXTAUTH_SECRET:
${NEXTAUTH_SECRET:-your-debug-secret-key-here-must-be-long-enough}
+ SALT:
${SALT:-your-super-secret-salt-with-at-least-32-characters-for-encryption}
+ ENCRYPTION_KEY:
${ENCRYPTION_KEY:-0000000000000000000000000000000000000000000000000000000000000000}
+ NEXTAUTH_URL: ${NEXTAUTH_URL:-http://localhost:3000}
+ TELEMETRY_ENABLED: ${TELEMETRY_ENABLED:-false}
+ LANGFUSE_ENABLE_EXPERIMENTAL_FEATURES:
${LANGFUSE_ENABLE_EXPERIMENTAL_FEATURES:-false}
+ LANGFUSE_INIT_ORG_ID: ${LANGFUSE_INIT_ORG_ID:-}
+ LANGFUSE_INIT_ORG_NAME: ${LANGFUSE_INIT_ORG_NAME:-}
+ LANGFUSE_INIT_PROJECT_ID: ${LANGFUSE_INIT_PROJECT_ID:-}
+ LANGFUSE_INIT_PROJECT_NAME: ${LANGFUSE_INIT_PROJECT_NAME:-}
+ LANGFUSE_INIT_PROJECT_PUBLIC_KEY:
${LANGFUSE_INIT_PROJECT_PUBLIC_KEY:-}
+ LANGFUSE_INIT_PROJECT_SECRET_KEY:
${LANGFUSE_INIT_PROJECT_SECRET_KEY:-}
+ LANGFUSE_INIT_USER_EMAIL: ${LANGFUSE_INIT_USER_EMAIL:-}
+ LANGFUSE_INIT_USER_NAME: ${LANGFUSE_INIT_USER_NAME:-}
+ LANGFUSE_INIT_USER_PASSWORD: ${LANGFUSE_INIT_USER_PASSWORD:-}
+ CLICKHOUSE_MIGRATION_URL:
${CLICKHOUSE_MIGRATION_URL:-clickhouse://clickhouse:clickhouse@localhost:9000}
+ CLICKHOUSE_URL: ${CLICKHOUSE_URL:-http://localhost:8123}
+ CLICKHOUSE_USER: ${CLICKHOUSE_USER:-clickhouse}
+ CLICKHOUSE_PASSWORD: ${CLICKHOUSE_PASSWORD:-clickhouse}
+ CLICKHOUSE_CLUSTER_ENABLED: ${CLICKHOUSE_CLUSTER_ENABLED:-false}
+ LANGFUSE_S3_EVENT_UPLOAD_BUCKET:
${LANGFUSE_S3_EVENT_UPLOAD_BUCKET:-langfuse}
+ LANGFUSE_S3_EVENT_UPLOAD_REGION:
${LANGFUSE_S3_EVENT_UPLOAD_REGION:-us-east-1}
+ LANGFUSE_S3_EVENT_UPLOAD_ACCESS_KEY_ID:
${LANGFUSE_S3_EVENT_UPLOAD_ACCESS_KEY_ID:-minio}
+ LANGFUSE_S3_EVENT_UPLOAD_SECRET_ACCESS_KEY:
${LANGFUSE_S3_EVENT_UPLOAD_SECRET_ACCESS_KEY:-miniosecret}
+ LANGFUSE_S3_EVENT_UPLOAD_ENDPOINT: http://langfuse-minio:9000
+ LANGFUSE_S3_EVENT_UPLOAD_FORCE_PATH_STYLE:
${LANGFUSE_S3_EVENT_UPLOAD_FORCE_PATH_STYLE:-true}
+ LANGFUSE_S3_EVENT_UPLOAD_PREFIX:
${LANGFUSE_S3_EVENT_UPLOAD_PREFIX:-events/}
+ REDIS_HOST: langfuse-redis
+ REDIS_PORT: 6379
+ REDIS_AUTH: ${REDIS_AUTH:-myredissecret}
+ REDIS_TLS_ENABLED: ${REDIS_TLS_ENABLED:-false}
+ REDIS_TLS_CA: ${REDIS_TLS_CA:-}
+ REDIS_TLS_CERT: ${REDIS_TLS_CERT:-}
+ REDIS_TLS_KEY: ${REDIS_TLS_KEY:-}
+
+ # Time zone configuration
+ TZ: Asia/Shanghai
+
+
+ LANGFUSE_AUTO_CLICKHOUSE_MIGRATION_DISABLED: true
+
+
+ LANGFUSE_ENABLE_BACKGROUND_MIGRATIONS: false
+
+
+ LANGFUSE_AUTO_DORIS_MIGRATION_DISABLED: false
+
+ # Doris configuration
+ # Note: Doris is enabled automatically when
LANGFUSE_ANALYTICS_BACKEND="doris"
+ LANGFUSE_ANALYTICS_BACKEND: ${LANGFUSE_ANALYTICS_BACKEND:-doris}
+ DORIS_URL: ${DORIS_FE_HTTP_URL:-}
+ DORIS_FE_HTTP_URL: ${DORIS_FE_HTTP_URL:-http://172.30.0.2:8030}
+ DORIS_FE_QUERY_PORT: ${DORIS_FE_QUERY_PORT:-9030}
+ DORIS_DB: ${DORIS_DB:-langfuse}
+ DORIS_USER: ${DORIS_USER:-root}
+ DORIS_PASSWORD: ${DORIS_PASSWORD:-}
+ DORIS_MAX_OPEN_CONNECTIONS: ${DORIS_MAX_OPEN_CONNECTIONS:-100}
+ DORIS_REQUEST_TIMEOUT_MS: ${DORIS_REQUEST_TIMEOUT_MS:-30000}
+ HOSTNAME: "0.0.0.0"
+ PORT: "3000"
+ restart: always
+ healthcheck:
+ test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider",
"--timeout=10", "http://127.0.0.1:3000/api/public/health";]
+ interval: 30s
+ timeout: 10s
+ retries: 3
+ start_period: 30s
+ networks:
+ - default
+ - doris_internal
+
+ langfuse-worker:
+ image: selectdb/langfuse-worker:latest
+ container_name: langfuse-worker
+ hostname: langfuse-worker
+ depends_on: *langfuse-depends-on
+ ports:
+ - "3030:3030"
+ environment:
+ <<: *langfuse-web-env
+ restart: always
+ healthcheck:
+ test: ["CMD-SHELL", "ps aux | grep 'node worker/dist/index.js' | grep
-v grep || exit 1"]
+ interval: 30s
+ timeout: 10s
+ retries: 3
+ start_period: 30s
+ networks:
+ - default
+ - doris_internal
+
+ minio:
+ image: minio/minio
+ container_name: langfuse-minio
+ hostname: langfuse-minio
+ restart: always
+ entrypoint: sh
+ # create the 'langfuse' bucket before starting the service
+ command: -c 'mkdir -p /data/langfuse && minio server --address ":9000"
--console-address ":9001" /data'
+ environment:
+ MINIO_ROOT_USER: minio
+ MINIO_ROOT_PASSWORD: miniosecret # CHANGEME
+ ports:
+ - 19090:9000
+ - 127.0.0.1:19091:9001
+ volumes:
+ - langfuse_minio_data:/data
+ healthcheck:
+ test: ["CMD", "mc", "ready", "local"]
+ interval: 1s
+ timeout: 5s
+ retries: 5
+ start_period: 1s
+
+ redis:
+ image: redis:7
+ container_name: langfuse-redis
+ hostname: langfuse-redis
+ restart: always
+ # CHANGEME: row below to secure redis password
+ command: >
+ --requirepass ${REDIS_AUTH:-myredissecret}
+ ports:
+ - 127.0.0.1:16379:6379
+ healthcheck:
+ test: ["CMD", "redis-cli", "ping"]
+ interval: 3s
+ timeout: 10s
+ retries: 10
+
+ postgres:
+ image: postgres:${POSTGRES_VERSION:-latest}
+ container_name: langfuse-postgres
+ hostname: langfuse-postgres
+ restart: always
+ healthcheck:
+ test: ["CMD-SHELL", "pg_isready -U postgres"]
+ interval: 3s
+ timeout: 3s
+ retries: 10
+ environment:
+ POSTGRES_USER: postgres
+ POSTGRES_PASSWORD: postgres # CHANGEME
+ POSTGRES_DB: postgres
+ ports:
+ - 127.0.0.1:5432:5432
+ volumes:
+ - langfuse_postgres_data:/var/lib/postgresql
+
+ doris_fe:
+ image: apache/doris:fe-2.1.11
+ hostname: doris_fe
+ container_name: doris_fe
+ environment:
+ - FE_SERVERS=fe1:172.30.0.2:9010
+ - FE_ID=1
+ ports:
+ - "8030:8030"
+ - "9030:9030"
+ - "9010:9010"
+ networks:
+ doris_internal:
+ ipv4_address: 172.30.0.2
+ volumes:
+ # Persist FE metadata
+ - doris_fe_meta:/opt/apache-doris/fe/doris-meta
+ # Mount custom configuration
+ -
./doris-config/fe_custom.conf:/opt/apache-doris/fe/conf/fe_custom.conf:ro
+ healthcheck:
+ test: [ "CMD-SHELL", "mysql -h 127.0.0.1 -P 9030 -uroot -e 'SELECT 1'
2>/dev/null || exit 1" ]
+ interval: 10s
+ timeout: 5s
+ retries: 18
+ start_period: 120s
+
+ doris_be:
+ image: apache/doris:be-2.1.11
+ hostname: doris_be
+ container_name: doris_be
+ environment:
+ - FE_SERVERS=fe1:172.30.0.2:9010
+ - BE_ADDR=172.30.0.3:9050
+ depends_on:
+ doris_fe:
+ condition: service_healthy
+ ports:
+ - "8040:8040"
+ - "8060:8060"
+ - "9050:9050"
+ - "9060:9060"
+ networks:
+ doris_internal:
+ ipv4_address: 172.30.0.3
+ volumes:
+ # Persist BE data storage
+ - doris_be_storage:/opt/apache-doris/be/storage
+ # Optional: mount custom configuration
+ # - ./be_custom.conf:/opt/apache-doris/be/conf/be_custom.conf:ro
+ restart: unless-stopped
+ healthcheck:
+ test: [ "CMD-SHELL", "mysql -h 172.30.0.2 -P 9030 -uroot -e 'SHOW
BACKENDS\\G' | grep -A 20 'Host: 172.30.0.3' | grep -q 'Alive: true'" ]
+ interval: 10s
+ timeout: 5s
+ retries: 5
+ start_period: 150s
+
+volumes:
+ langfuse_postgres_data:
+ driver: local
+ langfuse_minio_data:
+ driver: local
+ doris_fe_meta:
+ driver: local
+ doris_be_storage:
+ driver: local
+
+networks:
+ default:
+ driver: bridge
+ ipam:
+ driver: default
+ config:
+ - subnet: 10.200.0.0/24
+ gateway: 10.200.0.1
+ doris_internal:
+ driver: bridge
+ ipam:
+ config:
+ - subnet: 172.30.0.0/24
+```
+
+
+### 部署步骤
+
+### 1 . 启动 compose
+
+```Bash
+docker compose up -d
+```
+
+```Bash
+# 检查
+$ docker compose up -d
+[+] Running 9/9
+ ✔ Network docker-langfuse-doris_doris_internal Created
0.1s
+ ✔ Network docker-langfuse-doris_default Created
0.1s
+ ✔ Container doris_fe Healthy
13.8s
+ ✔ Container langfuse-postgres Healthy
13.8s
+ ✔ Container langfuse-redis Healthy
13.8s
+ ✔ Container langfuse-minio Healthy
13.8s
+ ✔ Container doris_be Healthy
54.3s
+ ✔ Container langfuse-worker Started
54.8s
+ ✔ Container langfuse-web Started
+```
+
+### 3. 验证部署
+
+检查服务状态：
+
+当服务状态都为 Healthy 说明 compose 启动成功
+
+```Bash
+$ docker compose ps
+NAME IMAGE COMMAND
SERVICE CREATED STATUS PORTS
+doris_be apache/doris:be-2.1.11 "bash entry_point.sh"
doris_be 2 minutes ago Up 2 minutes (healthy)
0.0.0.0:8040->8040/tcp, :::8040->8040/tcp, 0.0.0.0:8060->8060/tcp,
:::8060->8060/tcp, 0.0.0.0:9050->9050/tcp, :::9050->9050/tcp,
0.0.0.0:9060->9060/tcp, :::9060->9060/tcp
+doris_fe apache/doris:fe-2.1.11 "bash init_fe.sh"
doris_fe 2 minutes ago Up 2 minutes (healthy)
0.0.0.0:8030->8030/tcp, :::8030->8030/tcp, 0.0.0.0:9010->9010/tcp,
:::9010->9010/tcp, 0.0.0.0:9030->9030/tcp, :::9030->9030/tcp
+langfuse-minio minio/minio "sh -c 'mkdir -p /da…"
minio 2 minutes ago Up 2 minutes (healthy)
0.0.0.0:19090->9000/tcp, :::19090->9000/tcp, 127.0.0.1:19091->9001/tcp
+langfuse-postgres postgres:latest "docker-entrypoint.s…"
postgres 2 minutes ago Up 2 minutes (healthy)
127.0.0.1:5432->5432/tcp
+langfuse-redis redis:7 "docker-entrypoint.s…"
redis 2 minutes ago Up 2 minutes (healthy)
127.0.0.1:16379->6379/tcp
+langfuse-web selectdb/langfuse-web:latest "dumb-init -- ./web/…"
langfuse-web 2 minutes ago Up About a minute (healthy)
0.0.0.0:13000->3000/tcp, :::13000->3000/tcp
+langfuse-worker selectdb/langfuse-worker:latest "dumb-init -- ./work…"
langfuse-worker 2 minutes ago Up About a minute (healthy)
0.0.0.0:3030->3030/tcp, :::3030->3030/tcp
+```
+
+
+#### 4. 服务初始化
+
+部署完成后，通过以下方式访问和初始化服务：
+
+**访问 Langfuse Web 界面**：
+- 地址：http://localhost:3000
+
+**初始化步骤**：
+1. 打开浏览器访问 http://localhost:3000
+2. 创建管理员账户并登录
+3. 创建新组织与新项目
+4. 获取项目的 API Keys（Public Key 和 Secret Key）
+5. 配置 SDK 集成所需的认证信息
+
+
+# Examples
+
+## Using Langfuse SDK
+
+```Python
+import os
+# Instead of: import openai
+from langfuse.openai import OpenAI
+# from langfuse import observe
+
+# Langfuse config
+os.environ["LANGFUSE_SECRET_KEY"] = "sk-lf-******-******"
+os.environ["LANGFUSE_PUBLIC_KEY"] = "pk-lf-******-******"
+os.environ["LANGFUSE_HOST"] = "http://localhost:3000";
+
+
+# use OpenAI client to access DeepSeek API
+client = OpenAI(
+ base_url="https://api.deepseek.com";
+)
+
+
+# ask a question
+question = "Doris 可观测性解决方案的特点是什么？回答简洁清晰"
+print(f"question: {question}")
+
+completion = client.chat.completions.create(
+ model="deepseek-chat",
+ messages=[
+ {"role": "user", "content": question}
+ ]
+)
+response = completion.choices[0].message.content
+print(f"response: {response}")
+```
+
+## Using LangChain SDK
+
+```Python
+import os
+from langfuse.langchain import CallbackHandler
+from langchain_openai import ChatOpenAI
+
+# Langfuse config
+os.environ["LANGFUSE_SECRET_KEY"] = "sk-lf-******-******"
+os.environ["LANGFUSE_PUBLIC_KEY"] = "pk-lf-******-******"
+os.environ["LANGFUSE_HOST"] = "http://localhost:3000";
+
+# Create your LangChain components (using DeepSeek API)
+llm = ChatOpenAI(
+ model="deepseek-chat",
+ openai_api_base="https://api.deepseek.com";
+)
+
+# ask a question
+question = "Doris 可观测性解决方案的特点是什么？回答简洁清晰"
+print(f"question: {question} \n")
+
+# Run your chain with Langfuse tracing
+try:
+ # Initialize the Langfuse handler
+ langfuse_handler = CallbackHandler()
+ response = llm.invoke(question, config={"callbacks": [langfuse_handler]})
+ print(f"response: {response.content}")
+except Exception as e:
+ print(f"Error during chain execution: {e}")
+```
+
+## Using LlamaIndex SDK
+
+```Python
+from langfuse import get_client
+from openinference.instrumentation.llama_index import LlamaIndexInstrumentor
+from llama_index.llms.deepseek import DeepSeek
+
+# Langfuse config
+os.environ["LANGFUSE_SECRET_KEY"] = "sk-lf-******-******"
+os.environ["LANGFUSE_PUBLIC_KEY"] = "pk-lf-******-******"
+os.environ["LANGFUSE_HOST"] = "http://localhost:3000";
+
+langfuse = get_client()
+
+
+# Initialize LlamaIndex instrumentation
+LlamaIndexInstrumentor().instrument()
+
+
+# Set up the DeepSeek class with the required model and API key
+llm = DeepSeek(model="deepseek-chat")
+
+
+# ask a question
+question = "Doris 可观测性解决方案的特点是什么？回答简洁清晰"
+print(f"question: {question} \n")
+
+with langfuse.start_as_current_span(name="llama-index-trace"):
+ response = llm.complete(question)
+ print(f"response: {response}")
+```
Review Comment:
Add steps and screenshots to view the trace in langfuse.
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/ecosystem/observability/langfuse.md:
##########
@@ -0,0 +1,599 @@
+---
+{
+ "title": "Langfuse on Doris",
+ "language": "zh-CN"
+}
+---
+
+# Langfuse on Doris
+
+## 关于 Langfuse
+
+Langfuse 是一个开源的 LLM 工程平台，专门为大语言模型应用提供全面的可观测性解决方案。它主要提供以下核心功能：
+
+- **链路追踪**：完整记录 LLM 应用的调用链路和执行流程
+- **性能评估**：提供多维度的模型性能评估和质量分析
+- **提示管理**：集中管理和版本控制提示词模板
+- **指标监控**：实时监控应用性能、成本和质量指标
+
+本文档将详细介绍如何部署基于 Apache Doris 作为分析后端的 Langfuse 解决方案，充分利用 Doris 强大的 OLAP
分析能力来处理大规模的 LLM 应用数据。
+
+
+## 系统架构
+
+Langfuse on Doris 解决方案采用微服务架构，包含以下核心组件：
+
+| 组件 | 端口 | 功能说明
|
+|-----------------|-----------|----------------------------------------------------------------------------------|
+| Langfuse Web | 3000 | Web 界面和 API 服务，提供用户交互和数据接入
|
+| Langfuse Worker | 3030 | 异步任务处理，负责数据处理和分析任务
|
+| PostgreSQL | 5432 | 事务性数据存储，保存用户配置和元数据
|
+| Redis | 6379 | 缓存层和消息队列，提升系统响应性能
|
+| MinIO | 9090 | 对象存储服务，存储原始事件和多模态附件
|
+| Doris Fe | 9030 8030 | Doris frontend， Doris
架构的一部分，主要负责接收用户请求、查询解析和规划、元数据管理以及节点管理 |
+| Doris Be | 8040 8050 | Doris Backends ，Doris
架构的一部分，主要负责数据存储和查询计划的执行。数据会被切分成数据分片（Shard），在 BE 中以多副本方式存储。 |
+
+::: note
+
+在部署 Apache Doris 时，可以根据硬件环境与业务需求选择存算一体架构或存算分离架构。
+在 Langfuse 部署中，生产环境不建议使用 Docker Doris，Docker 中带有的 Fe，Be 部分为了方便用户快速体验Langfuse
on Doris 的能力
+
+:::
+
+```mermaid
+flowchart TB
+ User["UI, API, SDKs"]
+ subgraph vpc["VPC"]
+ Web["Web Server<br/>(langfuse/langfuse)"]
+ Worker["Async Worker<br/>(langfuse/worker)"]
+ Postgres["Postgres - OLTP<br/>(Transactional Data)"]
+ Cache["Redis/Valkey<br/>(Cache, Queue)"]
+ Doris["Doris - OLAP<br/>(Observability Data)"]
+ S3["S3 / Blob Storage<br/>(Raw events, multi-modal attachments)"]
+ end
+ LLM["LLM API/Gateway<br/>(optional)"]
+
+ User --> Web
+ Web --> S3
+ Web --> Postgres
+ Web --> Cache
+ Web --> Doris
+ Web -.->|"optional for playground"| LLM
+
+ Cache --> Worker
+ Worker --> Doris
+ Worker --> Postgres
+ Worker --> S3
+ Worker -.->|"optional for evals"| LLM
+```
+
+## 部署要求
+
+### 软件环境
+
+| 组件 | 版本要求 | 说明 |
+|------|----------|------|
+| Docker | 20.0+ | 容器运行环境 |
+| Docker Compose | 2.0+ | 容器编排工具 |
+| Apache Doris | 2.1.10+ | 分析数据库，需独立部署 |
+
+### 硬件资源
+
+| 资源类型 | 最低要求 | 推荐配置 | 说明 |
+|----------|----------|----------|------|
+| 内存 | 8GB | 16GB+ | 支持多服务并发运行 |
+| 磁盘 | 50GB | 100GB+ | 存储容器数据和日志 |
+| 网络 | 1Gbps | 10Gbps | 确保数据传输性能 |
+
+### 前置条件
+
+1. **Doris 集群准备**
+ - 确保 Doris 集群正常运行且性能稳定
+ - 验证 FE HTTP 端口（默认 8030）和查询端口（默认 9030）网络可达
+ - Langfuse 启动后将自动在 Doris 中创建所需的数据库和表结构
+
+2. **网络连通性**
+ - 部署环境能够访问 Docker Hub 拉取镜像
+ - Langfuse 服务能够访问 Doris 集群的相关端口
+ - 客户端能够访问 Langfuse Web 服务端口
+
+:::tip 部署建议
+推荐使用 Docker 部署 Langfuse 服务组件（Web、Worker、Redis、PostgreSQL），但 Doris
建议独立部署以获得更好的性能和稳定性。详细的 Doris 部署指南请参考官方文档。
+:::
+
+## 配置参数
+
+Langfuse 服务需要配置多个环境变量来支持各个组件的正常运行：
+
+### 基础服务配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `DATABASE_URL` |
`postgresql://postgres:postgres@langfuse-postgres:5432/postgres` | PostgreSQL
数据库连接地址 |
+| `NEXTAUTH_SECRET` | `your-debug-secret-key-here-must-be-long-enough` |
NextAuth 认证密钥，用于会话加密 |
+| `SALT` | `your-super-secret-salt-with-at-least-32-characters-for-encryption`
| 数据加密盐值（至少32字符） |
+| `ENCRYPTION_KEY` |
`0000000000000000000000000000000000000000000000000000000000000000` |
数据加密密钥（64字符） |
+| `NEXTAUTH_URL` | `http://localhost:3000` | Langfuse Web 服务地址 |
+| `TZ` | `Asia/Shanghai` | 系统时区设置 |
+
+### Redis 缓存配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|------------------|------|
+| `REDIS_HOST` | `langfuse-redis` | Redis 服务主机地址 |
+| `REDIS_PORT` | `6379` | Redis 服务端口 |
+| `REDIS_AUTH` | `myredissecret` | Redis 认证密码 |
+| `REDIS_TLS_ENABLED` | `false` | 是否启用 TLS 加密 |
+| `REDIS_TLS_CA` | `-` | TLS CA 证书路径 |
+| `REDIS_TLS_CERT` | `-` | TLS 客户端证书路径 |
+| `REDIS_TLS_KEY` | `-` | TLS 私钥路径 |
+
+### 数据迁移配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `LANGFUSE_AUTO_CLICKHOUSE_MIGRATION_DISABLED` | `true` | 禁用 ClickHouse 自动迁移 |
+| `LANGFUSE_ENABLE_BACKGROUND_MIGRATIONS` | `false` | 禁用后台迁移（使用 Doris 时需要关闭） |
+| `LANGFUSE_AUTO_DORIS_MIGRATION_DISABLED` | `false` | 启用 Doris 自动迁移 |
+
+### Doris 分析后端配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `LANGFUSE_ANALYTICS_BACKEND` | `doris` | 指定使用 Doris 作为分析后端 |
+| `DORIS_FE_HTTP_URL` | `http://localhost:8030` | Doris FE HTTP 服务地址 |
+| `DORIS_FE_QUERY_PORT` | `9030` | Doris FE 查询端口 |
+| `DORIS_DB` | `langfuse` | Doris 数据库名称 |
+| `DORIS_USER` | `root` | Doris 用户名 |
+| `DORIS_PASSWORD` | `123456` | Doris 密码 |
+| `DORIS_MAX_OPEN_CONNECTIONS` | `100` | 最大数据库连接数 |
+| `DORIS_REQUEST_TIMEOUT_MS` | `300000` | 请求超时时间（毫秒） |
+
+## Docker Compose 部署
+
+### 启动前准备
+
+配置根据需求进行修改，这里我们提供一个可以直接启动的compose 示例
+
+启动此 compose 需要映射 fe_custom.conf 配置文件
+
+```shell
+## compose 文件与配置文件路径结构如下
+
+docker-langfuse-doris
+├── docker-compose.yml
+└── doris-config
+ └── fe_custom.conf
+```
+
+```shell
+## 创建目录结构
+mkdir doris-langfuse-doris
+mkdir doris-langfuse-doris/doris-config
+```
+### 创建 fe_custom.conf
+
+fe_custom.conf 文件内容如下
+
+```shell
+# Doris FE Custom Configuration
+# This file will be loaded by Doris FE on startup
+
+# Disable backend blacklist to prevent BE nodes from being marked as
unavailable
+# This is useful in development/test environments where BE might have
temporary connection issues
+disable_backend_black_list = true
+```
+
+### Compose 配置文件
+
+创建 `docker-compose.yaml` 文件，包含完整的 Langfuse 服务栈配置。以下配置已经过优化，可以直接使用：
+
+```yaml
Review Comment:
Prepare a file docker-compose.yaml instead of list the content here.
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/ecosystem/observability/langfuse.md:
##########
@@ -0,0 +1,599 @@
+---
+{
+ "title": "Langfuse on Doris",
+ "language": "zh-CN"
+}
+---
+
+# Langfuse on Doris
+
+## 关于 Langfuse
+
+Langfuse 是一个开源的 LLM 工程平台，专门为大语言模型应用提供全面的可观测性解决方案。它主要提供以下核心功能：
+
+- **链路追踪**：完整记录 LLM 应用的调用链路和执行流程
+- **性能评估**：提供多维度的模型性能评估和质量分析
+- **提示管理**：集中管理和版本控制提示词模板
+- **指标监控**：实时监控应用性能、成本和质量指标
+
+本文档将详细介绍如何部署基于 Apache Doris 作为分析后端的 Langfuse 解决方案，充分利用 Doris 强大的 OLAP
分析能力来处理大规模的 LLM 应用数据。
+
+
+## 系统架构
+
+Langfuse on Doris 解决方案采用微服务架构，包含以下核心组件：
+
+| 组件 | 端口 | 功能说明
|
+|-----------------|-----------|----------------------------------------------------------------------------------|
+| Langfuse Web | 3000 | Web 界面和 API 服务，提供用户交互和数据接入
|
+| Langfuse Worker | 3030 | 异步任务处理，负责数据处理和分析任务
|
+| PostgreSQL | 5432 | 事务性数据存储，保存用户配置和元数据
|
+| Redis | 6379 | 缓存层和消息队列，提升系统响应性能
|
+| MinIO | 9090 | 对象存储服务，存储原始事件和多模态附件
|
+| Doris Fe | 9030 8030 | Doris frontend， Doris
架构的一部分，主要负责接收用户请求、查询解析和规划、元数据管理以及节点管理 |
+| Doris Be | 8040 8050 | Doris Backends ，Doris
架构的一部分，主要负责数据存储和查询计划的执行。数据会被切分成数据分片（Shard），在 BE 中以多副本方式存储。 |
+
+::: note
+
+在部署 Apache Doris 时，可以根据硬件环境与业务需求选择存算一体架构或存算分离架构。
+在 Langfuse 部署中，生产环境不建议使用 Docker Doris，Docker 中带有的 Fe，Be 部分为了方便用户快速体验Langfuse
on Doris 的能力
+
+:::
+
+```mermaid
+flowchart TB
+ User["UI, API, SDKs"]
+ subgraph vpc["VPC"]
+ Web["Web Server<br/>(langfuse/langfuse)"]
+ Worker["Async Worker<br/>(langfuse/worker)"]
+ Postgres["Postgres - OLTP<br/>(Transactional Data)"]
+ Cache["Redis/Valkey<br/>(Cache, Queue)"]
+ Doris["Doris - OLAP<br/>(Observability Data)"]
+ S3["S3 / Blob Storage<br/>(Raw events, multi-modal attachments)"]
+ end
+ LLM["LLM API/Gateway<br/>(optional)"]
+
+ User --> Web
+ Web --> S3
+ Web --> Postgres
+ Web --> Cache
+ Web --> Doris
+ Web -.->|"optional for playground"| LLM
+
+ Cache --> Worker
+ Worker --> Doris
+ Worker --> Postgres
+ Worker --> S3
+ Worker -.->|"optional for evals"| LLM
+```
+
+## 部署要求
+
+### 软件环境
+
+| 组件 | 版本要求 | 说明 |
+|------|----------|------|
+| Docker | 20.0+ | 容器运行环境 |
+| Docker Compose | 2.0+ | 容器编排工具 |
+| Apache Doris | 2.1.10+ | 分析数据库，需独立部署 |
+
+### 硬件资源
+
+| 资源类型 | 最低要求 | 推荐配置 | 说明 |
+|----------|----------|----------|------|
+| 内存 | 8GB | 16GB+ | 支持多服务并发运行 |
+| 磁盘 | 50GB | 100GB+ | 存储容器数据和日志 |
+| 网络 | 1Gbps | 10Gbps | 确保数据传输性能 |
+
+### 前置条件
+
+1. **Doris 集群准备**
+ - 确保 Doris 集群正常运行且性能稳定
+ - 验证 FE HTTP 端口（默认 8030）和查询端口（默认 9030）网络可达
+ - Langfuse 启动后将自动在 Doris 中创建所需的数据库和表结构
+
+2. **网络连通性**
+ - 部署环境能够访问 Docker Hub 拉取镜像
+ - Langfuse 服务能够访问 Doris 集群的相关端口
+ - 客户端能够访问 Langfuse Web 服务端口
+
+:::tip 部署建议
+推荐使用 Docker 部署 Langfuse 服务组件（Web、Worker、Redis、PostgreSQL），但 Doris
建议独立部署以获得更好的性能和稳定性。详细的 Doris 部署指南请参考官方文档。
+:::
+
+## 配置参数
+
+Langfuse 服务需要配置多个环境变量来支持各个组件的正常运行：
+
+### 基础服务配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `DATABASE_URL` |
`postgresql://postgres:postgres@langfuse-postgres:5432/postgres` | PostgreSQL
数据库连接地址 |
+| `NEXTAUTH_SECRET` | `your-debug-secret-key-here-must-be-long-enough` |
NextAuth 认证密钥，用于会话加密 |
+| `SALT` | `your-super-secret-salt-with-at-least-32-characters-for-encryption`
| 数据加密盐值（至少32字符） |
+| `ENCRYPTION_KEY` |
`0000000000000000000000000000000000000000000000000000000000000000` |
数据加密密钥（64字符） |
+| `NEXTAUTH_URL` | `http://localhost:3000` | Langfuse Web 服务地址 |
+| `TZ` | `Asia/Shanghai` | 系统时区设置 |
+
+### Redis 缓存配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|------------------|------|
+| `REDIS_HOST` | `langfuse-redis` | Redis 服务主机地址 |
+| `REDIS_PORT` | `6379` | Redis 服务端口 |
+| `REDIS_AUTH` | `myredissecret` | Redis 认证密码 |
+| `REDIS_TLS_ENABLED` | `false` | 是否启用 TLS 加密 |
+| `REDIS_TLS_CA` | `-` | TLS CA 证书路径 |
+| `REDIS_TLS_CERT` | `-` | TLS 客户端证书路径 |
+| `REDIS_TLS_KEY` | `-` | TLS 私钥路径 |
+
+### 数据迁移配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `LANGFUSE_AUTO_CLICKHOUSE_MIGRATION_DISABLED` | `true` | 禁用 ClickHouse 自动迁移 |
+| `LANGFUSE_ENABLE_BACKGROUND_MIGRATIONS` | `false` | 禁用后台迁移（使用 Doris 时需要关闭） |
+| `LANGFUSE_AUTO_DORIS_MIGRATION_DISABLED` | `false` | 启用 Doris 自动迁移 |
+
+### Doris 分析后端配置
+
+| 参数名称 | 示例值 | 说明 |
+|---------|--------|------|
+| `LANGFUSE_ANALYTICS_BACKEND` | `doris` | 指定使用 Doris 作为分析后端 |
+| `DORIS_FE_HTTP_URL` | `http://localhost:8030` | Doris FE HTTP 服务地址 |
+| `DORIS_FE_QUERY_PORT` | `9030` | Doris FE 查询端口 |
+| `DORIS_DB` | `langfuse` | Doris 数据库名称 |
+| `DORIS_USER` | `root` | Doris 用户名 |
+| `DORIS_PASSWORD` | `123456` | Doris 密码 |
+| `DORIS_MAX_OPEN_CONNECTIONS` | `100` | 最大数据库连接数 |
+| `DORIS_REQUEST_TIMEOUT_MS` | `300000` | 请求超时时间（毫秒） |
+
+## Docker Compose 部署
+
+### 启动前准备
+
+配置根据需求进行修改，这里我们提供一个可以直接启动的compose 示例
+
+启动此 compose 需要映射 fe_custom.conf 配置文件
+
+```shell
+## compose 文件与配置文件路径结构如下
+
+docker-langfuse-doris
+├── docker-compose.yml
+└── doris-config
+ └── fe_custom.conf
+```
+
+```shell
+## 创建目录结构
+mkdir doris-langfuse-doris
+mkdir doris-langfuse-doris/doris-config
+```
+### 创建 fe_custom.conf
+
+fe_custom.conf 文件内容如下
+
+```shell
+# Doris FE Custom Configuration
+# This file will be loaded by Doris FE on startup
+
+# Disable backend blacklist to prevent BE nodes from being marked as
unavailable
+# This is useful in development/test environments where BE might have
temporary connection issues
+disable_backend_black_list = true
+```
+
+### Compose 配置文件
+
+创建 `docker-compose.yaml` 文件，包含完整的 Langfuse 服务栈配置。以下配置已经过优化，可以直接使用：
+
+```yaml
+services:
+ langfuse-web:
+ image: selectdb/langfuse-web:latest
+ container_name: langfuse-web
+ hostname: langfuse-web
+ depends_on: &langfuse-depends-on
+ postgres:
+ condition: service_healthy
+ minio:
+ condition: service_healthy
+ redis:
+ condition: service_healthy
+ doris_fe:
+ condition: service_healthy
+ doris_be:
+ condition: service_healthy
+ ports:
+ - "3000:3000"
+ environment: &langfuse-web-env
+ DATABASE_URL:
postgresql://postgres:postgres@langfuse-postgres:5432/postgres
+ NEXTAUTH_SECRET:
${NEXTAUTH_SECRET:-your-debug-secret-key-here-must-be-long-enough}
+ SALT:
${SALT:-your-super-secret-salt-with-at-least-32-characters-for-encryption}
+ ENCRYPTION_KEY:
${ENCRYPTION_KEY:-0000000000000000000000000000000000000000000000000000000000000000}
+ NEXTAUTH_URL: ${NEXTAUTH_URL:-http://localhost:3000}
+ TELEMETRY_ENABLED: ${TELEMETRY_ENABLED:-false}
+ LANGFUSE_ENABLE_EXPERIMENTAL_FEATURES:
${LANGFUSE_ENABLE_EXPERIMENTAL_FEATURES:-false}
+ LANGFUSE_INIT_ORG_ID: ${LANGFUSE_INIT_ORG_ID:-}
+ LANGFUSE_INIT_ORG_NAME: ${LANGFUSE_INIT_ORG_NAME:-}
+ LANGFUSE_INIT_PROJECT_ID: ${LANGFUSE_INIT_PROJECT_ID:-}
+ LANGFUSE_INIT_PROJECT_NAME: ${LANGFUSE_INIT_PROJECT_NAME:-}
+ LANGFUSE_INIT_PROJECT_PUBLIC_KEY:
${LANGFUSE_INIT_PROJECT_PUBLIC_KEY:-}
+ LANGFUSE_INIT_PROJECT_SECRET_KEY:
${LANGFUSE_INIT_PROJECT_SECRET_KEY:-}
+ LANGFUSE_INIT_USER_EMAIL: ${LANGFUSE_INIT_USER_EMAIL:-}
+ LANGFUSE_INIT_USER_NAME: ${LANGFUSE_INIT_USER_NAME:-}
+ LANGFUSE_INIT_USER_PASSWORD: ${LANGFUSE_INIT_USER_PASSWORD:-}
+ CLICKHOUSE_MIGRATION_URL:
${CLICKHOUSE_MIGRATION_URL:-clickhouse://clickhouse:clickhouse@localhost:9000}
+ CLICKHOUSE_URL: ${CLICKHOUSE_URL:-http://localhost:8123}
+ CLICKHOUSE_USER: ${CLICKHOUSE_USER:-clickhouse}
+ CLICKHOUSE_PASSWORD: ${CLICKHOUSE_PASSWORD:-clickhouse}
+ CLICKHOUSE_CLUSTER_ENABLED: ${CLICKHOUSE_CLUSTER_ENABLED:-false}
+ LANGFUSE_S3_EVENT_UPLOAD_BUCKET:
${LANGFUSE_S3_EVENT_UPLOAD_BUCKET:-langfuse}
+ LANGFUSE_S3_EVENT_UPLOAD_REGION:
${LANGFUSE_S3_EVENT_UPLOAD_REGION:-us-east-1}
+ LANGFUSE_S3_EVENT_UPLOAD_ACCESS_KEY_ID:
${LANGFUSE_S3_EVENT_UPLOAD_ACCESS_KEY_ID:-minio}
+ LANGFUSE_S3_EVENT_UPLOAD_SECRET_ACCESS_KEY:
${LANGFUSE_S3_EVENT_UPLOAD_SECRET_ACCESS_KEY:-miniosecret}
+ LANGFUSE_S3_EVENT_UPLOAD_ENDPOINT: http://langfuse-minio:9000
+ LANGFUSE_S3_EVENT_UPLOAD_FORCE_PATH_STYLE:
${LANGFUSE_S3_EVENT_UPLOAD_FORCE_PATH_STYLE:-true}
+ LANGFUSE_S3_EVENT_UPLOAD_PREFIX:
${LANGFUSE_S3_EVENT_UPLOAD_PREFIX:-events/}
+ REDIS_HOST: langfuse-redis
+ REDIS_PORT: 6379
+ REDIS_AUTH: ${REDIS_AUTH:-myredissecret}
+ REDIS_TLS_ENABLED: ${REDIS_TLS_ENABLED:-false}
+ REDIS_TLS_CA: ${REDIS_TLS_CA:-}
+ REDIS_TLS_CERT: ${REDIS_TLS_CERT:-}
+ REDIS_TLS_KEY: ${REDIS_TLS_KEY:-}
+
+ # Time zone configuration
+ TZ: Asia/Shanghai
+
+
+ LANGFUSE_AUTO_CLICKHOUSE_MIGRATION_DISABLED: true
+
+
+ LANGFUSE_ENABLE_BACKGROUND_MIGRATIONS: false
+
+
+ LANGFUSE_AUTO_DORIS_MIGRATION_DISABLED: false
+
+ # Doris configuration
+ # Note: Doris is enabled automatically when
LANGFUSE_ANALYTICS_BACKEND="doris"
+ LANGFUSE_ANALYTICS_BACKEND: ${LANGFUSE_ANALYTICS_BACKEND:-doris}
+ DORIS_URL: ${DORIS_FE_HTTP_URL:-}
+ DORIS_FE_HTTP_URL: ${DORIS_FE_HTTP_URL:-http://172.30.0.2:8030}
+ DORIS_FE_QUERY_PORT: ${DORIS_FE_QUERY_PORT:-9030}
+ DORIS_DB: ${DORIS_DB:-langfuse}
+ DORIS_USER: ${DORIS_USER:-root}
+ DORIS_PASSWORD: ${DORIS_PASSWORD:-}
+ DORIS_MAX_OPEN_CONNECTIONS: ${DORIS_MAX_OPEN_CONNECTIONS:-100}
+ DORIS_REQUEST_TIMEOUT_MS: ${DORIS_REQUEST_TIMEOUT_MS:-30000}
+ HOSTNAME: "0.0.0.0"
+ PORT: "3000"
+ restart: always
+ healthcheck:
+ test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider",
"--timeout=10", "http://127.0.0.1:3000/api/public/health";]
+ interval: 30s
+ timeout: 10s
+ retries: 3
+ start_period: 30s
+ networks:
+ - default
+ - doris_internal
+
+ langfuse-worker:
+ image: selectdb/langfuse-worker:latest
+ container_name: langfuse-worker
+ hostname: langfuse-worker
+ depends_on: *langfuse-depends-on
+ ports:
+ - "3030:3030"
+ environment:
+ <<: *langfuse-web-env
+ restart: always
+ healthcheck:
+ test: ["CMD-SHELL", "ps aux | grep 'node worker/dist/index.js' | grep
-v grep || exit 1"]
+ interval: 30s
+ timeout: 10s
+ retries: 3
+ start_period: 30s
+ networks:
+ - default
+ - doris_internal
+
+ minio:
+ image: minio/minio
+ container_name: langfuse-minio
+ hostname: langfuse-minio
+ restart: always
+ entrypoint: sh
+ # create the 'langfuse' bucket before starting the service
+ command: -c 'mkdir -p /data/langfuse && minio server --address ":9000"
--console-address ":9001" /data'
+ environment:
+ MINIO_ROOT_USER: minio
+ MINIO_ROOT_PASSWORD: miniosecret # CHANGEME
+ ports:
+ - 19090:9000
+ - 127.0.0.1:19091:9001
+ volumes:
+ - langfuse_minio_data:/data
+ healthcheck:
+ test: ["CMD", "mc", "ready", "local"]
+ interval: 1s
+ timeout: 5s
+ retries: 5
+ start_period: 1s
+
+ redis:
+ image: redis:7
+ container_name: langfuse-redis
+ hostname: langfuse-redis
+ restart: always
+ # CHANGEME: row below to secure redis password
+ command: >
+ --requirepass ${REDIS_AUTH:-myredissecret}
+ ports:
+ - 127.0.0.1:16379:6379
+ healthcheck:
+ test: ["CMD", "redis-cli", "ping"]
+ interval: 3s
+ timeout: 10s
+ retries: 10
+
+ postgres:
+ image: postgres:${POSTGRES_VERSION:-latest}
+ container_name: langfuse-postgres
+ hostname: langfuse-postgres
+ restart: always
+ healthcheck:
+ test: ["CMD-SHELL", "pg_isready -U postgres"]
+ interval: 3s
+ timeout: 3s
+ retries: 10
+ environment:
+ POSTGRES_USER: postgres
+ POSTGRES_PASSWORD: postgres # CHANGEME
+ POSTGRES_DB: postgres
+ ports:
+ - 127.0.0.1:5432:5432
+ volumes:
+ - langfuse_postgres_data:/var/lib/postgresql
+
+ doris_fe:
+ image: apache/doris:fe-2.1.11
+ hostname: doris_fe
+ container_name: doris_fe
+ environment:
+ - FE_SERVERS=fe1:172.30.0.2:9010
+ - FE_ID=1
+ ports:
+ - "8030:8030"
+ - "9030:9030"
+ - "9010:9010"
+ networks:
+ doris_internal:
+ ipv4_address: 172.30.0.2
+ volumes:
+ # Persist FE metadata
+ - doris_fe_meta:/opt/apache-doris/fe/doris-meta
+ # Mount custom configuration
+ -
./doris-config/fe_custom.conf:/opt/apache-doris/fe/conf/fe_custom.conf:ro
+ healthcheck:
+ test: [ "CMD-SHELL", "mysql -h 127.0.0.1 -P 9030 -uroot -e 'SELECT 1'
2>/dev/null || exit 1" ]
+ interval: 10s
+ timeout: 5s
+ retries: 18
+ start_period: 120s
+
+ doris_be:
+ image: apache/doris:be-2.1.11
+ hostname: doris_be
+ container_name: doris_be
+ environment:
+ - FE_SERVERS=fe1:172.30.0.2:9010
+ - BE_ADDR=172.30.0.3:9050
+ depends_on:
+ doris_fe:
+ condition: service_healthy
+ ports:
+ - "8040:8040"
+ - "8060:8060"
+ - "9050:9050"
+ - "9060:9060"
+ networks:
+ doris_internal:
+ ipv4_address: 172.30.0.3
+ volumes:
+ # Persist BE data storage
+ - doris_be_storage:/opt/apache-doris/be/storage
+ # Optional: mount custom configuration
+ # - ./be_custom.conf:/opt/apache-doris/be/conf/be_custom.conf:ro
+ restart: unless-stopped
+ healthcheck:
+ test: [ "CMD-SHELL", "mysql -h 172.30.0.2 -P 9030 -uroot -e 'SHOW
BACKENDS\\G' | grep -A 20 'Host: 172.30.0.3' | grep -q 'Alive: true'" ]
+ interval: 10s
+ timeout: 5s
+ retries: 5
+ start_period: 150s
+
+volumes:
+ langfuse_postgres_data:
+ driver: local
+ langfuse_minio_data:
+ driver: local
+ doris_fe_meta:
+ driver: local
+ doris_be_storage:
+ driver: local
+
+networks:
+ default:
+ driver: bridge
+ ipam:
+ driver: default
+ config:
+ - subnet: 10.200.0.0/24
+ gateway: 10.200.0.1
+ doris_internal:
+ driver: bridge
+ ipam:
+ config:
+ - subnet: 172.30.0.0/24
+```
+
+
+### 部署步骤
+
+### 1 . 启动 compose
+
+```Bash
+docker compose up -d
+```
+
+```Bash
+# 检查
+$ docker compose up -d
+[+] Running 9/9
+ ✔ Network docker-langfuse-doris_doris_internal Created
0.1s
+ ✔ Network docker-langfuse-doris_default Created
0.1s
+ ✔ Container doris_fe Healthy
13.8s
+ ✔ Container langfuse-postgres Healthy
13.8s
+ ✔ Container langfuse-redis Healthy
13.8s
+ ✔ Container langfuse-minio Healthy
13.8s
+ ✔ Container doris_be Healthy
54.3s
+ ✔ Container langfuse-worker Started
54.8s
+ ✔ Container langfuse-web Started
+```
+
+### 3. 验证部署
+
+检查服务状态：
+
+当服务状态都为 Healthy 说明 compose 启动成功
+
+```Bash
+$ docker compose ps
+NAME IMAGE COMMAND
SERVICE CREATED STATUS PORTS
+doris_be apache/doris:be-2.1.11 "bash entry_point.sh"
doris_be 2 minutes ago Up 2 minutes (healthy)
0.0.0.0:8040->8040/tcp, :::8040->8040/tcp, 0.0.0.0:8060->8060/tcp,
:::8060->8060/tcp, 0.0.0.0:9050->9050/tcp, :::9050->9050/tcp,
0.0.0.0:9060->9060/tcp, :::9060->9060/tcp
+doris_fe apache/doris:fe-2.1.11 "bash init_fe.sh"
doris_fe 2 minutes ago Up 2 minutes (healthy)
0.0.0.0:8030->8030/tcp, :::8030->8030/tcp, 0.0.0.0:9010->9010/tcp,
:::9010->9010/tcp, 0.0.0.0:9030->9030/tcp, :::9030->9030/tcp
+langfuse-minio minio/minio "sh -c 'mkdir -p /da…"
minio 2 minutes ago Up 2 minutes (healthy)
0.0.0.0:19090->9000/tcp, :::19090->9000/tcp, 127.0.0.1:19091->9001/tcp
+langfuse-postgres postgres:latest "docker-entrypoint.s…"
postgres 2 minutes ago Up 2 minutes (healthy)
127.0.0.1:5432->5432/tcp
+langfuse-redis redis:7 "docker-entrypoint.s…"
redis 2 minutes ago Up 2 minutes (healthy)
127.0.0.1:16379->6379/tcp
+langfuse-web selectdb/langfuse-web:latest "dumb-init -- ./web/…"
langfuse-web 2 minutes ago Up About a minute (healthy)
0.0.0.0:13000->3000/tcp, :::13000->3000/tcp
+langfuse-worker selectdb/langfuse-worker:latest "dumb-init -- ./work…"
langfuse-worker 2 minutes ago Up About a minute (healthy)
0.0.0.0:3030->3030/tcp, :::3030->3030/tcp
+```
+
+
+#### 4. 服务初始化
+
+部署完成后，通过以下方式访问和初始化服务：
+
+**访问 Langfuse Web 界面**：
+- 地址：http://localhost:3000
+
+**初始化步骤**：
+1. 打开浏览器访问 http://localhost:3000
+2. 创建管理员账户并登录
+3. 创建新组织与新项目
+4. 获取项目的 API Keys（Public Key 和 Secret Key）
+5. 配置 SDK 集成所需的认证信息
+
+
+# Examples
+
+## Using Langfuse SDK
+
+```Python
+import os
+# Instead of: import openai
+from langfuse.openai import OpenAI
+# from langfuse import observe
+
+# Langfuse config
+os.environ["LANGFUSE_SECRET_KEY"] = "sk-lf-******-******"
+os.environ["LANGFUSE_PUBLIC_KEY"] = "pk-lf-******-******"
+os.environ["LANGFUSE_HOST"] = "http://localhost:3000";
+
+
+# use OpenAI client to access DeepSeek API
+client = OpenAI(
+ base_url="https://api.deepseek.com";
Review Comment:
remove deepseek url in English version.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
