GET_AI_OBSERVABILITY_LOGS

GET_AI_OBSERVABILITY_LOGS (SNOWFLAKE.LOCAL) (AI 옵저버빌리티 로그)

Cortex Agent 또는 External Agent 애플리케이션(External Agent commands 참고)의 경고나 실패 같은 AI Observability 이벤트에 대한 로그 데이터를 검색해요.

평가 실행 중 어떤 이벤트가 발생했는지에 대한 정보를 검색하려면 이 함수를 호출해요. 자세한 내용은 Cortex Agent evaluations 및 AI_OBSERVABILITY_EVENTS table을 참고해요.

참조: GET_AI_OBSERVABILITY_EVENTS (SNOWFLAKE.LOCAL), GET_AI_RECORD_TRACE (SNOWFLAKE.LOCAL), GET_AI_EVALUATION_DATA (SNOWFLAKE.LOCAL), EXECUTE_AI_EVALUATION

출처: Snowflake SQL Reference - GET_AI_OBSERVABILITY_LOGS

본문

구문

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

인자

database

에이전트를 포함하는 데이터베이스의 이름이에요.

schema

에이전트를 포함하는 스키마의 이름이에요.

agent_name

레코드를 검색할 에이전트의 이름이에요.

agent_type

에이전트 유형 문자열이에요. Cortex Agent 평가에는 CORTEX_AGENT를, External Agent 객체에는 EXTERNAL_AGENT를 사용해요(External Agent commands 참고). 이 값은 대소문자를 구분하지 않아요.

반환 값

AI Observability 이벤트에 포함된 정보에 대한 자세한 내용은 AI_OBSERVABILITY_EVENTS table을 참고해요.

접근 제어 요구 사항

이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 가져야 해요:
CORTEX_USER Database role
USAGE Cortex Agent 또는 External Agent agent_name으로 식별되는 객체에 필요함. EXTERNAL_AGENT의 경우 External Agent에 대한 USAGE로 이 함수를 호출하기에 충분함(MONITOR는 적용되지 않음).
MONITOR Cortex Agent agent_type이 CORTEX_AGENT일 때 agent_name으로 식별되는 Cortex Agent에 필요함. agent_type이 EXTERNAL_AGENT일 때는 적용되지 않음.

스키마의 객체를 운영하려면 부모 데이터베이스에 대한 권한이 적어도 하나, 부모 스키마에 대한 권한이 적어도 하나 필요해요.

지정된 권한 집합을 가진 사용자 지정 역할을 만드는 방법은 Creating custom roles을 참고해요.

보안 객체에 대해 SQL 작업을 수행하기 위한 역할 및 권한 부여에 대한 일반 정보는 Overview of Access Control을 참고해요.

agent_type이 EXTERNAL_AGENT일 때 이 함수를 호출하려면 해당 객체에 대한 USAGE만 필요해요. ALTER EXTERNAL AGENT 또는 DROP EXTERNAL AGENT로 객체를 수정하거나 제거하려면 External Agent에 대한 OWNERSHIP이 필요해요.

Cortex Agent 평가에 필요한 전체 접근 제어 권한은 Cortex Agent evaluations: access control requirements를 참고해요. External Agent 객체는 AI_OBSERVABILITY_EVENTS table을 참고해요.

예시

다음 예시는 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';

더 알아보기