snow spcs service logs¶
Nota
Você pode usar os Snowpark Container Services da Snowflake CLI somente se você tiver as permissões necessárias para usar o Snowpark Container Services.
Recupera logs locais de um contêiner de serviço.
Sintaxe¶
snow spcs service logs
<name>
--container-name <container_name>
--instance-id <instance_id>
--num-lines <num_lines>
--previous-logs
--since <since_timestamp>
--include-timestamps
--follow
--follow-interval <follow_interval>
--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¶
name
Identificador do serviço; por exemplo: meu_serviço.
Opções¶
--container-name TEXT
Nome do contêiner.
--instance-id TEXT
ID da instância de serviço, começando com 0.
--num-lines INTEGER
Número de linhas a serem recuperadas. Padrão: 500.
--previous-logs
Recupere os logs do último contêiner encerrado. Padrão: falso.
--since TEXT
Inicie a recuperação de logs a partir de um carimbo de data/hora especificado em UTC.
--include-timestamps
Inclua carimbos de data/hora nos logs. Padrão: falso.
--follow
Transmita os logs em tempo real. Padrão: falso.
--follow-interval INTEGER
Defina intervalos de sondagem personalizados para transmissão de logs (sinalizador –follow) em segundos. Padrão: 2.
--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 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.
--help
Exibe o texto de ajuda para este comando.
Notas de uso¶
A função atual deve ter o privilégio MONITOR no serviço para acessar os logs do contêiner.
A função retorna um log de contêiner como uma cadeia de caracteres.
Ao usar a opção
--follow
para streaming de log em tempo real, as opções--num-lines
e--previous-logs
não são suportadas.
Exemplos¶
O exemplo a seguir exibe as três últimas linhas dos logs
echo_service
:snow spcs service logs echo_service --container-name echo --instance-id 0 --num-lines 3
10.18.94.31 - - [22/Nov/2024 09:16:47] "GET /healthcheck HTTP/1.1" 200 - 10.18.94.31 - - [22/Nov/2024 09:16:52] "GET /healthcheck HTTP/1.1" 200 - 10.18.94.31 - - [22/Nov/2024 09:16:57] "GET /healthcheck HTTP/1.1" 200 -
Este exemplo transmite os logs do serviço
echo_service
e os atualiza a cada 10 segundos:snow spcs service logs echo_service --container-name echo --instance-id 0 --follow --follow-interval 10
O exemplo a seguir exibe as entradas de log desde 9:30 UTC, 21 de novembro de 2024:
snow spcs service logs echo_service --container-name echo --instance-id 0 --since 2024-11-21T09:30:00Z
O exemplo a seguir recupera os logs do último contêiner encerrado:
snow spcs service logs example_job_service --container-name main --instance-id 0 --previous-logs