snow logs¶
지정된 오브젝트에 대한 로그를 검색합니다.
구문¶
snow logs
<object_type>
<object_name>
--from <from_>
--to <to>
--refresh <refresh_time>
--table <event_table>
--log-level <log_level>
--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>
--oauth-client-id <oauth_client_id>
--oauth-client-secret <oauth_client_secret>
--oauth-authorization-url <oauth_authorization_url>
--oauth-token-request-url <oauth_token_request_url>
--oauth-redirect-uri <oauth_redirect_uri>
--oauth-scope <oauth_scope>
--oauth-disable-pkce
--oauth-enable-refresh-tokens
--oauth-enable-single-use-refresh-tokens
--client-store-temporary-credential
--format <format>
--verbose
--debug
--silent
--enhanced-exit-codes
인자¶
object_type
오브젝트 유형입니다. 예를 들어, 테이블, 데이터베이스, 컴퓨팅 풀 등이 있습니다.
object_name
오브젝트의 이름입니다.
선택 사항¶
--from TEXT
검색할 로그의 시작 시간입니다. 모든 ISO8061 형식을 허용합니다.
--to TEXT
검색할 로그의 종료 시간입니다. 모든 ISO8061 형식을 허용합니다.
--refresh INTEGER
설정하면 지정된 새로 고침 시간(초)으로 로그가 스트리밍됩니다.
--table TEXT
로그를 쿼리할 테이블입니다. 공급자가 제공하지 않으면 기본 테이블이 사용됩니다.
--log-level TEXT
필터링할 로그 수준입니다. 입력하지 않으면 INFO 가 사용됩니다. 기본값: INFO.
--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
연결 진단 보고서를 생성할지 여부입니다. 기본값: False.
--diag-log-path TEXT
생성된 보고서의 경로입니다. 기본값은 시스템 임시 디렉터리입니다. 기본값: <system_temporary_directory>.
--diag-allowlist-path TEXT
허용 목록 매개 변수가 포함된 JSON 파일의 경로입니다.
--oauth-client-id TEXT
Snowflake 통합을 위해 ID 공급자가 제공한 클라이언트 ID의 값입니다.
--oauth-client-secret TEXT
Snowflake 통합을 위해 ID 공급자가 제공한 클라이언트 시크릿의 값입니다.
--oauth-authorization-url TEXT
드라이버에 인증 코드를 제공하는 ID 공급자 엔드포인트입니다.
--oauth-token-request-url TEXT
드라이버에 액세스 토큰을 제공하는 ID 공급자 엔드포인트입니다.
--oauth-redirect-uri TEXT
인증 코드 리디렉션에 사용할 URI 입니다.
--oauth-scope TEXT
ID 공급자 승인 요청에서 요청된 범위입니다.
--oauth-disable-pkce
PKCE (Proof Key for Code Exchange)를 비활성화합니다. 기본값:
False
.--oauth-enable-refresh-tokens
실제 액세스 토큰이 오래되었을 때 자동 재인증을 활성화합니다. 기본값:
False
.--oauth-enable-single-use-refresh-tokens
일회용 새로 고침 토큰 시맨틱에 옵트인할지 여부입니다. 기본값:
False
.--client-store-temporary-credential
임시 자격 증명을 저장합니다.
--format [TABLE|JSON]
출력 형식을 지정합니다. 기본값: TABLE.
--verbose, -v
로그 수준
정보
이상에 대한 로그 항목을 표시합니다. 기본값: False.--debug
로그 수준
디버그
이상에 대한 로그 항목을 표시하며, 디버그 로그에는 추가 정보가 포함됩니다. 기본값: False.--silent
콘솔로의 중간 출력을 끕니다. 기본값: False.
--enhanced-exit-codes
실패 유형에 따라 종료 오류 코드를 차별화하십시오. 기본값: False.
--help
이 명령에 대한 도움말 텍스트를 표시합니다.
사용법 노트¶
snow logs 명령은 이벤트 테이블에 액세스하여 지정된 엔터티에 대한 로그 를 검색합니다. 기본적으로 이 명령은 기본 이벤트 테이블(SNOWFLAKE.TELEMETRY.EVENTS)에서 로그를 찾지만 --table
옵션을 사용하여 다른 테이블을 선택할 수 있습니다. 이벤트 테이블 및 기본값에 대한 자세한 내용은 이벤트 테이블 만들기 섹션을 참조하십시오.
--from
및 -to
옵션을 사용하여 로그를 검색할 기간을 필터링할 수 있습니다. 이 옵션 중 하나 또는 둘 다 사용할 수 있지만 둘 다 사용하는 경우 --from
시간이 --to
시간보다 빨라야 합니다. 공급자가 제공하는 시간 값은 ISO 8601 표준 을 준수해야 합니다. 자세한 내용은 Python datetime.fromisoformat() 메서드 설명서를 참조하십시오.
--log-level
옵션을 사용하면 심각도 수준 을 기준으로 메시지를 필터링할 수 있습니다. 일부 로그에는 심각도 수준이 포함되지 않습니다. 이러한 경우 모든 --log-level
값에 대한 메시지가 표시됩니다.
로그에 대한 지속적인 업데이트를 원하는 경우 --refresh
옵션을 사용하고 검색 간격(초)을 입력하면 됩니다. --refresh
및 --to
옵션을 함께 사용할 수 없습니다. 로그 스트림을 중지하려면 시스템의 기본 Keyboardinterrupt
키(예: Mac 터미널에서는 CTRL-c
)를 사용하십시오.
예¶
지정된 시작 시간부터 지금까지의 기간 동안의 컴퓨팅 풀 로그를 표시합니다.
snow logs compute_pool MY_COMPUTE_POOL --from '2025-04-01 09:00:31'
10.12.71.201 - - [01/Apr/2025 09:46:07] "GET /healthcheck HTTP/1.1" 200 - 10.12.71.201 - - [01/Apr/2025 09:46:09] "GET /healthcheck HTTP/1.1" 200 - 10.12.71.201 - - [01/Apr/2025 09:46:14] "GET /healthcheck HTTP/1.1" 200 - 10.12.71.201 - - [01/Apr/2025 09:46:19] "GET /healthcheck HTTP/1.1" 200 - 10.12.71.201 - - [01/Apr/2025 09:46:24] "GET /healthcheck HTTP/1.1" 200 - 10.12.71.201 - - [01/Apr/2025 09:46:29] "GET /healthcheck HTTP/1.1" 200 - 10.12.71.201 - - [01/Apr/2025 09:46:34] "GET /healthcheck HTTP/1.1" 200 -
특정 이벤트 테이블의 로그를 표시합니다.
snow logs compute_pool SNOWCLI_COMPUTE_POOL --table "my_db.my_schema.my_events"
오류의 원인이 되는 시작 시간이 종료 시간보다 늦은 시간 범위에 대한 로그를 표시합니다.
snow logs compute_pool SNOWCLI_COMPUTE_POOL --from '2025-03-24 12:00:31' --to "2024-01-03 00:00:00"
╭─ Error ───────────────────────────────────────────────────────── │ From_time cannot be later than to_time. Please check the values ╰─────────────────────────────────────────────────────────────────