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>
--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¶
Aucun
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é de l’application sur laquelle opérer lorsque definition_version est la 2 ou supérieure.
-p, --project TEXT
Chemin où réside le projet Snowflake. 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.
--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¶
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
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
Récupérez les événements pour une installation consommateur.
snow app events --consumer-org <organization-name> --consumer-account <account-name>
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
Récupérez les événements comme JSON.
snow app events --format json