snow logs

Recupera os logs de um determinado objeto.

Sintaxe

snow logs
  <object_type>
  <object_name>
  --from <from_>
  --to <to>
  --refresh <refresh_time>
  --table <event_table>
  --log-level <log_level>
  --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

object_type

Tipo de objeto. Por exemplo, tabela, banco de dados, pool de computação.

object_name

Nome do objeto.

Opções

--from TEXT

A hora de início dos logs a serem recuperados. Aceita todos os formatos ISO8061.

--to TEXT

A hora de término dos logs a serem recuperados. Aceita todos os formatos ISO8061.

--refresh INTEGER

Se definido, os logs serão transmitidos com o tempo de atualização fornecido em segundos.

--table TEXT

A tabela para consultar os logs. Se não for fornecida, será usada a tabela padrão.

--log-level TEXT

O nível de log a ser filtrado. Se não for fornecido, será usado INFO. Padrão: INFO.

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

O comando snow logs acessa uma tabela de eventos e recupera os logs de uma entidade especificada. Por padrão, o comando procura os logs na tabela de eventos padrão, que é SNOWFLAKE.TELEMETRY.EVENTS; no entanto, você pode selecionar uma tabela diferente com a opção --table. Para obter mais informações sobre tabelas de eventos e valores padrão, consulte Criação de uma tabela de eventos.

Você pode usar as opções --from e -to para filtrar o período durante o qual os logs serão recuperados. Você pode usar uma ou ambas as opções, mas se usar ambas, o horário de --from deve ser anterior ao horário de --to. Os valores de tempo fornecidos por você devem estar em conformidade com a norma ISO 8601. Para obter mais informações, você também pode consultar a documentação do método Python datetime.fromisoformat().

A opção --log-level permite que você filtre as mensagens pelo nível de gravidade. Alguns logs não incluem um nível de gravidade. Nesses casos, as mensagens são exibidas para todos os valores --log-level.

Se quiser atualizações contínuas para os logs, você pode usar a opção --refresh e fornecer o número de segundos entre as recuperações. Você não pode usar as opções --refresh e --to juntas. Para interromper a transmissão dos logs, use a tecla padrão do sistema Keyboardinterrupt, como CTRL-c em um Terminal Mac.

Exemplos

  • Exibir os logs do pool de computação para um período desde um horário inicial especificado até agora:

    snow logs compute_pool MY_COMPUTE_POOL --from '2025-04-01 09:00:31'
    
    Copy
    10.12.71.201 - - [01/Apr/2025 09:46:07] "GET /healthcheck HTTP/1.1" 200 -
    10.12.71.201 - - [01/Apr/2025 09:46:09] "GET /healthcheck HTTP/1.1" 200 -
    10.12.71.201 - - [01/Apr/2025 09:46:14] "GET /healthcheck HTTP/1.1" 200 -
    10.12.71.201 - - [01/Apr/2025 09:46:19] "GET /healthcheck HTTP/1.1" 200 -
    10.12.71.201 - - [01/Apr/2025 09:46:24] "GET /healthcheck HTTP/1.1" 200 -
    10.12.71.201 - - [01/Apr/2025 09:46:29] "GET /healthcheck HTTP/1.1" 200 -
    10.12.71.201 - - [01/Apr/2025 09:46:34] "GET /healthcheck HTTP/1.1" 200 -
    
  • Exibir os logs de uma tabela de eventos específica:

    snow logs compute_pool SNOWCLI_COMPUTE_POOL --table "my_db.my_schema.my_events"
    
    Copy
  • Exibir os logs para um intervalo de tempo em que a hora de início é posterior à hora de término, o que causa um erro:

    snow logs compute_pool SNOWCLI_COMPUTE_POOL --from '2025-03-24 12:00:31' --to "2024-01-03 00:00:00"
    
    Copy
    ╭─ Error ─────────────────────────────────────────────────────────
    │ From_time cannot be later than to_time. Please check the values
    ╰─────────────────────────────────────────────────────────────────