文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 观测/ 日志管理/ 根据条件查询日志 - ListOpsAgentLog
更新时间:2026-08-14 GMT+08:00
分享

根据条件查询日志 - ListOpsAgentLog

功能介绍

该接口用于条件查询日志。

调用方法

请参见如何调用API

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts::listOpsAgentLog

List

-

-

-

  • lts:logStream:searchLog
  • lts:logStream:listLogStream

URI

GET https://localhost.com//v1/ops/observation/agent/{agent_id}/log

表1 路径参数

参数

是否必选

参数类型

描述

agent_id

String

参数解释

智能体ID,获取方式通过[查询智能体列表接口]获取(https://support.huaweicloud.com/api-agentarts/ListOpsAgentObservation.html)。

约束限制

长度限制为1~64个字符。

取值范围

不涉及。

默认取值

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

start_time

String

参数解释

查询指标的开始时间,用于指定查询时间范围的起始时间点,Unix时间戳,单位为ms。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

end_time

String

参数解释

查询指标的截止时间,用于指定查询时间范围的截止时间点,Unix时间戳,单位为ms。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

trace_id

String

参数解释

调用链ID,可通过查询调用链列表接口(ListOpsTrace)获取。

约束限制

不涉及。

取值范围

长度限制为1~64个字符。

默认取值

不涉及。

span_id

String

参数解释

分布式链路追踪中的Span标识,用于标识一次具体的调用操作,可通过查询调用链详细信息接口(ShowOpsTrace)获取。

约束限制

不涉及。

取值范围

长度限制为1~64个字符。

默认取值

不涉及。

limit

Integer

参数解释

每次返回的日志条数。

约束限制

不涉及。

取值范围

取值范围0~1000。

默认取值

50。

scroll_id

String

参数解释

分页查询时,若上次查询的返回结果中包含字段scrollId,需要增加该字段参与分页查询。

约束限制

仅在非首次分页查询时使用,值来自上次查询返回的scroll_id。

取值范围

长度限制为1~64个字符。

默认取值

不涉及。

keyword

String

参数解释

关键字查询,用于模糊匹配日志内容的关键字。

约束限制

不涉及。

取值范围

长度限制为1~64个字符。

默认取值

不涉及。

line_num

String

参数解释

日志行号,用于指定查询的起始行位置。

约束限制

首次查询时不传该参数,后续查询时传入上次查询结果中最后一条日志的line_num。

取值范围

不涉及。

默认取值

不涉及。

is_desc

Boolean

参数解释:表示日志查询的顺序,当前支持顺序(false)或倒序查询(true)

resource_type

String

参数解释

类型,兼容office_ace智能体查询,其它不传

约束限制

不涉及

取值范围

agent,workflow,multiagents,controller,office_ace

默认取值

不涉及。

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

count

Integer

参数解释

返回查询日志总条数。

取值范围

取值范围0~1000000。

is_query_complete

Boolean

参数解释

是否查询出所有日志。

取值范围

不涉及。

logs

Array of AgentLogContent objects

参数解释

日志内容列表,元素类型为AgentLogContent对象,包含日志内容、行号、标签等信息。

取值范围

不涉及。

scroll_id

String

参数解释

分页查询的滚动ID,用于获取下一页数据,首次查询不返回此字段。

取值范围

不涉及。

表4 AgentLogContent

参数

参数类型

描述

content

String

参数解释

日志内容。

取值范围

不涉及。

line_num

String

参数解释

日志单行序列号。

取值范围

不涉及。

labels

Map<String,String>

日志标签,Map类型。Key:标签名称,类型为String;Value:标签值,类型为String。

请求示例

GET https://api.example.com/v1/ops/observation/agent/a04413fa-883a-4346-93df-34f49ee85e0c/log?start_time=1773282869461&end_time=1775874869461

响应示例

状态码:200

参数解释

响应码,用于标识接口调用结果。

取值范围

200表示成功,其他值表示失败,具体参见错误码文档。

{
  "count" : 10,
  "is_query_complete" : true,
  "logs" : [ {
    "content" : "日志内容",
    "line_num" : "1775871365836000",
    "labels" : { }
  } ],
  "scroll_id" : "111"
}

状态码

状态码

描述

200

参数解释

响应码,用于标识接口调用结果。

取值范围

200表示成功,其他值表示失败,具体参见错误码文档。

错误码

请参见错误码

相关文档