snow spcs service logs¶
Note
Vous pouvez utiliser Snowpark Container Services à partir de Snowflake CLI uniquement si vous disposez des autorisations nécessaires pour utiliser Snowpark Container Services.
Récupère les journaux locaux d’un conteneur de service.
Syntaxe¶
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
Arguments¶
name
Identificateur du service ; par exemple : mon_service.
Options¶
--container-name TEXT
Nom du conteneur.
--instance-id TEXT
ID de l’instance de service, commençant par 0.
--num-lines INTEGER
Nombre de lignes à récupérer. Par défaut : 500.
--previous-logs
Récupérez les journaux du dernier conteneur terminé. Par défaut : false.
--since TEXT
Commencez à récupérer les journaux à partir d’un horodatage UTC spécifié.
--include-timestamps
Incluez les horodatages dans les journaux. Par défaut : false.
--follow
Diffusez les journaux en temps réel. Par défaut : false.
--follow-interval INTEGER
Définissez des intervalles d’interrogation personnalisés pour le flux de journaux (–follow flag) en secondes. Par défaut : 2
--connection, -c, --environment TEXT
Nom de la connexion, tel que défini dans votre fichier
config.toml
. Défaut :défaut
.--host TEXT
Adresse de l’hôte pour la connexion. Remplace la valeur spécifiée pour la connexion.
--port INTEGER
Port pour la connexion. Remplace la valeur spécifiée pour la connexion.
--account, --accountname TEXT
Nom attribué à votre compte Snowflake. Remplace la valeur spécifiée pour la connexion.
--user, --username TEXT
Nom d’utilisateur pour se connecter à Snowflake. Remplace la valeur spécifiée pour la connexion.
--password TEXT
Mot de passe Snowflake. Remplace la valeur spécifiée pour la connexion.
--authenticator TEXT
Authentificateur Snowflake. Remplace la valeur spécifiée pour la connexion.
--private-key-file, --private-key-path TEXT
Chemin du fichier de clé privée Snowflake. Remplace la valeur spécifiée pour la connexion.
--token-file-path TEXT
Chemin vers un fichier avec un jeton OAuth qui doit être utilisé lors de la connexion à Snowflake.
--database, --dbname TEXT
Base de données à utiliser. Remplace la valeur spécifiée pour la connexion.
--schema, --schemaname TEXT
Schéma de la base de données à utiliser. Remplace la valeur spécifiée pour la connexion.
--role, --rolename TEXT
Rôle à utiliser. Remplace la valeur spécifiée pour la connexion.
--warehouse TEXT
Entrepôt à utiliser. Remplace la valeur spécifiée pour la connexion.
--temporary-connection, -x
Utilise la connexion définie avec les paramètres de la ligne de commande, au lieu de celle définie dans la configuration. Par défaut : false.
--mfa-passcode TEXT
Jeton à utiliser pour l’authentification multifactorielle (MFA)
--enable-diag
Exécutez le test de diagnostic du Python Connector. Par défaut : false.
--diag-log-path TEXT
Chemin d’accès au rapport de diagnostic. Par défaut : <temporary_directory>.
--diag-allowlist-path TEXT
Chemin d’accès au rapport de diagnostic vers la liste d’autorisations facultative.
--format [TABLE|JSON]
Spécifie le format de sortie. Par défaut : TABLE.
--verbose, -v
Affiche les entrées de journal pour les niveaux de journalisation
info
et supérieurs. Par défaut : false.--debug
Affiche les entrées de journal pour les niveaux de journalisation
debug
et supérieurs ; les journaux de débogage contiennent des informations supplémentaires. Par défaut : false.--silent
Désactive la sortie intermédiaire vers la console. Par défaut : false.
--help
Affiche le texte d’aide de cette commande.
Notes sur l’utilisation¶
Le rôle actuel doit avoir le privilège MONITOR sur le service pour accéder aux journaux des conteneurs.
La fonction renvoie un journal de conteneur sous la forme d’une chaîne.
Lorsque vous utilisez l’option
--follow
pour le flux de journaux en temps réel, les options--num-lines
et--previous-logs
ne sont pas prises en charge.
Exemples¶
L’exemple suivant affiche les trois dernières lignes des journaux
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 -
Dans cet exemple, les journaux du service :codenowrap :
echo_service
sont connectés en flux et mis à jour toutes les 10 secondes :snow spcs service logs echo_service --container-name echo --instance-id 0 --follow --follow-interval 10
L’exemple suivant affiche les entrées de journal depuis 9h30 UTC, le 21 nov 2024 :
snow spcs service logs echo_service --container-name echo --instance-id 0 --since 2024-11-21T09:30:00Z
L’exemple suivant récupère les journaux du dernier conteneur terminé :
snow spcs service logs example_job_service --container-name main --instance-id 0 --previous-logs