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
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'
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"
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"
╭─ Error ───────────────────────────────────────────────────────── │ From_time cannot be later than to_time. Please check the values ╰─────────────────────────────────────────────────────────────────