查询trace列表 -j9九游会登录
功能介绍
该接口用于分页查询调用链列表。
调用方法
请参见如何调用api。
授权信息
账号根用户具备所有api的调用权限,如果使用账号下的iam用户调用当前api,该iam用户需具备如下身份策略权限,更多的权限说明请参见。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts::listopstrace | list | - | - | - |
|
uri
post /v1/ops/observation/traces
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| start_time | 否 | long | 参数解释: 开始时间,用于指定查询时间范围的起始时间点。 约束限制: 必须为有效的unix时间戳,且不大于end_time。 取值范围: unix时间戳,单位为ms。 默认取值: 不涉及。 |
| end_time | 否 | long | 参数解释: 截止时间,用于指定查询时间范围的结束时间点。 约束限制: 必须为有效的unix时间戳,且不小于start_time。 取值范围: unix时间戳,单位为ms。 默认取值: 不涉及。 |
| resource_id | 否 | string | 参数解释: 应用id,用于筛选指定应用的调用链数据。 约束限制: 长度限制为1-64位。 取值范围: 不涉及。 默认取值: 不涉及。 |
| resource_type | 否 | string | 参数解释: 资源类型,用于筛选指定类型的资源调用链数据。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
| trace_id | 否 | string | 参数解释: 调用链id,用于精确查询指定的调用链数据。 约束限制: 长度限制为1-64位。 取值范围: 不涉及。 默认取值: 不涉及。 |
| status_code | 否 | string | 参数解释: 状态码,用于筛选指定状态的调用链数据。 约束限制: 长度限制为1-64位。 取值范围: 不涉及。 默认取值: 不涉及。 |
| session_id | 否 | string | 参数解释: 会话id,用于筛选指定会话的调用链数据。 约束限制: 长度限制为1-64位。 取值范围: 不涉及。 默认取值: 不涉及。 |
| span_type | 否 | string | 参数解释: span类型,用于筛选指定类型的span数据。 约束限制: 长度限制为1-64位。 取值范围: 不涉及。 默认取值: 不涉及。 |
| input | 否 | string | 参数解释: span的输入内容,用于模糊匹配筛选调用链数据。 约束限制: 长度限制为1-64位。 取值范围: 不涉及。 默认取值: 不涉及。 |
| output | 否 | string | 参数解释: span的输出内容,用于模糊匹配筛选调用链数据。 约束限制: 长度限制为1-64位。 取值范围: 不涉及。 默认取值: 不涉及。 |
| like | 否 | integer | 参数解释: 评价状态,用于筛选已评价或未评价的调用链数据。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
| label | 否 | map | 参数解释: 标注的过滤条件,用于筛选带有特定标签的调用链数据。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。map说明:key为标签名称,value为标签值。 |
| page_no | 否 | integer | 参数解释: 页码,用于分页查询,指定返回第几页的数据。 约束限制: 必须为正整数。 取值范围: 大于等于1的整数。 默认取值: 1。 |
| page_size | 否 | integer | 参数解释: 每页条数,用于分页查询,指定每页返回的数据条数。 约束限制: 必须为正整数。 取值范围: 1-100。 默认取值: 10。 |
| filter_sign | 否 | string | 参数解释: 连接标识,用于标明查询语句中条件之间且或者或的关系。 约束限制: 长度限制为1-64位。 取值范围: 不涉及。 默认取值: 不涉及。 |
| label_filter | 否 | array of filterparam objects | 参数解释: 标签过滤条件,用于按标签筛选调用链数据,支持多个条件的组合查询。 约束限制: 不涉及。 |
| filter | 否 | array of listfilterparam objects | 参数解释: 过滤条件,用于多条件组合筛选调用链数据。 约束限制: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| label_name | 否 | string | 参数解释: 标签名。 约束限制: 长度限制1-64位。 取值范围: 不涉及。 默认取值: 不涉及。 |
| label_value | 否 | string | 参数解释: 标签值。 约束限制: 长度限制1-128位。 取值范围: 不涉及。 默认取值: 不涉及。 |
| operator | 否 | string | 参数解释: 操作类型。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| name | 否 | string | 参数解释: 过滤名,指定要过滤的字段名称,如resource_id、resource_type等。 约束限制: 长度限制为1-64位。 取值范围: 不涉及。 默认取值: 不涉及。 |
| value | 否 | string | 参数解释: 过滤值,指定要过滤的字段值,需与name字段配合使用。 约束限制: 长度限制为1-64位。 取值范围: 根据name字段确定。 默认取值: 不涉及。 |
| operator | 否 | string | 参数解释: 操作类型。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total | integer | 参数解释: 总数。 取值范围: 不涉及。 |
| span_list | array of spaninfo objects | 参数解释: span列表,包含查询到的所有span数据。 取值范围: 数组中的每个元素为spaninfo对象。" |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| trace_id | string | 参数解释: 调用链id,唯一标识一次完整的调用链。 取值范围: 由系统生成的唯一标识字符串。 |
| parent_span_id | string | 参数解释: 父节点spanid,标识当前span的父节点。 取值范围: spanid字符串或null(根节点)。" |
| span_id | string | 参数解释: spanid,唯一标识当前span。 取值范围: 由系统生成的唯一标识字符串。 |
| span_type | string | 参数解释: span类型,标识当前span所属的类型。 取值范围: 不涉及。 |
| span_name | string | 参数解释: span名称,标识当前span的操作名称。 取值范围: 不涉及。 |
| status_code | string | 参数解释: 状态码,标识当前span的执行状态。 取值范围: 不涉及。 |
| status_message | string | 状态信息 |
| input | string | 参数解释: 输入。 取值范围: 不涉及。 |
| output | string | 参数解释: 输出。 取值范围: 不涉及。 |
| duration | integer | 参数解释: 耗时,当前span的执行时长。 取值范围: 大于等于0的整数,单位为ms。 |
| session_id | string | 参数解释: 会话id。 取值范围: 不涉及。 |
| tokens | integer | 参数解释: tokens消耗,当前span消耗的总token数量。 取值范围: 大于等于0的整数,单位为个。 |
| input_tokens | integer | 参数解释: input tokens消耗,当前span输入部分消耗的token数量。 取值范围: 大于等于0的整数,单位为个。 |
| output_tokens | integer | 参数解释: output tokens消耗,当前span输出部分消耗的token数量。 取值范围: 不涉及。 |
| start_time | long | 参数解释: 开始时间,当前span开始执行的时间戳。 取值范围: unix时间戳,单位为ms。 |
| call_type | string | 参数解释: 触发类型。 取值范围: 不涉及。 |
| metadata | string | 参数解释: 元数据。 取值范围: 不涉及。 |
| feedback_operation | string | 参数解释: 评价状态,标识当前span的用户评价。 取值范围:
|
| label | array of label objects | 参数解释: 标签组,当前span关联的所有标签信息。 |
| resource_id | string | 参数解释: 应用id,当前span所属应用的唯一标识。 取值范围: 应用id字符串。 |
| resource_name | string | 参数解释: 应用名称,当前span所属应用的名称。 取值范围: 不涉及。 |
| resource_type | string | 参数解释: 应用类型,当前span所属应用的类型。 取值范围:
|
| model_name | string | 参数解释: 模型名称,当前span使用的模型名称。 取值范围: 不涉及。 |
| is_error | boolean | 参数解释: 是否失败,标识当前span是否执行失败。 取值范围:
|
| 参数 | 参数类型 | 描述 |
|---|---|---|
| trace_id | string | 参数解释: 调用链id,标签所属的调用链唯一标识。 取值范围: 调用链id字符串。 |
| span_id | string | 参数解释: spanid,标签所属的span唯一标识。 取值范围: spanid字符串。 |
| start | long | 参数解释: 开始时间,标签创建或关联的时间戳。 取值范围: unix时间戳,单位为ms。 |
| last_update_time | long | 参数解释: 更新时间,标签最后更新的时间戳。 取值范围: unix时间戳,单位为ms。 |
| label | string | 参数解释: 标签名称,标签的标识名。 取值范围: 不涉及。 |
| string_value | string | 参数解释: 标签值,当标签值为字符串类型时返回此字段。 取值范围: 字符串值。 |
| float_value | string | 参数解释: 标签值,当标签值为浮点数类型时返回此字段。 取值范围: 浮点数值的字符串表示。 |
请求示例
post https://api.example.com/v1/ops/observation/traces
{
"page_no" : 1,
"page_size" : 10,
"start_time" : 1773279366881,
"end_time" : 1775871366881,
"span_type" : "root"
} 响应示例
状态码:200
参数解释:
响应码,用于标识接口调用结果。
取值范围:
200表示成功,其他值表示失败,具体参见错误码文档。
{
"span_list" : [ {
"trace_id" : "94c7408e75f61939f1deb09b58a1baf1",
"parent_span_id" : null,
"span_id" : "7176c7f41140760d",
"span_type" : "workflow",
"span_name" : "userinput",
"status_code" : "status_code_ok",
"input" : "10000000000美元可以兑换黄金",
"output" : "10000000000美元可以兑换黄金",
"duration" : 5,
"session_id" : "test111",
"tokens" : 0,
"input_tokens" : 0,
"output_tokens" : 0,
"start_time" : 1775271188055,
"call_type" : "debug",
"metadata" : null,
"feedback_operation" : null,
"label" : [ ],
"resource_id" : "b0fd244b-c5c8-4ef7-97b6-645a1b03edc6",
"resource_name" : "测试",
"resource_type" : "workflow",
"model_name" : null,
"is_error" : false
} ],
"total" : 5
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 参数解释: 响应码,用于标识接口调用结果。 取值范围: 200表示成功,其他值表示失败,具体参见错误码文档。 |
错误码
请参见错误码。
相关文档
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨