snow app events¶
Snowflake에서 구성된 이벤트 테이블에서 이 앱에 대한 이벤트를 가져옵니다. 기본적으로 이 명령은 현재 연결 계정에 설치된 앱에서 생성된 이벤트를 가져옵니다. 컨슈머 계정에 설치된 앱에서 생성된 이벤트를 가져오려면 –consumer-org 및 –consumer-account 옵션을 사용합니다. 이를 위해서는 이벤트를 공급자 계정으로 라우팅하도록 이벤트 공유를 설정해야 합니다(https://docs.snowflake.com/en/developer-guide/native-apps/setting-up-logging-and-events).
구문¶
snow app events
--since <since>
--until <until>
--type <record_types>
--scope <scopes>
--consumer-org <consumer_org>
--consumer-account <consumer_account>
--consumer-app-hash <consumer_app_hash>
--first <first>
--last <last>
--follow
--follow-interval <follow_interval>
--package-entity-id <package_entity_id>
--app-entity-id <app_entity_id>
--project <project_definition>
--env <env_overrides>
--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
인자¶
없음
선택 사항¶
--since TEXT
이 시간보다 최근에 발생한 이벤트를 Snowflake 간격 구문으로 가져옵니다.
--until TEXT
이 시간보다 오래된 이벤트를 Snowflake 간격 구문으로 가져옵니다.
--type [log |span| span_event]
결과를 특정 레코드 유형으로 제한합니다. 여러 번 지정할 수 있습니다. 기본값: [].
--scope TEXT
결과를 특정 범위 이름으로 제한합니다. 여러 번 지정할 수 있습니다. 기본값: [].
--consumer-org TEXT
컨슈머 조직의 이름입니다.
--consumer-account TEXT
조직 내 컨슈머 계정의 이름입니다.
--consumer-app-hash TEXT
컨슈머 애플리케이션 이름의 SHA-1 해시입니다.
--first INTEGER
처음 N개의 이벤트만 가져옵니다. –last와 함께 사용할 수 없습니다. 기본값: -1.
--last INTEGER
마지막 N개의 이벤트만 가져옵니다. –first와 함께 사용할 수 없습니다. 기본값: -1.
--follow, -f
이벤트에 대한 폴링을 계속합니다. 재정의하거나 –since 플래그를 사용하는 경우를 제외하고 –last 20을 의미합니다. 기본값: False.
--follow-interval INTEGER
–follow 플래그를 사용할 때의 폴링 간격(초)입니다. 기본값: 10.
--package-entity-id TEXT
definition_version이 2 이상일 때 작동할 패키지 엔터티의 ID입니다.
--app-entity-id TEXT
definition_version이 2 이상일 때 작동할 애플리케이션 엔터티의 ID입니다.
-p, --project TEXT
Snowflake 프로젝트가 있는 경로입니다. 기본값은 현재 작업 디렉터리입니다.
--env TEXT
키=값 형식의 문자열. 템플릿에 사용되는 env 섹션의 변수를 재정의합니다. 기본값: [].
--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
로그 수준
info
이상의 로그 항목을 표시합니다. 기본값: False.--debug
로그 수준
디버그
이상에 대한 로그 항목을 표시하며, 디버그 로그에는 추가 정보가 포함됩니다. 기본값: False.--silent
콘솔로의 중간 출력을 끕니다. 기본값: False.
--help
이 명령에 대한 도움말 텍스트를 표시합니다.
사용법 노트¶
참고
이 명령을 사용하기 전에 공급자 Snowflake 계정에 대한 이벤트 처리를 설정해야 합니다. 자세한 내용은 로깅, 추적 및 메트릭 섹션을 참조하십시오.
snow app events
명령은 현재 연결 계정에 설치된 기본 애플리케이션에서 생성된 이벤트를 검색합니다.
기본적으로 이 명령은 현재 연결 계정에 설치된 Snowflake Native App 에서 생성된 이벤트를 가져옵니다. 컨슈머 계정에 설치된 Snowflake Native App 에서 생성된 이벤트를 가져오려면 --consumer-org
및 --consumer-account
옵션을 사용합니다. 이러한 옵션을 사용하려면 이벤트를 공급자 계정으로 라우팅 하도록 이벤트 공유를 설정해야 합니다.
예¶
공급자 계정에 설치된 애플리케이션에 대한 모든 이벤트를 검색합니다.
snow app events
공급자 계정에 설치된 애플리케이션에 대한 이벤트 하위 세트를 검색합니다.
# Limiting the number of events snow app events --first 10 snow app events --last 10 # Narrowing the time range using interval syntax snow app events --since '5 minutes' snow app events --until '1 hour' # Filtering events snow app events --type log snow app events --scope com.myapp.MyClass1 --scope com.myapp.MyClass2
컨슈머 설치에 대한 이벤트를 검색합니다.
snow app events --consumer-org <organization-name> --consumer-account <account-name>
해시된 애플리케이션 이름을 사용하여 컨슈머 애플리케이션에 대한 이벤트를 검색합니다.
snow app events --consumer-org <organization-name> --consumer-account <account-name> --consumer-app-hash cafc10bf6a5deb574ada0e3a009b63bbbe9bdb84
이벤트를 JSON으로 검색합니다.
snow app events --format json