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

根据条件查询日志 - ListOpsAgentLog

功能介绍

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

调用方法

请参见如何调用API。

授权信息

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

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts::listOpsAgentLog

List

-

-

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

URI

GET /v1/ops/observation/agent/{agent_id}/log

表1 路径参数

参数

是否必选

参数类型

描述

agent_id

是

String

参数解释：

智能体ID，获取方式通过查询智能体列表接口获取。

约束限制：

长度限制为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

参数解释：

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

约束限制：

仅在非首次分页查询时使用，值来自上次查询返回的scroll_id，为系统生成值，无需用户指定字符类型。

取值范围：

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

默认取值：

不涉及。

keyword

否

String

参数解释：

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

约束限制：

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

取值范围：

不涉及。

默认取值：

不涉及。

line_num

否

String

参数解释：

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

约束限制：

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

取值范围：

不涉及。

默认取值：

不涉及。

is_desc

否

Boolean

参数解释：

表示日志查询的顺序。

约束限制：

不涉及。

取值范围：

  • true：倒序查询。

  • false：顺序查询

默认取值：

默认值为false。

resource_type

否

String

参数解释：

资源类型，用于指定查询的资源对象类型。

约束限制：

不涉及

取值范围：

  • agent：单智能体；

  • multiagents：多智能体；

  • workflow：工作流。

默认取值：

不涉及。

请求参数

无

响应参数

状态码：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，任意字符串。

状态码：400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

状态码：403

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

encoded_authorization_message

String

参数解释：

编码后的授权信息，用于客户端解析权限问题。

取值范围：

不涉及。

details

Array of OpsObserverCommonError objects

参数解释：

依赖的下游服务错误信息列表。

取值范围：

不涉及。
表7 OpsObserverCommonError

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

状态码：429

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

状态码：500

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

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"
}

状态码：400

参数解释：

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

取值范围：

400表示请求参数不正确。

{
  "error_code" : "AgentArts.05001003",
  "error_msg" : "请求参数不正确"
}

状态码：403

参数解释：

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

取值范围：

403表示权限不足，拒绝访问。

{
  "error_code" : "AgentArts.05004003",
  "error_msg" : "权限不足，拒绝访问",
  "encode_authorization_message" : "eyJIcnJvciI6ICJVbmF1dGhvcm16ZWQifQ==",
  "details" : [ {
    "error_code" : "AgentArts.05001003"
  }, {
    "error_msg" : "请求参数不正确"
  } ]
}

状态码：429

参数解释：

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

取值范围：

429表示请求过多，触发流控。

{
  "error_code" : "AgentArts.05008004",
  "error_msg" : "请求过多，触发流控"
}

状态码：500

参数解释：

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

取值范围：

500表示内部服务器错误。

{
  "error_code" : "AgentArts.05005000",
  "error_msg" : "内部服务器错误"
}

状态码

状态码

描述

200

参数解释：

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

取值范围：

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

400

参数解释：

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

取值范围：

400表示请求参数不正确。

403

参数解释：

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

取值范围：

403表示权限不足，拒绝访问。

429

参数解释：

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

取值范围：

429表示请求过多，触发流控。

500

参数解释：

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

取值范围：

500表示内部服务器错误。

错误码

请参见错误码。

父主题： 日志管理

相关文档