Laminar

Laminar 是一个专为 AI 智能体构建的开源可观测性平台。

• 追踪。文档 OpenTelemetry 原生的强大追踪 SDK - 仅需一行代码即可自动追踪 Vercel AI SDK、Browser Use、Stagehand、LangChain、OpenAI、Anthropic、Gemini 等。
• OpenTelemetry 原生的强大追踪 SDK - 仅需一行代码即可自动追踪 Vercel AI SDK、Browser Use、Stagehand、LangChain、OpenAI、Anthropic、Gemini 等。
• 评估。文档 无预设的、可扩展的 SDK 和 CLI，用于在本地或 CI/CD 管道中运行评估。用于可视化评估和比较结果的 UI。
• 无预设的、可扩展的 SDK 和 CLI，用于在本地或 CI/CD 管道中运行评估。
• 用于可视化评估和比较结果的 UI。
• AI 监控。文档 通过自然语言描述定义事件，以跟踪智能体的问题、逻辑错误和自定义行为。
• 通过自然语言描述定义事件，以跟踪智能体的问题、逻辑错误和自定义行为。
• 所有数据的 SQL 访问。文档 使用内置 SQL 编辑器查询追踪、指标和事件。通过查询批量创建数据集。可通过 API 使用。
• 使用内置 SQL 编辑器查询追踪、指标和事件。通过查询批量创建数据集。可通过 API 使用。
• 仪表板。文档 强大的仪表板构建器，支持追踪、指标和事件，并支持自定义 SQL 查询。
• 强大的仪表板构建器，支持追踪、指标和事件，并支持自定义 SQL 查询。
• 数据标注与数据集。文档 自定义数据渲染 UI，用于快速数据标注和评估数据集创建。
• 自定义数据渲染 UI，用于快速数据标注和评估数据集创建。
• 极高性能。采用 Rust 🦀 编写 用于实时查看追踪的自定义实时引擎。对 span 数据的超快速全文搜索。用于追踪数据的 gRPC 导出器。
• 采用 Rust 🦀 编写
• 用于实时查看追踪的自定义实时引擎。
• 对 span 数据的超快速全文搜索。
• 用于追踪数据的 gRPC 导出器。

文档

请在此处查看完整文档：laminar.sh/docs。

快速开始

开始使用的最快最简单方式是使用我们的托管平台 -> laminar.sh

使用 Docker Compose 自托管

Laminar 非常易于在本地自托管。如需快速开始，请克隆仓库并使用 docker compose 启动服务：

git clone https://github.com/lmnr-ai/lmnr
cd lmnr
docker compose up -d

这将启动一个轻量级但功能齐全的堆栈版本。适用于快速入门或轻量级使用。您可以在浏览器中通过 http://localhost:5667 访问 UI。

您还需要正确配置 SDK，设置 baseUrl 和正确的端口。请参阅自托管指南。

对于生产环境，我们建议使用我们的托管平台或运行 docker compose -f docker-compose-full.yml up -d。

启用 Signals 功能

要在自托管模式下启用 Signals / AI 监控，需在 .env 文件中设置 GOOGLE_GENERATIVE_AI_API_KEY 环境变量。此密钥同时被 app-server 和前端需要。

# 在仓库根目录的 .env 文件中
GOOGLE_GENERATIVE_AI_API_KEY=your_key_here

贡献

如需在本地运行和构建 Laminar，或了解更多关于 docker compose 文件的信息，请遵循贡献指南。

TypeScript 快速入门

首先，创建项目并生成项目 API 密钥。然后：

npm add @lmnr-ai/lmnr

这将安装 Laminar TS SDK 及所有 instrumentation 包（OpenAI、Anthropic、LangChain 等）。

要开始追踪 LLM 调用，只需添加：

import { Laminar } from '@lmnr-ai/lmnr';
Laminar.initialize({ projectApiKey: process.env.LMNR_PROJECT_API_KEY });

要追踪函数的输入/输出，请使用 observe 包装器。

import { OpenAI } from 'openai';
import { observe } from '@lmnr-ai/lmnr';

const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });

const poemWriter = observe({name: 'poemWriter'}, async (topic) => {
const response = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: `write a poem about ${topic}` }],
});
return response.choices[0].message.content;
});

await poemWriter();

Python 快速入门

首先，创建项目并生成项目 API 密钥。然后：

pip install --upgrade 'lmnr[all]'

这将安装 Laminar Python SDK 及所有 instrumentation 包。请在此处查看所有工具列表。

要开始追踪 LLM 调用，只需添加：

from lmnr import Laminar
Laminar.initialize(project_api_key=" ")

要追踪函数的输入/输出，请使用 @observe() 装饰器。

import os
from openai import OpenAI

from lmnr import observe, Laminar
Laminar.initialize(project_api_key=" ")

client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])

@observe() # 为所有要追踪的函数添加注解
def poem_writer(topic):
response = client.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "user", "content": f"write a poem about {topic}"},
],
)
poem = response.choices[0].message.content
return poem

if __name__ == "__main__":
print(poem_writer(topic="laminar flow"))

客户端库

要了解更多关于代码 instrumentation 的信息，请查看我们的客户端库：

---

项目仓库 README（补充）

Laminar

Laminar 是一个专为 AI 智能体构建的开源可观测性平台。

• 追踪。文档
• OpenTelemetry 原生的强大追踪 SDK - 仅需一行代码即可自动追踪 Vercel AI SDK、Browser Use、Stagehand、LangChain、OpenAI、Anthropic、Gemini 等。
• 评估。文档
• 无预设的、可扩展的 SDK 和 CLI，用于在本地或 CI/CD 管道中运行评估。
• 用于可视化评估和比较结果的 UI。
• AI 监控。文档
• 通过自然语言描述定义事件，以跟踪智能体的问题、逻辑错误和自定义行为。
• 所有数据的 SQL 访问。文档
• 使用内置 SQL 编辑器查询追踪、指标和事件。通过查询批量创建数据集。可通过 API 使用。
• 仪表板。文档
• 强大的仪表板构建器，支持追踪、指标和事件，并支持自定义 SQL 查询。
• 数据标注与数据集。文档
• 自定义数据渲染 UI，用于快速数据标注和评估数据集创建。
• 极高性能。
• 采用 Rust 🦀 编写
• 用于实时查看追踪的自定义实时引擎。
• 对 span 数据的超快速全文搜索。
• 用于追踪数据的 gRPC 导出器。

文档

请在此处查看完整文档：laminar.sh/docs。

快速开始

开始使用的最快最简单方式是使用我们的托管平台 -> laminar.sh

使用 Docker Compose 自托管

Laminar 非常易于在本地自托管。如需快速开始，请克隆仓库并使用 docker compose 启动服务：

git clone https://github.com/lmnr-ai/lmnr
cd lmnr
docker compose up -d

这将启动一个轻量级但功能齐全的堆栈版本。适用于快速入门或轻量级使用。您可以在浏览器中通过 http://localhost:5667 访问 UI。

您还需要正确配置 SDK，设置 baseUrl 和正确的端口。请参阅自托管指南。

对于生产环境，我们建议使用我们的托管平台或运行 docker compose -f docker-compose-full.yml up -d。

启用 Signals 功能

要在自托管模式下启用Signals / AI 监控，需在 .env 文件中设置 GOOGLE_GENERATIVE_AI_API_KEY 环境变量。此密钥同时被 app-server 和前端需要。

# 在仓库根目录的 .env 文件中
GOOGLE_GENERATIVE_AI_API_KEY=your_key_here

贡献

如需在本地运行和构建 Laminar，或了解更多关于 docker compose 文件的信息，请遵循贡献指南。

TypeScript 快速入门

首先，创建项目并生成项目 API 密钥。然后：

npm add @lmnr-ai/lmnr

这将安装 Laminar TS SDK 及所有 instrumentation 包（OpenAI、Anthropic、LangChain 等）。

要开始追踪 LLM 调用，只需添加：

import { Laminar } from '@lmnr-ai/lmnr';
Laminar.initialize({ projectApiKey: process.env.LMNR_PROJECT_API_KEY });

要追踪函数的输入/输出，请使用 observe 包装器。

import { OpenAI } from 'openai';
import { observe } from '@lmnr-ai/lmnr';

const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });

const poemWriter = observe({name: 'poemWriter'}, async (topic) => {
const response = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: `write a poem about ${topic}` }],
});
return response.choices[0].message.content;
});

await poemWriter();

Python 快速入门

首先，创建项目并生成项目 API 密钥。然后：

pip install --upgrade 'lmnr[all]'

这将安装 Laminar Python SDK 及所有 instrumentation 包。请在此处查看所有工具列表此处。

要开始追踪 LLM 调用，只需添加：

from lmnr import Laminar
Laminar.initialize(project_api_key=" ")

要追踪函数的输入/输出，请使用 @observe() 装饰器。

import os
from openai import OpenAI

from lmnr import observe, Laminar
Laminar.initialize(project_api_key=" ")

client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])

@observe() # 为所有要追踪的函数添加注解
def poem_writer(topic):
response = client.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "user", "content": f"write a poem about {topic}"},
],
)
poem = response.choices[0].message.content
return poem

if __name__ == "__main__":
print(poem_writer(topic="laminar flow"))

客户端库

要了解更多关于代码 instrumentation 的信息，请查看我们的客户端库：