snow spcs service events¶

참고

Snowpark Container Services를 이용하기 위해 필요한 권한이 있는 경우에만 Snowflake CLI에서 Snowpark Container Services를 이용할 수 있습니다.

서비스 컨테이너에 대한 플랫폼 이벤트를 검색합니다.

구문¶

snow spcs service events
  <name>
  --container-name <container_name>
  --instance-id <instance_id>
  --since <since>
  --until <until>
  --first <first>
  --last <last>
  --all
  --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입니다.
--since TEXT: Fetch events that are newer than this time ago, in Snowflake interval syntax.
--until TEXT: Fetch events that are older than this time ago, in Snowflake interval syntax.
--first INTEGER: 처음 N개의 이벤트만 가져옵니다. –last와 함께 사용할 수 없습니다.
--last INTEGER: 마지막 N개의 이벤트만 가져옵니다. –first와 함께 사용할 수 없습니다.
--all: 모든 열을 가져옵니다. 기본값: False.
--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: Path to file with an OAuth token that should be used when connecting to Snowflake.
--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: 이 명령에 대한 도움말 텍스트를 표시합니다.

사용법 노트¶

참고

이 명령을 사용하려면 아래와 같이 config.toml 파일에서 enable_spcs_service_events 기능을 활성화해야 합니다.

[cli.features]
enable_spcs_service_events = true

다음 매개 변수가 필요합니다.
- name
- --container-name <name>
- --instance-id <ID>
--since and --until 시간 기반 필터를 사용하여 지정된 기간 동안 이벤트를 반환할 수 있습니다. 예컨대 1h (시간) 또는 2d (일)과 같이 시간을 상대 시간으로 지정할 수 있습니다.
--first 및 --last 옵션을 사용하여 지정된 개수의 이벤트만 반환할 수 있습니다. 이러한 옵션은 상호 배타적이라는 점에 유의하십시오.

예¶

특정 서비스에 대한 모든 이벤트를 검색합니다.
```
snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0
```

특정 서비스에 대한 이벤트의 하위 세트를 검색합니다.

snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --first 5
snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --last 5

최근 5분 이내의 이벤트를 가져옵니다.

snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --since '5 minutes'

1시간이 지난 이벤트를 가져옵니다.

snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --until '1 hour'

모든 열이 표시된 모든 이벤트를 검색합니다.

snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --all --last 1

TIMESTAMP | DATABASE NAME | SCHEMA NAME | SERVICE NAME | INSTANCE NAME | CONTAINER NAME | SEVERITY | EVENT NAME | EVENT VALUE
-- | -- | -- | -- | -- | -- | -- | -- | --
2024-12-13 10:01:52.808692 | TESTDB | PUBLIC | LOG_EVENT | 0 | log-printer | INFO | CONTAINER.STATUS_CHANGE | { "message": "Running", "status": "READY" }
2024-12-14 22:27:25.420489 | TESTDB | PUBLIC | LOG_EVENT | 0 | log-printer | INFO | CONTAINER.STATUS_CHANGE | { "message": "Running", "status": "READY" }

JSON 출력 형식의 이벤트를 검색합니다.

snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --last 1 --format json

[
     {
         "TIMESTAMP": "2024-12-14T22:27:25.420489",
         "DATABASE NAME": "TESTDB",
         "SCHEMA NAME": "PUBLIC",
         "SERVICE NAME": "LOG_EVENT",
         "INSTANCE NAME": "0",
         "CONTAINER NAME": "log-printer",
         "SEVERITY": "INFO",
         "EVENT NAME": "CONTAINER.STATUS_CHANGE",
         "EVENT VALUE": "{\n  \"message\": \"Running\",\n  \"status\": \"READY\"\n}"
     }
 ]