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>
  --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
Copy

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á armazenado. O padrão é o diretório de trabalho atual.

--env TEXT

Cadeia de caracteres no formato key=value. Substitui as variáveis da seção env usada para modelos. Padrão: [].

--connection, -c, --environment TEXT

Nome da conexão, conforme definido no arquivo config.toml. Padrão: default.

--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 a ser usado ao se conectar 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 uma 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

Se deve gerar um relatório de diagnóstico de conexão. Padrão: falso.

--diag-log-path TEXT

Caminho para o relatório gerado. O padrão é o diretório temporário do sistema. Padrão: <system_temporary_directory>.

--diag-allowlist-path TEXT

Caminho para um arquivo JSON que contém parâmetros da lista de permissões.

--oauth-client-id TEXT

Valor do ID de cliente fornecido pelo provedor de identidade para integração com o Snowflake.

--oauth-client-secret TEXT

Valor do segredo do cliente fornecido pelo provedor de identidade para integração com o Snowflake.

--oauth-authorization-url TEXT

Ponto de extremidade do provedor de identidade que fornece o código de autorização ao driver.

--oauth-token-request-url TEXT

Ponto de extremidade do provedor de identidade que fornece os tokens de acesso ao driver.

--oauth-redirect-uri TEXT

URI a ser usado para redirecionamento de código de autorização.

--oauth-scope TEXT

Escopo solicitado na solicitação de autorização do provedor de identidade.

--oauth-disable-pkce

Desativa o Proof Key for Code Exchange (PKCE). Padrão: False.

--oauth-enable-refresh-tokens

Permite uma reautenticação silenciosa quando o token de acesso real fica desatualizado. Padrão: False.

--oauth-enable-single-use-refresh-tokens

Se o usuário deve optar pela semântica de token de atualização de uso único. Padrão: False.

--client-store-temporary-credential

Armazena a credencial temporária.

--format [TABLE|JSON]

Especifica o formato de saída. Padrão: TABLE.

--verbose, -v

Exibe entradas de log para os níveis de log info e superiores. 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.

--enhanced-exit-codes

Diferencia os códigos de erro de saída com base no tipo de falha. 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
    
    Copy
  • 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
    
    Copy
  • Recupere eventos para uma instalação do consumidor.

    snow app events --consumer-org <organization-name> --consumer-account <account-name>
    
    Copy
  • 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
    
    Copy
  • Recupere eventos como JSON.

    snow app events --format json
    
    Copy