类别：: 表函数 (Cortex Agent)

GET_AI_OBSERVABILITY_LOGS (SNOWFLAKE.LOCAL)¶

检索 Cortex Agent 或外部代理应用程序 AI 可观察性事件的日志数据，例如警告或故障（请参阅外部代理命令）。

调用此函数可检索有关评估运行期间发生的事件的信息。有关更多信息，请参阅 Cortex Agent 评估和。

另请参阅：: GET_AI_OBSERVABILITY_EVENTS (SNOWFLAKE.LOCAL) , GET_AI_RECORD_TRACE (SNOWFLAKE.LOCAL) , GET_AI_EVALUATION_DATA (SNOWFLAKE.LOCAL) , EXECUTE_AI_EVALUATION

语法¶

SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_LOGS( <database>, <schema>, <agent_name>, <agent_type> )

实参¶

database: 包含代理的数据库的名称。
schema: 包含代理的架构的名称。
agent_name: 要检索其记录的代理名称。
agent_type: 代理类型字符串。将 CORTEX AGENT 用于 Cortex Agent 评估或将 EXTERNAL AGENT 用于外部代理对象（请参阅外部代理命令）。此值不区分大小写。

返回¶

有关 AI 可观测性事件中包含的信息的详细说明，请参阅可观察性数据。

访问控制要求¶

用于执行此操作的角色必须至少具有以下权限：


权限	对象	备注
CORTEX_USER	数据库角色
USAGE	Cortex Agent 或外部代理	对 `agent_name` 所标识的对象是必需的。对于 `EXTERNAL AGENT`，拥有该外部代理的 USAGE 权限即可调用此函数（MONITOR 不适用）。
MONITOR	Cortex Agent	当 `agent_type` 为 `CORTEX AGENT` 时，对 `agent_name` 所标识的 Cortex Agent 是必需的。当 `agent_type` 为 `EXTERNAL AGENT` 时，此权限不适用。

对架构中的对象进行操作至少需要父数据库的一项权限和父架构的一项权限。

有关创建具有指定权限集的自定义角色的说明，请参阅创建自定义角色。

有关对安全对象执行 SQL 操作的相应角色和权限授予的一般信息，请参阅访问控制概述。

当 agent_type 为 EXTERNAL AGENT 时，调用此函数仅需对该对象具有 USAGE 权限。而使用 ALTER EXTERNAL AGENT 或 DROP EXTERNAL AGENT 修改或移除外部代理对象，则需要对该外部代理具有 OWNERSHIP 权限。

有关 Cortex Agent 评估所需的完整访问控制权限，请参阅 Cortex Agent 评估 – 访问控制要求。有关外部代理对象，请参阅可观察性数据。

示例¶

以下示例检查名为 run-1 的运行中的错误和警告，其中代理名为 evaluated_agent，存储在架构 eval_db.eval_schema 中：

SELECT * FROM TABLE(SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_LOGS(
  'eval_db',
  'eval_schema',
  'evaluated_agent',
  'CORTEX AGENT')
)
  WHERE TRUE
    AND (record:"severity_text"='ERROR' or record:"severity_text"='WARN')
    AND record_attributes:"snow.ai.observability.run.name"='run-1';