SYSTEM$GET_APPLICATION_SERVICE_LOGS

SYSTEM$GET_APPLICATION_SERVICE_LOGS

실행 중인 애플리케이션 서비스(Application Service)의 컨테이너 로그를 반환해요. 배포된 애플리케이션을 문제 해결할 때 이 함수를 사용해요.

출처: Snowflake SYSTEM$GET_APPLICATION_SERVICE_LOGS 함수 문서

본문

구문 (Syntax)

SYSTEM$GET_APPLICATION_SERVICE_LOGS( '<service_identifier>' [ , <tail_lines> [ , <instance_id> ] ] )

인자 (Arguments)

  • service_identifier — 애플리케이션 서비스의 정규화되거나 정규화되지 않은 식별자예요.
  • tail_lines — 선택 사항. 끝에서부터 반환할 로그 줄 수예요. 기본값은 500이에요.
  • instance_id — 선택 사항. 로그를 가져올 인스턴스 번호예요. 인스턴스는 0부터 번호가 매겨져요. 기본값은 0이에요. 해당 인스턴스가 실행 중이 아니면 Snowflake는 유효한 ID를 나열하는 오류를 반환해요. 예: Invalid instance id 3. Valid instance ids: 0, 1.

반환 값 (Returns)

서비스 컨테이너의 연결된 로그 출력을 포함하는 문자열이에요.

접근 제어 요구 사항 (Access Control Requirements)

역할은 애플리케이션 서비스에 대한 MONITOR 권한이 있어야 해요.

사용 참고 (Usage Notes)

  • 서비스 식별자는 작은따옴표로 묶어야 해요.
  • 컨테이너 로그를 반환하려면 서비스가 실행(running) 상태여야 해요. 일시 중단(suspended)된 서비스의 경우 함수는 빈 결과를 반환해요.
  • 서비스에 인스턴스가 두 개 이상 있으면 instance_id를 전달해 인스턴스를 선택해요. 이 경우 tail_lines도 전달해야 해요.
  • 활성 이벤트 테이블을 통해 라우팅되는 구조화된 로그의 경우 이벤트 테이블을 직접 조회하세요. 자세한 내용은 로깅, 추적, 메트릭을 참고하세요.

예제 (Examples)

SELECT SYSTEM$GET_APPLICATION_SERVICE_LOGS('my_db.my_schema.my_app');

-- 마지막 200줄 반환
SELECT SYSTEM$GET_APPLICATION_SERVICE_LOGS('my_db.my_schema.my_app', 200);

-- 인스턴스 1의 로그 반환
SELECT SYSTEM$GET_APPLICATION_SERVICE_LOGS('my_db.my_schema.my_app', 500, 1);

더 알아보기