snow spcs service logs¶
참고
Snowpark Container Services를 이용하기 위해 필요한 권한이 있는 경우에만 Snowflake CLI에서 Snowpark Container Services를 이용할 수 있습니다.
서비스 컨테이너에서 로컬 로그를 검색합니다.
구문¶
snow spcs service logs
<name>
--container-name <container_name>
--instance-id <instance_id>
--num-lines <num_lines>
--previous-logs
--since <since_timestamp>
--include-timestamps
--follow
--follow-interval <follow_interval>
--connection <connection>
--host <host>
--port <port>
--account <account>
--user <user>
--password <password>
--authenticator <authenticator>
--private-key-file <private_key_file>
--token-file-path <token_file_path>
--database <database>
--schema <schema>
--role <role>
--warehouse <warehouse>
--temporary-connection
--mfa-passcode <mfa_passcode>
--enable-diag
--diag-log-path <diag_log_path>
--diag-allowlist-path <diag_allowlist_path>
--format <format>
--verbose
--debug
--silent
인자¶
name
서비스 식별자(예: my_service)입니다.
선택 사항¶
--container-name TEXT
컨테이너의 이름입니다.
--instance-id TEXT
0으로 시작하는 서비스 인스턴스의 ID입니다.
--num-lines INTEGER
검색할 라인의 수입니다. 기본값: 500.
--previous-logs
마지막으로 종료된 컨테이너에서 로그를 검색합니다. 기본값: False.
--since TEXT
지정된 UTC 타임스탬프에서 로그 검색을 시작합니다.
--include-timestamps
로그에 타임스탬프를 포함하십시오. 기본값: False.
--follow
실시간으로 스트림 로그. 기본값: False.
--follow-interval INTEGER
로그 스트림에 대한 사용자 지정 폴링 간격(–follow 플래그)을 초 단위로 설정할 수 있습니다. 기본값: 2.
--connection, -c, --environment TEXT
config.toml
파일에 정의된 연결의 이름입니다. 기본값:default
.--host TEXT
연결을 위한 호스트 주소입니다. 연결에 지정된 값을 재정의합니다.
--port INTEGER
연결의 포트입니다. 연결에 지정된 값을 재정의합니다.
--account, --accountname TEXT
Snowflake 계정에 할당된 이름입니다. 연결에 지정된 값을 재정의합니다.
--user, --username TEXT
Snowflake에 연결할 사용자 이름입니다. 연결에 지정된 값을 재정의합니다.
--password TEXT
Snowflake 비밀번호입니다. 연결에 지정된 값을 재정의합니다.
--authenticator TEXT
Snowflake 인증자입니다. 연결에 지정된 값을 재정의합니다.
--private-key-file, --private-key-path TEXT
Snowflake 개인 키 파일 경로입니다. 연결에 지정된 값을 재정의합니다.
--token-file-path TEXT
Snowflake에 연결할 때 사용해야 하는 OAuth 토큰이 포함된 파일 경로입니다.
--database, --dbname TEXT
사용할 데이터베이스입니다. 연결에 지정된 값을 재정의합니다.
--schema, --schemaname TEXT
사용할 데이터베이스 스키마입니다. 연결에 지정된 값을 재정의합니다.
--role, --rolename TEXT
사용할 역할입니다. 연결에 지정된 값을 재정의합니다.
--warehouse TEXT
사용할 웨어하우스입니다. 연결에 지정된 값을 재정의합니다.
--temporary-connection, -x
config에서 정의된 연결 대신, 명령줄 매개 변수로 정의된 연결을 사용합니다. 기본값: False.
--mfa-passcode TEXT
다단계 인증(MFA)에 사용할 토큰입니다.
--enable-diag
Python 커넥터 진단 테스트를 실행합니다. 기본값: False.
--diag-log-path TEXT
진단 보고서 경로입니다. 기본값: <temporary_directory>.
--diag-allowlist-path TEXT
선택적 허용 목록에 대한 진단 보고서 경로입니다.
--format [TABLE|JSON]
출력 형식을 지정합니다. 기본값: TABLE.
--verbose, -v
로그 수준
정보
이상에 대한 로그 항목을 표시합니다. 기본값: False.--debug
로그 수준
디버그
이상에 대한 로그 항목을 표시하며, 디버그 로그에는 추가 정보가 포함됩니다. 기본값: False.--silent
콘솔로의 중간 출력을 끕니다. 기본값: False.
--help
이 명령에 대한 도움말 텍스트를 표시합니다.
사용법 노트¶
컨테이너 로그에 액세스하려면 현재 역할에 서비스에 대한 MONITOR 권한이 있어야 합니다.
이 함수는 컨테이너 로그를 문자열로 반환합니다.
실시간 로그 스트림을 위해
--follow
옵션을 사용하는 경우--num-lines
및 :codenowrap:`–previous-logs ` 옵션은 지원되지 않습니다.
예¶
다음 예에서는
echo_service
로그의 마지막 세 줄을 표시합니다.snow spcs service logs echo_service --container-name echo --instance-id 0 --num-lines 3
10.18.94.31 - - [22/Nov/2024 09:16:47] "GET /healthcheck HTTP/1.1" 200 - 10.18.94.31 - - [22/Nov/2024 09:16:52] "GET /healthcheck HTTP/1.1" 200 - 10.18.94.31 - - [22/Nov/2024 09:16:57] "GET /healthcheck HTTP/1.1" 200 -
이 예는
echo_service
서비스에 대한 로그를 스트림하고 10초마다 업데이트합니다.snow spcs service logs echo_service --container-name echo --instance-id 0 --follow --follow-interval 10
다음 예에서는 2024년 11월 21일 9:30 UTC 이후의 로그 항목을 표시합니다.
snow spcs service logs echo_service --container-name echo --instance-id 0 --since 2024-11-21T09:30:00Z
다음은 마지막으로 종료된 컨테이너에서 로그를 검색하는 예입니다.
snow spcs service logs example_job_service --container-name main --instance-id 0 --previous-logs