查看器¶
应用创建并接入数据后，您可以在查看器中搜索、筛选和分析 Agent / LLM 数据。Agent 状态提供 User、Session、Trace 和 Span 视角，可从用户使用情况逐步下钻到单次执行步骤，也可跨调用比较 Span 的耗时与错误情况。
页面顶部支持 Agent / LLM 状态切换，默认进入 Agent 状态。
Agent 状态¶
Agent 状态下，页面顶部展示两个筛选框：
- Agent 类型：筛选全部 Agent 类型或指定某一类型；
- 实例：筛选该 Agent 类型下的具体实例，支持搜索实例名称。选择具体 Agent 类型后，实例筛选仅展示该类型下的实例；未选择 Agent 类型时，实例筛选默认为全部实例但不可选。
LLM 状态¶
切换至 LLM 状态，页面顶部展示应用筛选控件，可选择全部应用或指定某一 LLM 应用进行查看。
查看模式¶
独立 Agent 查看器的视角依次为 User、Session、Trace、Span。切换视角时，保留时间范围、Agent 类型、实例及适用于目标视角的查询条件。
User 列表¶
Agent 总查看器支持按 User 维度跨 Agent 类型汇总数据。单个 Agent 类型详情页也提供 User Tab，用于查看该类型下的 User 使用情况。
对于 Agent Teams 数据，User 维度会关联工作空间成员，同时展示用户名，便于识别对应用户。
Agent 类型详情页包含以下一级 Tab：
Session 列表¶
默认展示 Session 维度数据，列表字段包括 Session ID、输入 Token、输出 Token、风险事件数和告警等级。左侧快捷筛选支持按 Token 区间、模型提供方、请求模型、响应模型等维度过滤。支持列表、排行榜、时序图、饼图、矩形树图、分组表格图等多种分析视图。
- 风险事件数：当前 Session 中检测到的风险事件总数；
- 告警等级：当前 Session 下风险事件的最高告警等级；没有风险事件时显示为无风险状态。
点击某一行进入 Session 详情页：
- 概览：左侧展示 Session Trace 瀑布图，右侧展示预览、属性信息和当前 Session 的告警等级；
- 调用分析：展示模型调用占比、Tool 执行占比和 Skill 执行占比，以及当前 Session 关联的 Trace 和风险事件。风险事件展示告警等级、关联操作和发生时间等信息。
Trace 列表¶
切换至 Trace 列表 Tab，按 Trace 维度查看数据。列表字段包括 Trace ID、所属 Session、Trace 耗时、输入 Token、输出 Token、Trace 状态、风险操作数和告警等级。
- 风险操作数：当前 Trace 中被标记为危险操作的数量；
- 告警等级：当前 Trace 下所有风险操作中的最高告警等级。
点击某一行进入 Trace 详情页：
- 概览：通过瀑布图展示 Trace 调用过程，并展示当前 Trace 的告警等级；下方展示 Span 详情；
- 调用分析：展示 Tool 和 Skill 调用记录。危险操作会显示风险标识，相关 Tool、Skill 和其他操作信息中同时展示风险等级。
Span 列表¶
Span 表示 Agent 执行过程中的单个操作，例如模型调用或工具执行。切换至 Span 视图，可查询当前工作空间内、选定时间范围及筛选条件下的 Agent Span，比较不同 Trace 中的执行步骤。
列表包含根 Span 和子 Span，同一 Trace 中的多个 Span 分别展示。只有指定 Trace ID 条件或从某条 Trace 下钻时，查询才限定于该调用。可查询的数据受采集情况、保留期和当前用户权限限制。
查询与分析¶
- 选择 Agent 类型、实例和时间范围；
- 通过搜索和快捷筛选定位需要分析的 Span，并按需调整显示列和排序；
- 按 Span 名称、操作类型、模型或工具等可用字段分组，通过排行榜和时序图比较耗时与错误情况；
- 点击 Span 记录，查看其执行信息及所属 Trace 的上下文。
列表、排行和趋势使用相同的时间范围、权限及筛选条件。聚合结果基于全部匹配数据计算，不仅统计当前已加载的列表页；若结果存在采样或截断，请结合页面提示判断统计范围。Span 与 Trace 视图分别保存显示列、排序等配置。
| 指标或信息 | 说明 |
|---|---|
| Span 数 | 查询范围内匹配的 Span 记录数 |
| Trace 数 | 匹配 Span 所属 Trace 的去重数量 |
| 错误 Span 数 | 明确标记为执行错误的 Span 数；缺少状态时不推断为成功或错误 |
| 错误率 | 错误 Span 数除以全部匹配 Span 数；分母为零时显示无数据 |
| 耗时 | 支持平均值、P50、P95 等统计；嵌套或并行 Span 的耗时相加不代表 Trace 总耗时 |
| 输入和输出 Token | 列表展示当前 Span 自身上报的用量；未上报时显示无数据，与真实零值区分 |
可用字段取决于 Agent 实际上报的数据。Token 聚合仅统计承载实际用量的模型调用 Span，避免重复累计父节点汇总值与子节点用量；积分与 Token 分开统计，具体聚合能力以当前运行时支持情况为准。执行错误与风险事件分别展示，Trace 级风险数不作为每条 Span 的风险数。
查看调用上下文¶
点击 Span 记录后，详情默认定位并选中该 Span，可查看属性、输入、输出及执行信息，并继续分析所属 Trace 的调用过程。返回列表时保留原有时间、筛选、排序和分析状态。
所属 Trace 不完整或已超出保留期时，仍可查看当前可读取的 Span，并根据页面提示了解缺失的上下文。
详情页¶
进入详情页，左侧展示由应用产生的单条 Span 及 Trace，右侧展示对应预览及属性信息。
从 Span 列表进入时，详情默认选中所点击的 Span，可继续查看其所属 Trace 的调用上下文。
风险告警¶
系统根据 Agent 执行过程中产生的风险事件，对 Session、Trace、Tool、Skill 等对象进行风险标记。
风险告警信息可能出现在以下位置：
| 位置 | 展示内容 |
|---|---|
| Session 列表 | 风险事件数、告警等级 |
| Session 概览 | 当前 Session 的告警等级 |
| Session 调用分析 | 风险事件及关联 Trace |
| Trace 列表 | 风险操作数、告警等级 |
| Trace 概览 | 当前 Trace 的告警等级 |
| Trace 详情 | 危险操作标识，以及 Tool、Skill 等操作的风险等级 |
Session 或 Trace 包含多个风险事件时，列表和概览展示其中的最高告警等级。可在调用分析的风险事件中点击具体风险事件或危险操作，可跳转至安全监测查看详情。
相关操作¶
- 基于节点名
source进行搜索定位； - 选择是否显示指标和评分。
什么是指标和评分？
- 指标：
duration时间展示 - 评分：模型质量评估分值、描述等信息
预览¶
包括节点类型、节点名称、执行耗时、Token 消耗、执行状态、执行详情。
状态展示¶
执行状态（status） |
可能产生原因 |
|---|---|
| 成功：Success | |
| 失败：Error | Agent / LLM 调用超时、工具返回异常等 |
| 警告：Warning | 输出内容触发敏感词检测但未中断执行等 |
执行详情¶
展示应用中的 Input（输入）和 Output（输出），前者包含了所有用于构建最终发送给模型请求的要素，后者则展示根据输入生成的结果。
对于通过 LangChain OpenTelemetry 接入的数据，系统会将 gen_ai 相关属性解析为 Input、Output 和 Token 信息。若原始数据未提供对应属性，页面显示为空。
属性信息¶
当前 Span 或 Trace 包含的相关字段信息。
关联视图¶
通过右上角的 + 按钮，您可以将内置视图绑定到当前详情页，实现 Agent / LLM 数据的专项展示。
- 点击添加按钮；
- 选择关联字段
- 在弹出的绑定内置视图面板中，选择需要关联的视图；
- 绑定成功后，新增的标签页将显示在标签栏中。
更多阅读¶
您可能对以下内容感兴趣：