类别：: 表函数 (Cortex Agent)

GET_AI_OBSERVABILITY_LOGS (SNOWFLAKE.LOCAL)¶

检索 Cortex Agent 可观察性事件（例如警告或故障）的日志数据。

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

另请参阅：: 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。此值不区分大小写。

返回¶

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

访问控制要求¶

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


权限	对象	备注
CORTEX_USER	数据库角色
USAGE	Cortex Agent
MONITOR	Cortex Agent

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

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

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

有关 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';