latitude-llm

环境要求

• 已安装 Node.js（可使用 npm 安装依赖）
• 已注册 latitude.so 账号，可获取 API Key 与项目 slug（免费含 20K credits/月）
• 应用已接入某个 LLM SDK（README 示例使用 OpenAI）
• 环境变量 LATITUDE_API_KEY 与 LATITUDE_PROJECT_SLUG 可用

安装与启动步骤

1. 1注册并获取凭证

   到 latitude.so 注册，免费额度含每月 20K credits、30 天数据保留、席位不限；注册后在控制台取得 API Key 和项目 slug。

2. 2安装遥测 SDK

   在你的 TypeScript/Node 项目根目录安装官方遥测包，npm 会自动写入 package.json 依赖。

   npm install @latitude-data/telemetry

   复制

3. 3导出环境变量

   把 API Key 与项目 slug 写入环境变量，避免硬编码进代码；示例值需替换为你自己的真实值。

   export LATITUDE_API_KEY=sk-xxxxxxxx
   export LATITUDE_PROJECT_SLUG=my-project

   复制

4. 4初始化 Latitude 客户端

   在应用入口创建 Latitude 实例，apiKey 与 project 从环境变量读取，并在 instrumentations 中注册你使用的 LLM SDK（示例为 OpenAI）。

   import { Latitude } from "@latitude-data/telemetry";
   import OpenAI from "openai";
   
   const latitude = new Latitude({
     apiKey: process.env.LATITUDE_API_KEY!,
     project: process.env.LATITUDE_PROJECT_SLUG!,
     instrumentations: { openai: OpenAI },
   });
   
   const client = new OpenAI();

   复制

5. 5正常发起 LLM 调用

   保持原有业务代码不变，照常调用 chat.completions.create；已注册的 SDK 调用会被自动采集为 trace，无需手动埋点。

   await client.chat.completions.create({
     model: "gpt-4o",
     messages: [{ role: "user", content: "Hello" }],
   });

   复制

6. 6关闭客户端上报数据

   进程结束前调用 shutdown()，确保缓冲区中的 trace 全部发送到 Latitude，否则可能丢失末尾数据。

   await latitude.shutdown();

   复制

关键配置

如何确认成功

在 Latitude 控制台中能看到刚才那次 LLM 调用对应的 trace，说明接入成功。

常见问题

注意事项

• README 未提供自托管部署命令，本文只覆盖官方推荐的 SDK 接入方式。
• API Key 请通过环境变量注入，不要硬编码或提交到代码仓库。
• 进程退出前务必执行 await latitude.shutdown()，避免 trace 未上报。