开启 AI 可观测服务-云数据库 SelectDB 版(SelectDB)-阿里云帮助中心

介绍如何开启云数据库 SelectDB 版的 AI 可观测服务并投递第一条可观测数据。完成本文操作约需 15 分钟。

前提条件

已创建 SelectDB 5.0 及以上版本的实例，且实例状态为运行中。
本地已安装 Python 3.9 及以上版本（用于投递可观测数据）。
已开通 AI 可观测服务。当前为邀测阶段，请联系技术支持。

步骤一：开启 AI 可观测服务

登录云数据库 SelectDB 版控制台。
在实例列表中，单击目标实例 ID，进入实例详情页。
在左侧导航栏，单击AI 可观测。
单击开启服务。
在弹出的对话框中确认将自动创建以下资源，然后单击确定。
- 以 litefuse 为名称前缀的 SelectDB 数据库。
- 以 lfu 为名称前缀的 SelectDB 用户。
- 以 lfu 为名称前缀的 SelectDB 白名单分组。
- 一个 Litefuse 实例。
等待约 1~2 分钟，直到实例状态变为运行中。

重要

释放 SelectDB 实例后，存储在 Litefuse 实例上的数据将被删除。

步骤二：配置访问白名单

服务开启后，需要将 SDK 所在主机的公网 IP 地址添加到白名单，以便访问 Litefuse 服务。

在 AI 可观测页面的白名单设置区域，找到需要修改的白名单分组，单击修改。
在组内白名单输入框中，添加公网 IP 地址。多个 IP 地址之间使用英文逗号（,）分隔。
单击确定。

步骤三：创建用户

在 AI 可观测页面的连接地址区域，获取公网地址。
在浏览器中访问该公网地址（格式为 http://<公网IP>:3000）。
在登录页面，单击 Sign up。
填写 Name、Email 和 Password，单击 Sign up 完成注册。

步骤四：创建组织与项目

注册完成后，系统自动进入 Setup 向导，按以下步骤完成组织和项目的创建。

在 Create Organization 页面，输入组织名称，单击 Create。
在 Invite Members 页面，按需邀请团队成员，或单击 Next 跳过。
在 Create Project 页面，输入项目名称，单击 Create。

步骤五：创建 API Key

项目创建完成后，在 Get Started 页面，单击 Create new API key。
系统生成并显示 Secret Key 和 Public Key，请妥善保存。

重要

Secret Key 仅在创建时显示一次，请务必立即保存。如果丢失，需要重新创建 API Key。

步骤六：投递第一条可观测数据

完成以上配置后，通过 Python SDK 投递第一条可观测数据，验证服务是否正常工作。

安装 Langfuse SDK。
```
pip install langfuse
```

设置环境变量。将以下占位符替换为实际值。

# Litefuse 连接信息（步骤五获取）
export LANGFUSE_SECRET_KEY="<your-secret-key>"
export LANGFUSE_PUBLIC_KEY="<your-public-key>"
export LANGFUSE_HOST="<公网地址>"

# 通义千问 API Key（用于示例中的 LLM 调用）
export DASHSCOPE_API_KEY="<your-dashscope-api-key>"

创建并运行示例代码 quick_start.py。

import os
from langfuse import observe
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("DASHSCOPE_API_KEY"),
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)

@observe()
def chat(user_message):
    response = client.chat.completions.create(
        model="qwen-plus",
        messages=[{"role": "user", "content": user_message}],
    )
    return response.choices[0].message.content

if __name__ == "__main__":
    result = chat("什么是云数据库 SelectDB？请用一句话介绍。")
    print(result)

运行示例代码。
```
python quick_start.py
```
验证数据投递成功：在浏览器中访问 Litefuse 页面，在左侧导航栏单击 Tracing，确认可以看到刚才的调用记录。