本章节介绍日志服务应用市场提供的大模型观测日志应用 Eino 可观测。 ## 概述 Eino 是旨在提供基于 Go 语言的终极大模型应用开发框架，提供了一个强调简洁性、可扩展性、可靠性与有效性，且更符合 Go 语言编程惯例的 LLM 应用开发框架。更多详细信息，请参考 [Eino 官方文档](https://www.cloudwego.io/zh/docs/eino/overview/)。通过接入 Eino 可观测日志应用，自动在日志服务创建 Eino 专用 Trace 日志主题，生成可视化图表并展示会话、Trace、Token 与工具调用数据，实现链路追踪和可观测性。可用于如下场景： |可观测性 |说明 | |---|---| |性能分析 |* 模型调用延迟分布

* Tool 执行时间排行

* Token 消耗趋势 | |错误追踪 |* 查看完整的调用链路

* 定位出错的环节

* 分析错误原因 | |成本优化 |* 识别高消耗的对话

* 优化 Prompt 减少 Token

* 选择更经济的模型 | ## 前提条件 |类别 |说明 | |---|---| |软件限制 |部署 Eino 的服务器需已安装 NPM、Node.js 22 及以后版本。 | |地域限制 |部署 Eino 的服务器与日志服务为同一地域（Region），确保网络连通。 | |鉴权方式 |根据不同的鉴权方式，获取用户 Access Key ID、Secret Access Key 或 APIKey。

* AK/SK：火山引擎账号的 AccessKey ID、AccessKey Secret。

* 在火山引擎控制台[密钥管理页面](https://console.volcengine.com/iam/keymanage/)获取。推荐使用 IAM 用户密钥，请确认该用户具备相关的操作权限，详情可参考[IAM 概述](https://docs.volcengine.com/docs/6470/103036)。

* 支持自动创建日志服务资源（Project/App/Topic），并自动生成日志主题 ID。

* API Key：请求火山日志服务的重要凭证，仅用于 Log、Metric、Trace 的数据上报。

* 严格收敛权限、不支持自动创建日志服务资源。

* 适合多机房与权限管控严格场景。

说明

API Key 为邀测功能，若有相关业务需求，可联系客户经理开通白名单。

| ## 一接入 Eino 日志应用 1. 登录[日志服务控制台](https://console.volcengine.com/tls/)。 2. 在顶部导航栏中，选择日志服务所在的地域。 3. 在左侧导航栏中，选择 **AgentLoop** \> **AI观测**。 4. 在 **AI 观测**页面，单击**接入 AI 观测**。 5. 在**接入 AI 观测**页面，创建应用。 1. 单击 Eino 图表，选中 Eino 应用。 2. 选择接入日志应用的地域和日志项目，配置接入应用名称和描述信息，然后单击**创建应用**。

说明

Eino 日志应用创建成功后，将会在该日志项目中，自动创建携带Eino标签的，名为应用名称_trace的日志主题，用于存放 trace 数据。该日志主题相关信息如下：

分区数量：2

日志存储时长：标准存储 90 天

索引：自动配置键值索引。

6. 创建应用后，执行下一步获取使用指引，并接入日志应用。 ## 二接入 Eino 应用数据 1. 获取接入 Eino 应用数据的使用指引。 1. 进入**接入配置**页面。接入日志应用时在 AgentLoop 中创建 Eino 日志应用时，可根据界面提示获取对应的使用指引。 1. 参考[一接入 Eino 日志应用](https://docs.volcengine.com/docs/6470/2678879#c972c898)，接入 Eino 日志应用。 2. 在**接入 AI 观测**页面的**接入配置**中，配置如下信息，获取使用指引。接入日志应用后 1. 登录[日志服务控制台](https://console.volcengine.com/tls/)。 2. 在顶部导航栏中，选择日志服务所在的地域。 3. 在左侧导航栏中，选择 **AgentLoop** \> **AI观测**。 4. 在 **AI 观测**页面，通过如下方式进入获取使用指引页面。 * 单击目标日志应用**操作**列的接入配置图标。 * 单击目标日志应用名称，单击**接入管理。** 2. 在**接入配置**页面，选择鉴权方式，配置如下信息，获取使用指引。 AK/SK 接入 1. **接入方式**选择 **AK SK 接入**。 2. **连接方式**根据实际情况，选择**公网**或**火山引擎内网**。 3. 在**使用指引**中，复制自动生成的使用指引。 API Key 接入 1. **接入方式**选择 **API Key 接入**。 2. **连接方式**根据实际情况，选择**公网**或**火山引擎内网**。 3. **API Key** 选择已创建的 API Key。 4. 在**使用指引**中，复制自动生成的使用指引。使用指引示例（AK/SK 接入方式）：公网 ```Bash ### AK/SK 接入 ```bash export TLS_EXPORTER_ENABLED=true export TLS_APP_NAME=Eino export TLS_LOG_ENDPOINT=系统自动填充当前endpoint export TLS_LOG_REGION=系统自动填充当前地域 export TLS_LOG_TRACE_TOPIC_ID=系统自动填充 trace-topic-id export TLS_LOG_AK=<需手动替换实际 AccessKeyID> export TLS_LOG_SK=<需手动替换实际 SecretAccessKey> ``` 配置凭证后，在 Eino 初始化时注册 TLS 回调： ```go handler, shutdown, err := tls.NewTLSHandler() if err != nil { panic(err) } defer shutdown(context.Background()) callbacks.AppendGlobalHandlers(handler) ``` ``` 火山引擎内网 ```Bash ### AK/SK 接入 ```bash export TLS_EXPORTER_ENABLED=true export TLS_APP_NAME=Eino export TLS_LOG_ENDPOINT=https://tls-cn-guilin-boe.volces.com # 火山引擎内网环境使用内网接入点。 export TLS_LOG_ENDPOINT=系统自动填充当前endpoint export TLS_LOG_REGION=系统自动填充当前地域 export TLS_LOG_TRACE_TOPIC_ID=系统自动填充 trace-topic-id export TLS_LOG_AK=<需手动替换实际 AccessKeyID> export TLS_LOG_SK=<需手动替换实际 SecretAccessKey> ``` 配置凭证后，在 Eino 初始化时注册 TLS 回调： ```go handler, shutdown, err := tls.NewTLSHandler() if err != nil { panic(err) } defer shutdown(context.Background()) callbacks.AppendGlobalHandlers(handler) ``` ``` 2. （仅AK/SK方式）修改使用指引中的鉴权信息。将已获取的 Access Key ID、Secret Access Key 分别填入使用指引的 AK，SK 中。 3. 将 Eino 观测日志接入至日志应用。 1. 登录部署 Eino 的服务器。 2. 执行使用指引中获取的信息，安装日志服务插件。 3. 插件安装完成后，重启 Eino 服务。 4. 返回日志服务控制台，查看可观测图表数据。 ## 监控图表详情日志服务 Eino 应用观测监控图表详情如下： |类型 |图表 | |---|---| |总览 |*

Eino 请求总览：

会话个数、对话个数、模型请求数、工具调用次数、请求趋势

Eino 成本总览：

总 Tokens、输入 Tokens、输出 Tokens、Cache Read Tokens、Reasoning Tokens、Token 消耗趋势、模型调用趋势

Eino 工具总览

调用成功次数、调用失败次数、工具调用耗时 P90、工具调用 Top10、工具调用失败 Top10、工具调用趋势

Eino 模型性能总览

模型调用分布 Top 10、模型调用耗时 P90、Provider 调用分布、Provider 调用耗时 P90

| |Trace 分析 |*

Eino Trace 分析总览

总 Trace 数、总 Token 消耗、平均 Token、耗时 P90

Eino 调用链分析

展示指定调用链的 Trace ID、状态、总耗时 (ms)、TotalTokens、开始时间、结束时间。

Eino Token 消耗

总 Tokens、输入 Tokens、输出 Tokens、Cache Read Tokens、Reasoning Tokens、输入Tokens(除Cache)、会话Token消耗Top 10、模型Token消耗Top 10、Token分类占比

| |Topic 列表 |展示当前日志应用产生的日志类型、日志项目和日志主题及描述信息等。 | ## 管理我的应用日志应用接入成功后，支持对已接入的日志应用进行相关管理操作： AgentLoop 1. 登录[日志服务控制台](https://console.volcengine.com/tls/)。 2. 在顶部导航栏中，选择日志服务所在的地域。 3. 在左侧导航栏中，选择 **AgentLoop** \> **AI观测**。 4. 在 **AI 观测**页面，在对应日志应用的**操作**列，支持如下管理操作： * 修改应用信息：单击编辑图标，可修改应用名称和描述信息。 * 获取使用指引：单击接入配置图标，进入接入配置弹窗，可获取使用指引示例信息。 * 删除我的应用：单击删除图标，可删除该日志应用。应用市场 1. 登录[日志服务控制台](https://console.volcengine.com/tls/)。 2. 在顶部导航栏中，选择日志服务所在的地域。 3. 在左侧导航栏中，选择**常用功能** \> **日志应用**。 4. 进入**我的应用**页签，在对应日志应用的**操作**列，支持如下管理操作： * 接入管理：单击**接入管理**，进入**接入管理**页签，支持修改接入的日志应用名称、描述信息，以及获取使用指引示例信息。 * 取消接入：单击**取消接入**，在取消接入弹窗中确认信息，再次单击**取消接入**。 ## `应用名称_trace`（日志主题）日志字段 |字段 |类型 |说明 | |---|---|---| |Attributes |json |Span 上挂载的自定义键值对，记录业务相关信息。 | |Duration |long |Span 持续时长（End \- Start），衡量该操作的耗时。 | |End |long |Span 结束时间。 | |Events |text |Span 生命周期内发生的事件。 | |Host |text |运行服务的主机。 | |Kind |text |Span 的类型。 | |Links |text |关联其他 Span 的引用（用于跨 Trace 关联，比如异步任务场景）。 | |Name |text |Span 的名称，通常是操作描述。 | |OTLPName |text |通过 OTLP 协议上报时的原始名称（OTLP = OpenTelemetry Line Protocol）。 | |OTLPVersion |text |使用的 OTLP 协议版本号。 | |ParentSpanID |text |父 Span 的 ID，表示当前操作是被哪个操作触发的，根节点此字段为空。 | |Resource |json |一组描述服务本身的属性集合（比 ServiceName 更全），如服务名、版本、运行环境等。 | |ServiceName |text |产生这条 Span 的服务名称。 | |SpanID |text |当前 Span 的唯一 ID。 | |Start |long |Span 开始时间。 | |StatusCode |text |Span 的执行结果。 | |StatusDescription |text |Span 的执行结果的补充说明。 | |TracelD |text |整条调用链的 TracelD，同一次请求的所有 Span 共享同一个 TraceID。 | |TraceState |text |自定义的追踪上下文元数据。 | Attributes |字段 |类型 |说明 | |---|---|---| |gen_ai.input.messages |text |发给模型的完整输入消息列表。 | |gen_ai.provider.name |text |模型服务商名称。 | |gen_ai.request.model |text |请求指定的模型名。 | |gen_ai.tool.name |text |本次调用涉及的工具名称。 | |gen_ai.usage.cache_read.input_tokens |long |命中 KV Cache 的输入 Token 数。 | |gen_ai.usage.input_tokens |long |本次请求消耗的输入 Token 数。 | |gen_ai.usage.output_tokens |long |本次请求消耗的输出 Token 数。 | |gen_ai.usage.reasoning.output_tokens |long |Reasoning 消耗的输出 Token 数。 | |gen_ai.usage.total_tokens |long |总 Token 数。 | |session.id |text |当前会话的 Session ID。 | |session.name |text |当前会话的 Session名称。 | |tls.app.type |text |应用类型标识，表明这个 Span 属于哪种日志应用形态。 | |tls.plugin.version |text |Eino 可观测插件的版本号。 | |tool.error |text |工具执行失败时的错误信息。 |