카테고리:: :doc:`/sql-reference/functions-table`(Cortex Agents)

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 가시성 이벤트에 포함된 정보에 대한 자세한 내용은 Observability 데이터 섹션을 참조하세요.

액세스 제어 요구 사항¶

이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.


권한	오브젝트	참고
CORTEX_USER	데이터베이스 역할
USAGE	Cortex Agent
MONITOR	Cortex Agent

스키마의 오브젝트에 대한 작업을 수행하려면 상위 데이터베이스에 대한 하나 이상의 권한과 상위 스키마에 대한 하나 이상의 권한이 필요합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

Cortex Agent 평가에 필요한 전체 액세스 제어 권한은 :ref:`Cortex Agent 평가 – 액세스 제어 요구 사항 <label-agent_evaluation_access_control>`을 참조하세요.

예¶

다음 예제에서는 eval_db.eval_schema 스키마에 저장된 evaluated_agent``라는 에이전트의 ``run-1 실행에 대한 오류와 경고를 확인합니다.

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