Événements de service snow spcs

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érez les événements de la plateforme pour un conteneur de service.

Syntaxe

snow spcs service events
  <name>
  --container-name <container_name>
  --instance-id <instance_id>
  --since <since>
  --until <until>
  --first <first>
  --last <last>
  --all
  --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
Copy

Arguments

name

Identificateur du service ; par exemple : my_service.

Options

--container-name TEXT

Nom du conteneur.

--instance-id TEXT

ID de l’instance de service, commençant par 0.

--since TEXT

Extrayez les événements qui se sont produits après ce délai, dans la syntaxe d’intervalle Snowflake.

--until TEXT

Extrayez les événements qui se sont produits avant ce délai, dans la syntaxe d’intervalle Snowflake.

--first INTEGER

Extrayez uniquement les N premiers événements. Ne peut pas être utilisé avec –last.

--last INTEGER

Extrayez uniquement les N derniers événements. Ne peut pas être utilisé avec –first.

--all

Extrayez toutes les colonnes. Par défaut : false.

--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 d’accès au fichier contenant le jeton OAuth à utiliser 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 une connexion définie avec les paramètres de la ligne de commande, au lieu d’une connexion 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

Note

Pour utiliser cette commande, vous devez activer la fonction enable_spcs_service_events dans votre fichier config.toml, comme indiqué :

[cli.features]
enable_spcs_service_events = true
Copy
  • Les paramètres suivants sont requis :

    • name

    • --container-name <name>

    • --instance-id <ID>

  • Vous pouvez utiliser les filtres basés sur le temps --since et --until pour renvoyer les événements d’une période donnée. Vous pouvez spécifier l’heure en tant qu’heure relative, comme 1h (heure) ou 2d (jours).

  • Vous pouvez utiliser les options --first et --last pour ne renvoyer qu’un nombre spécifié d’événements. Notez que ces options s’excluent mutuellement.

Exemples

  • Récupérez tous les événements pour un service spécifique :

    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0
    
    Copy
  • Récupérez un sous-ensemble d’événements pour un service spécifique :

    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --first 5
    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --last 5
    
    Copy
  • Extrayez les événements plus récents que les cinq dernières minutes :

    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --since '5 minutes'
    
    Copy
  • Extrayez les événements datant de plus d’une heure :

    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --until '1 hour'
    
    Copy
  • Récupérez tous les événements dont toutes les colonnes sont affichées :

    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --all --last 1
    
    Copy
    TIMESTAMP | DATABASE NAME | SCHEMA NAME | SERVICE NAME | INSTANCE NAME | CONTAINER NAME | SEVERITY | EVENT NAME | EVENT VALUE
    -- | -- | -- | -- | -- | -- | -- | -- | --
    2024-12-13 10:01:52.808692 | TESTDB | PUBLIC | LOG_EVENT | 0 | log-printer | INFO | CONTAINER.STATUS_CHANGE | { "message": "Running", "status": "READY" }
    2024-12-14 22:27:25.420489 | TESTDB | PUBLIC | LOG_EVENT | 0 | log-printer | INFO | CONTAINER.STATUS_CHANGE | { "message": "Running", "status": "READY" }
    
  • Récupérez les événements formatés pour la sortie JSON :

    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --last 1 --format json
    
    Copy
    [
         {
             "TIMESTAMP": "2024-12-14T22:27:25.420489",
             "DATABASE NAME": "TESTDB",
             "SCHEMA NAME": "PUBLIC",
             "SERVICE NAME": "LOG_EVENT",
             "INSTANCE NAME": "0",
             "CONTAINER NAME": "log-printer",
             "SEVERITY": "INFO",
             "EVENT NAME": "CONTAINER.STATUS_CHANGE",
             "EVENT VALUE": "{\n  \"message\": \"Running\",\n  \"status\": \"READY\"\n}"
         }
     ]