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
Copy

인자

없음

선택 사항

--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
    
    Copy
  • 공급자 계정에 설치된 애플리케이션에 대한 이벤트 하위 세트를 검색합니다.

    # 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
    
    Copy
  • 컨슈머 설치에 대한 이벤트를 검색합니다.

    snow app events --consumer-org <organization-name> --consumer-account <account-name>
    
    Copy
  • 해시된 애플리케이션 이름을 사용하여 컨슈머 애플리케이션에 대한 이벤트를 검색합니다.

    snow app events --consumer-org <organization-name> --consumer-account <account-name> --consumer-app-hash cafc10bf6a5deb574ada0e3a009b63bbbe9bdb84
    
    Copy
  • 이벤트를 JSON으로 검색합니다.

    snow app events --format json
    
    Copy