> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

扣子罗盘观测支持自动上报平台上创建的 Prompt、 扣子智能体、扣子工作流和扣子 AI 应用的 Trace 数据。开发者可在扣子罗盘 Trace 中实时查看上报的数据。同时，支持与主流框架 (Eino、Langchain等)  集成，实现 Trace 数据一键上报，也支持灵活的自定义数据上报。
## 平台自动上报 {#9c34a2ba}
扣子罗盘会自动对平台上创建的 Prompt、扣子智能体、扣子工作流和扣子 AI 应用的用户请求自动上报。同时，支持在调试阶段就通过 Trace 能力查看各环节的执行情况，以便在调试阶段就能够发现问题进行调优。
如下图所示，在 扣子罗盘**观测 > Trace** 页面，能够快速筛选出平台 Prompt 开发、同一扣子账号与空间的扣子智能体和扣子 AI 应用的用户请求上报数据。
![Image=616x197](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/9eb4f5dad3b64a6c8cf59d1266894e8a~tplv-goo7wpa0wc-image.image)
## AI 框架集成上报 {#b806d838}
扣子罗盘支持与主流的 AI 框架集成，上报 Trace 数据到扣子罗盘。主要的集成方式及支持的 AI 框架如下：
:::tip 说明
对于暂未支持的 AI 框架，可通过 OpenTelemetry SDK 或罗盘 SDK 实现 Trace 数据上报，具体操作，请参考[通过 OpenTelemetry SDK 上报 Trace](/cozeloop/opentelemetry_sdk_trace_report)。
:::

* 基于 OpenTelemetry 协议集成 AI 框架
   * [Spring AI](/cozeloop/opentelemetry_spring_ai_trace_report)
   * [CrewAI](/cozeloop/crewai_trace_report)
   * [Google ADK](/cozeloop/google_adk_trace_report)
   * [OpenAI Agent](/cozeloop/openai_agent_trace_report)
   * [LlamaIndex](/cozeloop/llamaindex_trace_report)
   * [LiteLLM SDK](/cozeloop/litellm_sdk_trace_report)
   * [VeADK](/cozeloop/veadk_trace_report)
   * [Claude Agent SDK (Python)](/cozeloop/claude-agent-trace-report-python)
   * [AutoGen](/cozeloop/ccepfu6a)
   * [Pydantic AI](/cozeloop/bk96f0wr)
   * [Semantic Kernel](/cozeloop/h5xygmdt)
* 基于扣子罗盘 SDK 上报
   * [LangChain & LangGraph & DeepAgents](/cozeloop/langchain_langgraph_trace_report)
   * [Eino](/cozeloop/eino_trace_report)
   * [Instructor](/cozeloop/4pfm2qg4)
   * [扣子工作流](/cozeloop/coze_workflow_trace_report)
   * [扣子智能体](/cozeloop/coze_agent_trace_report)

## 网关集成上报 {#a8f08cc6}
扣子罗盘支持与 API 网关连接，实现 Trace 数据上报。例如通过扣子罗盘 SDK 提供的 OpenAI Client Wrapper 对接 [LiteLLM Proxy](https://docs.litellm.ai/docs/proxy/quick_start#quick-start---litellm-proxy--configyaml) 来调用 OpenAI 模型，并上报 Trace 数据。详情请参考 [LiteLLM Proxy](/cozeloop/litellm_proxy_native_trace_report)。
## 模型提供商直接上报 {#33bd508a}
扣子罗盘支持与 AI 模型提供商直接集成，上报 Trace 数据。例如通过扣子罗盘 SDK 提供的 OpenAI Client Wrapper 将 OpenAI 模型调用过程的 Trace 数据自动上报到扣子罗盘。详情请参考[OpenAI Chat & Responses](/cozeloop/openai_chat_trace_report)。
## SDK 上报 {#78302fd9}
扣子罗盘支持与 Eino、Langchain 主流框架集成，提供了不同语言的 SDK，可追踪文本和图像数据。此外，扣子罗盘 SDK 支持  Low-Level API，自定义上报 Trace 数据。
你可以参考以下 SDK 使用说明，进行数据上报：
<!-- @cols-width: 161,179,250 -->
| | | | \
|**开发语言** |**参考文档** |**配置示例** |
|---|---|---|
| | | | \
|Go SDK |[快速开始](/cozeloop/python-sdk) |* [Eino ](/cozeloop/go-sdk#4a8c980e) |\
| | |* [Low-Level API](/cozeloop/go-sdk#78d5856e) |
| | | | \
|Python SDK |[快速开始](/cozeloop/python-sdk) |* [Langchain ](/cozeloop/python-sdk#b89b9e44) |\
| | |* [Low-Level API](/cozeloop/python-sdk#d1787f13) |
| | | | \
|Node.js SDK |[快速开始](/cozeloop/quick-start-nodejs) |[Trace 上报](/cozeloop/quick-start-nodejs#947a9e15) |

## 基于 OpenTelemetry 协议上报 {#dee5e806}
[OpenTelemetry](https://opentelemetry.io/)（OTel）是一个开源的、具备厂商中立性的可观测性框架。它提供了一组规范、API 和库，基于特定结构化数据建模，以输出应用程序的分布式追踪（Trace）、指标（Metrics）和日志（Log）数据。
扣子罗盘支持接收来自 OpenTelemetry 客户端上报的 Trace 数据并可视化展示，从而实现对应用程序的深度监控和分析。
![Image=1888x275](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f47184b702d6453f8b797eedd382d049~tplv-goo7wpa0wc-image.image)
目前，支持如下两种上报方式：

* 通过 OpenTelemetry SDK 将 Trace 数据上报到扣子罗盘。具体操作，请参考[通过 OpenTelemetry SDK 上报 Trace](/cozeloop/opentelemetry_sdk_trace_report)。
* 通过适配 OpenTelemetry 协议的 AI 框架自动上报 Trace。例如通过 Spring AI 与 OpenTelemetry 的集成，将 Trace 数据上报到扣子罗盘。