2.5 KiB

Raw Blame History

禁用链路追踪功能

问题说明

默认情况下，cozeloop 框架会自动发送链路追踪数据到 https://api.coze.cn/v1/loop/traces/ingest，用于监控和调试。

如果你不需要这个功能（或者因为认证问题导致失败），可以通过设置环境变量来禁用它。

错误日志示例

HTTP Request: POST https://api.coze.cn/v1/loop/traces/ingest "HTTP/1.1 401 Unauthorized"
Call remote service failed. Path: https://api.coze.cn/v1/loop/traces/ingest, remote service error, authentication is invalid

解决方案

方法一：在 Dockerfile 中禁用（推荐）

在 assets/Dockerfile 中添加以下环境变量：

ENV COZE_API_KEY="Bearer YOUR_KEY" \
    LLM_API_KEY="Bearer YOUR_KEY" \
    COZE_WORKLOAD_IDENTITY_API_KEY="Bearer YOUR_KEY" \
    COZE_INTEGRATION_API_KEY="Bearer YOUR_KEY" \
    COZE_WORKSPACE_ID=YOUR_WORKSPACE_ID \
    # 禁用 cozeloop 链路追踪
    COZE_TRACING_ENABLED=false \
    OPT_ENABLE_LONG_REPORT=false

方法二：使用 docker-compose

在 docker-compose.yml 中添加：

services:
  math-correction:
    environment:
      - COZE_API_KEY=Bearer YOUR_KEY
      - LLM_API_KEY=Bearer YOUR_KEY
      - COZE_WORKLOAD_IDENTITY_API_KEY=Bearer YOUR_KEY
      - COZE_INTEGRATION_API_KEY=Bearer YOUR_KEY
      - COZE_WORKSPACE_ID=YOUR_WORKSPACE_ID
      # 禁用链路追踪
      - COZE_TRACING_ENABLED=false
      - OPT_ENABLE_LONG_REPORT=false

方法三：使用 .env 文件

在 .env 文件中添加：

# 禁用链路追踪
COZE_TRACING_ENABLED=false
OPT_ENABLE_LONG_REPORT=false

环境变量说明

环境变量	默认值	说明
`COZE_TRACING_ENABLED`	`true`	是否启用链路追踪
`OPT_ENABLE_LONG_REPORT`	`false`	是否启用长报告（会影响追踪数据量）

验证

禁用后，重新构建并运行容器：

# 重新构建
docker build -f assets/Dockerfile -t math-correction:latest .

# 运行容器
docker run -d --name math-correction -p 8000:8000 math-correction:latest

# 查看日志，确认不再有 loop/traces/ingest 的错误
docker logs math-correction | grep -i "traces/ingest"

预期结果：没有任何输出（表示追踪已禁用）

注意事项

✅ 禁用追踪不会影响核心功能
✅ 可以减少网络开销
✅ 可以避免 401 认证错误
⚠️ 禁用后将无法在 Coze 平台查看链路追踪信息

2.5 KiB Raw Blame History