snow app events¶

Extrait les événements pour cette application à partir de la table d’événements configurée dans Snowflake. Par défaut, cette commande récupérera les événements générés par une application installée dans le compte de la connexion actuelle. Pour extraire les événements générés par une application installée dans un compte consommateur, utilisez les options –consumer-org et –consumer-account. Cela nécessite que le partage d’événements soit configuré pour acheminer les événements vers le compte du fournisseur : https://docs.snowflake.com/en/developer-guide/native-apps/setting-up-logging-and-events

Syntaxe¶

snow app events
  --since <since>
  --until <until>
  --type <record_types>
  --scope <scopes>
  --consumer-org <consumer_org>
  --consumer-account <consumer_account>
  --consumer-app-hash <consumer_app_hash>
  --first <first>
  --last <last>
  --follow
  --follow-interval <follow_interval>
  --package-entity-id <package_entity_id>
  --app-entity-id <app_entity_id>
  --project <project_definition>
  --env <env_overrides>
  --connection <connection>
  --host <host>
  --port <port>
  --account <account>
  --user <user>
  --password <password>
  --authenticator <authenticator>
  --workload-identity-provider <workload_identity_provider>
  --private-key-file <private_key_file>
  --token <token>
  --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

Arguments¶

Aucun(e)

Options¶

--since TEXT: Extrayez les événements plus récents qu’il y a un instant, dans la syntaxe d’intervalle Snowflake.
--until TEXT: Extrayez les événements plus anciens qu’il y a un instant, dans la syntaxe d’intervalle Snowflake.
--type [log |span| span_event]: Limitez les résultats à un type d’enregistrement spécifique. Cela peut être spécifié plusieurs fois. Par défaut : [].
--scope TEXT: Limiter les résultats à un nom de portée spécifique. Cela peut être spécifié plusieurs fois. Par défaut : [].
--consumer-org TEXT: Nom de l’organisation du consommateur.
--consumer-account TEXT: Nom du compte consommateur dans l’organisation.
--consumer-app-hash TEXT: Le hachage SHA-1 du nom de l’application consommateur.
--first INTEGER: Extrayez uniquement les N premiers événements. Ne peut pas être utilisé avec –last. Par défaut : -1.
--last INTEGER: Extrayez uniquement les N derniers événements. Ne peut pas être utilisé avec –first. Par défaut : -1.
--follow, -f: Continuez à sonder les événements. Implique –last 20 sauf si remplacé ou si l’indicateur –since est utilisé. Par défaut : false.
--follow-interval INTEGER: Intervalle d’interrogation en secondes lors de l’utilisation de l’indicateur –follow. Par défaut : 10.
--package-entity-id TEXT: L’ID de l’entité du paquet sur laquelle opérer lorsque definition_version est la 2 ou supérieure.
--app-entity-id TEXT: L’ID de l’entité d’application sur laquelle opérer la definition_version est la 2 ou supérieure.
-p, --project TEXT: Chemin où le projet Snowflake est stocké. La valeur par défaut est le répertoire de travail actuel.
--env TEXT: Chaîne au format clé=valeur. Remplace les variables de la section env utilisées pour les modèles. Par défaut : [].
--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.
--workload-identity-provider TEXT: Fournisseur d’identité de charge de travail (AWS, AZURE, GCP, OIDC). 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 TEXT: Jeton OAuth à utiliser lors de la connexion à Snowflake.
--token-file-path TEXT: Chemin d’accès au fichier contenant un 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: Indique s’il faut générer un rapport de diagnostic de la connexion. Par défaut : false.
--diag-log-path TEXT: Chemin d’accès au rapport généré. Il s’agit du répertoire temporaire du système par défaut. Par défaut : <system_temporary_directory>.
--diag-allowlist-path TEXT: Chemin d’accès à un fichier JSON contenant les paramètres de la liste d’autorisations.
--oauth-client-id TEXT: Valeur de l’identifiant du client fourni par le fournisseur d’identité pour l’intégration dans Snowflake.
--oauth-client-secret TEXT: Valeur du secret du client fourni par le fournisseur d’identité pour l’intégration dans Snowflake.
--oauth-authorization-url TEXT: Point de terminaison du fournisseur d’identité fournissant le code d’autorisation au pilote.
--oauth-token-request-url TEXT: Point de terminaison du fournisseur d’identité fournissant les jetons d’accès au pilote.
--oauth-redirect-uri TEXT: URI à utiliser pour la redirection du code d’autorisation.
--oauth-scope TEXT: Champ d’application demandé dans la requête d’autorisation du fournisseur d’identité.
--oauth-disable-pkce: Désactive la clé de preuve pour l’échange de code (PKCE). Par défaut : False.
--oauth-enable-refresh-tokens: Permet une réauthentification silencieuse lorsque le jeton d’accès actuel n’est plus valable. Par défaut : False.
--oauth-enable-single-use-refresh-tokens: Indique s’il faut choisir une sémantique de jeton d’actualisation à usage unique. Par défaut : False.
--client-store-temporary-credential: Enregistrez les identifiants de connexion temporaires.
--format [TABLE|JSON|JSON_EXT|CSV]: 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.
--enhanced-exit-codes: Différenciez les codes d’erreur de sortie en fonction du type d’erreur. Par défaut : false.

--help: Affiche le texte d’aide de cette commande.

Notes sur l’utilisation¶

Note

Avant d’utiliser cette commande, vous devez configurer la gestion des événements pour le compte fournisseur Snowflake. Pour plus d’informations, voir Journalisation, traçage et métriques.

La commande snow app events récupère les événements générés par une application native installée dans le compte de la connexion actuelle.

Par défaut, cette commande récupérera les événements générés par une Snowflake Native App installée dans le compte de la connexion actuelle. Pour extraire les événements générés par une Snowflake Native App installée dans un compte consommateur, utilisez les options --consumer-org et --consumer-account. Ces options nécessitent le partage d’événements pour être configurées pour acheminer les événements vers le compte du fournisseur.

Exemples¶

Récupérez tous les événements d’une application installée dans le compte fournisseur.
```
snow app events
```
Copy

Récupérez un sous-ensemble d’événements pour une application installée dans le compte fournisseur.

# Limiting the number of events
snow app events --first 10
snow app events --last 10

# Narrowing the time range using interval syntax
snow app events --since '5 minutes'
snow app events --until '1 hour'

# Filtering events
snow app events --type log
snow app events --scope com.myapp.MyClass1 --scope com.myapp.MyClass2

Copy

Récupérez les événements pour une installation consommateur.

snow app events --consumer-org <organization-name> --consumer-account <account-name>

Copy

Récupérez les événements d’une application consommateur à l’aide du nom d’application haché.

snow app events --consumer-org <organization-name> --consumer-account <account-name> --consumer-app-hash cafc10bf6a5deb574ada0e3a009b63bbbe9bdb84

Copy

Récupérez les événements comme JSON.
```
snow app events --format json
```
Copy