如何用OpenLIT一行代码为AI开发实现全栈可观测性并支持LLM、向量数据库和GPU成本追踪?2026年方案
AIAI Summary (BLUF)
OpenLIT 以一行代码实现基于OpenTelemetry的原生可观测性,简化AI开发,支持大语言模型、向量数据库与GPU监控,并集成成本追踪与评估功能。
Introduction
OpenLIT 能够简化你的 AI 开发工作流,尤其适用于生成式 AI 和大语言模型(LLM)。它优化了诸如使用 LLM 进行实验、组织和版本化管理提示词以及安全处理 API 密钥等关键任务。仅需一行代码,你便可开启基于 OpenTelemetry 的原生可观测性,提供涵盖 LLM、向量数据库和 GPU 的全栈监控。这让开发者能够自信地构建 AI 功能和应用程序,并平稳地从测试过渡到生产。
该项目自豪地遵循并维护着与 OpenTelemetry 社区一致的语义约定,并持续更新以符合可观测性领域的最新标准。
Core Features
OpenLIT 提供了一整套专为现代 AI 应用程序可观测性和管理而设计的功能。下表将核心能力映射到具体的使用场景及支持的 SDK。
| Feature Category | Key Capabilities | Supported SDKs |
|---|---|---|
| 📈 Observability Dashboard | Monitor health, performance, metrics, costs, and user interactions. | Python, TypeScript, Go |
| 🔌 OpenTelemetry SDKs | Vendor-neutral SDKs for sending traces and metrics to existing tools. | Python, TypeScript, Go |
| 🛡️ Built-in Evaluations | 11 types (hallucination, bias, toxicity, safety, etc.) with context-aware detection. | Python, TypeScript, Go |
| ⚙️ Rule Engine | Define conditional AND/OR rules to match runtime trace attributes for dynamic configs. | Python, TypeScript, Go |
| 💲 Cost Tracking | Custom pricing files for precise cost estimation of fine-tuned or custom models. | Python, TypeScript, Go |
| 🐛 Exception Dashboard | Dedicated dashboard to track and resolve common exceptions and errors. | Python, TypeScript, Go |
| 💭 Prompt Management | Version and manage prompts centrally via Prompt Hub. | Python, TypeScript, Go |
| 🔑 Secrets Management | Centralized, secure handling of API keys and secrets. | Python, TypeScript, Go |
| 🎮 LLM Experimentation | Compare and test various LLMs side-by-side using OpenGround. | Python, TypeScript, Go |
| 🚀 Fleet Hub (OpAMP) | Centrally manage OpenTelemetry Collectors using OpAMP with TLS. | Python, TypeScript, Go |
Architecture Overview
以下流程图展示了 OpenLIT 生态系统中的核心数据流向。
flowchart TB;
subgraph " "
direction LR;
subgraph " "
direction LR;
OpenLIT_SDK[OpenLIT SDK] -->|Sends Traces & Metrics| OTC[OpenTelemetry Collector];
OTC -->|Stores Data| ClickHouseDB[ClickHouse];
end
subgraph " "
direction RL;
OpenLIT_UI[OpenLIT] -->|Pulls Data| ClickHouseDB;
end
end
SDK 将遥测数据发送至 OpenTelemetry Collector,再由 Collector 将数据存储至 ClickHouse。OpenLIT UI 从 ClickHouse 拉取数据以进行可视化和分析。
Getting Started with LLM Observability
Step 1: Deploy the OpenLIT Stack
- Clone the Repository
克隆仓库
```bash
git clone git@github.com:openlit/openlit.git
```
- Self-Host Using Docker
使用 Docker 自行托管
Deploy and run OpenLIT with:
```bash
docker compose up -d
```
Note: For Kubernetes installation using Helm, refer to the Kubernetes Helm installation guide.
注意:如需在 Kubernetes 中使用 Helm 进行安装,请参阅 Kubernetes Helm 安装指南。
Step 2: Install the OpenLIT SDK
打开命令行或终端并运行:
pip install openlit
Note: For TypeScript SDK usage, visit the TypeScript SDK Installation guide.
注意:如需使用 TypeScript SDK,请访问 TypeScript SDK 安装指南。
Step 3: Initialize OpenLIT in Your Application
将以下代码行添加至你的 AI 应用程序中,以集成 OpenLIT。
import openlit
openlit.init()
使用以下参数配置遥测数据的目标地址:
| Purpose | Parameter / Environment Variable | For Sending to OpenLIT |
|---|---|---|
| Send data to an HTTP OTLP endpoint | otlp_endpoint or OTEL_EXPORTER_OTLP_ENDPOINT |
"http://127.0.0.1:4318" |
| Authenticate telemetry backends | otlp_headers or OTEL_EXPORTER_OTLP_HEADERS |
Not required by default |
💡 Info: If otlp_endpoint or OTEL_EXPORTER_OTLP_ENDPOINT is not provided, the SDK outputs traces directly to the console—recommended during development.
💡 信息:如果未提供 otlp_endpoint 或 OTEL_EXPORTER_OTLP_ENDPOINT,SDK 将直接将链路追踪信息输出至控制台——推荐在开发阶段使用。
Example: Initialize Using Function Arguments
示例:使用函数参数进行初始化
import openlit
openlit.init(
otlp_endpoint="http://127.0.0.1:4318",
)
Example: Initialize Using Environment Variables
示例:使用环境变量进行初始化
import openlit
openlit.init()
然后通过环境变量配置 OTLP 端点:
export OTEL_EXPORTER_OTLP_ENDPOINT = "http://127.0.0.1:4318"
Step 4: Visualize and Optimize
随着可观测性数据被收集并发送至 OpenLIT,下一步是可视化和分析这些数据。在浏览器中访问 127.0.0.1:3000 以进入 OpenLIT UI,使用以下默认凭据登录:
- Email:
user@openlit.io - Password:
openlituser
Supported Integrations
OpenLIT 通过单行代码自动检测 50 多个 LLM 提供商、AI 框架和向量数据库。每次集成都会生成基于 OpenTelemetry 原生标准的链路追踪和指标。
| Integration Type | Key Supported Tools | Language Support |
|---|---|---|
| LLM Providers | OpenAI, Anthropic, Cohere, Hugging Face, Mistral AI, etc. | Python, TypeScript, Go |
| Vector Databases | Pinecone, Weaviate, Chroma, Qdrant, Milvus, etc. | Python, TypeScript |
| AI Frameworks | LangChain, LlamaIndex, Haystack, etc. | Python, TypeScript |
| Others | Custom models, fine-tuned models, OpAMP Fleet Hub | All supported languages |
常见问题(FAQ)
如何在应用中快速集成OpenLIT进行LLM可观测性?
只需一行代码安装OpenLIT SDK并初始化,即可自动发送OpenTelemetry原生遥测数据,实现LLM、向量数据库和GPU的监控。
OpenLIT支持哪些监控功能?
支持核心指标监控、成本追踪、内置11种评估(如幻觉、偏见)、异常仪表板、提示管理和秘密管理等。
OpenLIT的架构和数据流是怎样的?
版权与免责声明:本文仅用于信息分享与交流,不构成任何形式的法律、投资、医疗或其他专业建议,也不构成对任何结果的承诺或保证。
文中提及的商标、品牌、Logo、产品名称及相关图片/素材,其权利归各自合法权利人所有。本站内容可能基于公开资料整理,亦可能使用 AI 辅助生成或润色;我们尽力确保准确与合规,但不保证完整性、时效性与适用性,请读者自行甄别并以官方信息为准。
若本文内容或素材涉嫌侵权、隐私不当或存在错误,请相关权利人/当事人联系本站,我们将及时核实并采取删除、修正或下架等处理措施。也请勿在评论或联系信息中提交身份证号、手机号、住址等个人敏感信息。



