eventos snow app¶
Busca eventos para este aplicativo na tabela de evento configurada no Snowflake. Por padrão, este comando buscará eventos gerados por um aplicativo instalado na conta da conexão atual. Para buscar eventos gerados por um aplicativo instalado em uma conta de consumidor, use as opções –consumer-org e –consumer-account. Isso requer que o compartilhamento de evento seja definido para rotear eventos para a conta de provedor: https://docs.snowflake.com/en/developer-guide/native-apps/setting-up-logging-and-events
Sintaxe¶
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>
--workload-identity-provider <workload_identity_provider>
--private-key-file <private_key_file>
--token <token>
--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
Argumentos¶
Nenhum
Opções¶
--since TEXTBusque eventos mais recentes do que há esse tempo, na sintaxe de intervalo do Snowflake.
--until TEXTBusque eventos mais antigos que esse tempo, na sintaxe de intervalo do Snowflake.
--type [log |span| span_event]Restrição de resultados a um tipo de registro específico. Pode ser especificado várias vezes. Padrão: [].
--scope TEXTRestrição de resultados a um nome de escopo específico. Pode ser especificado várias vezes. Padrão: [].
--consumer-org TEXTO nome da organização de consumidor.
--consumer-account TEXTO nome da conta do consumidor na organização.
--consumer-app-hash TEXTO hash SHA-1 do nome do aplicativo do consumidor.
--first INTEGERBusque apenas os primeiros N eventos. Não pode ser usado com –last. Padrão: -1.
--last INTEGERBuscar apenas os últimos N eventos. Não pode ser usado com –first. Padrão: -1.
--follow, -fContinue pesquisando sobre eventos. Implica –last 20, a menos que seja substituído ou o sinalizador –since seja usado. Padrão: falso.
--follow-interval INTEGERIntervalo de pesquisa em segundos ao usar o sinalizador –follow. Padrão: 10
--package-entity-id TEXTO ID da entidade do pacote no qual a operação é feita quando definition_version for 2 ou superior.
--app-entity-id TEXTO ID da entidade do aplicativo no qual a operação é feita quando definition_version for 2 ou superior.
-p, --project TEXTCaminho onde o projeto Snowflake está armazenado. O padrão é o diretório de trabalho atual.
--env TEXTCadeia de caracteres no formato key=value. Substitui as variáveis da seção env usada para modelos. Padrão: [].
--connection, -c, --environment TEXTNome da conexão, conforme definido no arquivo
config.toml. Padrão:default.--host TEXTEndereço do host da conexão. Substitui o valor especificado para a conexão.
--port INTEGERPorta para a conexão. Substitui o valor especificado para a conexão.
--account, --accountname TEXTNome atribuído à sua conta Snowflake. Substitui o valor especificado para a conexão.
--user, --username TEXTNome de usuário para se conectar ao Snowflake. Substitui o valor especificado para a conexão.
--password TEXTSenha do Snowflake. Substitui o valor especificado para a conexão.
--authenticator TEXTAutenticador Snowflake. Substitui o valor especificado para a conexão.
--workload-identity-provider TEXTProvedor de identidade de carga de trabalho (AWS, AZURE, GCP, OIDC). Substitui o valor especificado para a conexão.
--private-key-file, --private-key-path TEXTCaminho do arquivo de chave privada Snowflake. Substitui o valor especificado para a conexão.
--token TEXTToken OAuth a ser usado ao se conectar ao Snowflake.
--token-file-path TEXTCaminho para o arquivo com um token OAuth a ser usado ao se conectar ao Snowflake.
--database, --dbname TEXTBanco de dados a ser usado. Substitui o valor especificado para a conexão.
--schema, --schemaname TEXTEsquema de banco de dados a ser usado. Substitui o valor especificado para a conexão.
--role, --rolename TEXTFunção a ser usada. Substitui o valor especificado para a conexão.
--warehouse TEXTWarehouse a ser usado. Substitui o valor especificado para a conexão.
--temporary-connection, -xUsa uma conexão definida com parâmetros de linha de comando, em vez de uma definida na configuração. Padrão: falso.
--mfa-passcode TEXTToken a ser usado para autenticação multifator (MFA).
--enable-diagSe deve gerar um relatório de diagnóstico de conexão. Padrão: falso.
--diag-log-path TEXTCaminho para o relatório gerado. O padrão é o diretório temporário do sistema. Padrão: <system_temporary_directory>.
--diag-allowlist-path TEXTCaminho para um arquivo JSON que contém parâmetros da lista de permissões.
--oauth-client-id TEXTValor do ID de cliente fornecido pelo provedor de identidade para integração com o Snowflake.
--oauth-client-secret TEXTValor do segredo do cliente fornecido pelo provedor de identidade para integração com o Snowflake.
--oauth-authorization-url TEXTPonto de extremidade do provedor de identidade que fornece o código de autorização ao driver.
--oauth-token-request-url TEXTPonto de extremidade do provedor de identidade que fornece os tokens de acesso ao driver.
--oauth-redirect-uri TEXTURI a ser usado para redirecionamento de código de autorização.
--oauth-scope TEXTEscopo solicitado na solicitação de autorização do provedor de identidade.
--oauth-disable-pkceDesativa o Proof Key for Code Exchange (PKCE). Padrão:
False.--oauth-enable-refresh-tokensPermite uma reautenticação silenciosa quando o token de acesso real fica desatualizado. Padrão:
False.--oauth-enable-single-use-refresh-tokensSe o usuário deve optar pela semântica de token de atualização de uso único. Padrão:
False.--client-store-temporary-credentialArmazena a credencial temporária.
--format [TABLE|JSON|JSON_EXT|CSV]Especifica o formato de saída. Padrão: TABLE.
--verbose, -vExibe entradas de log para os níveis de log
infoe superiores. Padrão: falso.--debugExibe entradas de log para níveis de log de
depuraçãoe superiores; os logs de depuração contêm informações adicionais. Padrão: falso.--silentDesliga a saída intermediária para o console. Padrão: falso.
--enhanced-exit-codesDiferencia os códigos de erro de saída com base no tipo de falha. Padrão: falso.
--helpExibe o texto de ajuda para este comando.
Notas de uso¶
Nota
Antes de usar este comando, é necessário definir o tratamento de evento para a conta Snowflake do provedor. Para obter mais informações, consulte Registro, rastreamento e métricas.
O comando snow app events recupera eventos gerados por um aplicativo nativo instalado na conta da conexão atual.
Por padrão, este comando buscará eventos gerados por um Snowflake Native App instalado na conta da conexão atual. Para buscar eventos gerados por um Snowflake Native App instalado em uma conta de consumidor, use as opções --consumer-org e --consumer-account. Essas opções exigem que o compartilhamento de evento seja definido para rotear eventos para a conta do provedor.
Exemplos¶
Recupere todos os eventos de um aplicativo instalado na conta do provedor.
snow app events
Recupere um subconjunto de eventos para um aplicativo instalado na conta do provedor.
# 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
Recupere eventos para uma instalação do consumidor.
snow app events --consumer-org <organization-name> --consumer-account <account-name>
Recupere eventos para um aplicativo de consumidor usando o nome do aplicativo com hash.
snow app events --consumer-org <organization-name> --consumer-account <account-name> --consumer-app-hash cafc10bf6a5deb574ada0e3a009b63bbbe9bdb84
Recupere eventos como JSON.
snow app events --format json