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>
--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
Argumentos¶
Nenhum
Opções¶
--since TEXT
Busque eventos mais recentes do que há esse tempo, na sintaxe de intervalo do Snowflake.
--until TEXT
Busque 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 TEXT
Restrição de resultados a um nome de escopo específico. Pode ser especificado várias vezes. Padrão: [].
--consumer-org TEXT
O nome da organização de consumidor.
--consumer-account TEXT
O nome da conta do consumidor na organização.
--consumer-app-hash TEXT
O hash SHA-1 do nome do aplicativo do consumidor.
--first INTEGER
Busque apenas os primeiros N eventos. Não pode ser usado com –last. Padrão: -1.
--last INTEGER
Buscar apenas os últimos N eventos. Não pode ser usado com –first. Padrão: -1.
--follow, -f
Continue pesquisando sobre eventos. Implica –last 20, a menos que seja substituído ou o sinalizador –since seja usado. Padrão: falso.
--follow-interval INTEGER
Intervalo de pesquisa em segundos ao usar o sinalizador –follow. Padrão: 10
--package-entity-id TEXT
O ID da entidade do pacote no qual a operação é feita quando definition_version for 2 ou superior.
--app-entity-id TEXT
O ID da entidade do aplicativo no qual a operação é feita quando definition_version for 2 ou superior.
-p, --project TEXT
Caminho onde o projeto Snowflake está. O padrão é o diretório de trabalho atual.
--env TEXT
Cadeia de caracteres no formato chave=valor. Substitui variáveis da seção env usadas para modelos. Padrão: [].
--connection, -c, --environment TEXT
Nome da conexão, conforme definido no arquivo
config.toml
. Padrão:padrão
.--host TEXT
Endereço do host da conexão. Substitui o valor especificado para a conexão.
--port INTEGER
Porta para a conexão. Substitui o valor especificado para a conexão.
--account, --accountname TEXT
Nome atribuído à sua conta Snowflake. Substitui o valor especificado para a conexão.
--user, --username TEXT
Nome de usuário para se conectar ao Snowflake. Substitui o valor especificado para a conexão.
--password TEXT
Senha do Snowflake. Substitui o valor especificado para a conexão.
--authenticator TEXT
Autenticador Snowflake. Substitui o valor especificado para a conexão.
--private-key-file, --private-key-path TEXT
Caminho do arquivo de chave privada Snowflake. Substitui o valor especificado para a conexão.
--token-file-path TEXT
Caminho para o arquivo com um token OAuth que deve ser usado ao conectar-se ao Snowflake.
--database, --dbname TEXT
Banco de dados a ser usado. Substitui o valor especificado para a conexão.
--schema, --schemaname TEXT
Esquema de banco de dados a ser usado. Substitui o valor especificado para a conexão.
--role, --rolename TEXT
Função a ser usada. Substitui o valor especificado para a conexão.
--warehouse TEXT
Warehouse a ser usado. Substitui o valor especificado para a conexão.
--temporary-connection, -x
Usa conexão definida com parâmetros de linha de comando, em vez de uma definida na configuração. Padrão: falso.
--mfa-passcode TEXT
Token a ser usado para autenticação multifator (MFA).
--enable-diag
Execução do teste de diagnóstico do conector Python. Padrão: falso.
--diag-log-path TEXT
Caminho do relatório de diagnóstico. Padrão: <temporary_directory>.
--diag-allowlist-path TEXT
Caminho do relatório de diagnóstico para a lista de permissões opcional.
--format [TABLE|JSON]
Especifica o formato de saída. Padrão: TABLE.
--verbose, -v
Exibe entradas de log para níveis de log
info
e superior. Padrão: falso.--debug
Exibe entradas de log para níveis de log de
depuração
e superiores; os logs de depuração contêm informações adicionais. Padrão: falso.--silent
Desliga a saída intermediária para o console. Padrão: falso.
--help
Exibe 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