Configuration de la journalisation et du partage d’événements pour une application¶

Workflow de configuration de la journalisation et du partage d’événements en tant que fournisseur¶

En tant que fournisseur, vous pouvez configurer la journalisation et le partage d’événements pour une application en procédant comme suit :

1. Passez en revue les considérations relatives à l’utilisation de la journalisation et du partage d’événements.

2. Configurez la journalisation et les événements de traçage pour les fonctions et les procédures stockées.

3. Définissez le niveau de journalisation et de traçage dans le fichier manifeste.

4. Configurez un compte pour stocker les événements partagés.

Une fois que le consommateur a installé une application et activé la journalisation et le partage d’événements, vous pouvez voir les informations de journalisation et d’événements partagées par l’application installée :

• Voir le niveau de journalisation et de traçage.

• Voir les journaux et les événements dans la table des événements.

Considérations relatives à l’utilisation de la journalisation et du partage d’événements¶

Avant d’utiliser la journalisation et le partage d’événements pour une application, vous devez tenir compte des points suivants :

• Vous êtes responsable de tous les coûts associés au partage d’événements du côté du fournisseur, y compris l’ingestion et le stockage des données.

• Vous devez avoir un compte pour stocker des événements partagés dans chaque région où vous souhaitez prendre en charge le partage d’événements.

• Vous devez définir le niveau de journalisation et le niveau de traçage par défaut pour une application dans le fichier manifeste.

Configuration de la journalisation et des événements de traçage dans les fonctions et les procédures¶

Le Native Apps Framework nécessite une table d’événements pour stocker les messages de journal et les événements de traçage générés par les fonctions et les procédures stockées dans une application.

Un compte peut avoir plusieurs tables d’événements, mais une seule d’entre elles peut être définie comme table d’événements active pour un compte Snowflake à la fois. Sans table d’événements active, les messages de journal et les événements de traçage générés par l’application ne sont pas capturés. Cela est vrai même si les fonctions et procédures d’une application appellent les APIs d’événements de journalisation et de traçage.

Pour créer une table d’événements, utilisez la commande CREATE EVENT TABLE. Pour plus d’informations, reportez-vous à Configuration d’une table d’événement.

Une fois que le code a enregistré les messages du journal et les événements de traçage, vous pouvez interroger les données enregistrées.

Pour plus d’informations sur l’enregistrement et l’interrogation des données de journal et de traçage, reportez-vous à ce qui suit :

• Enregistrement de messages à partir de fonctions et de procédures.

• Événements de trace pour les fonctions et les procédures.

Définition du niveau de journalisation et de traçage dans le fichier manifeste¶

Pour définir les niveaux de journalisation et de traçage par défaut pour une version d’une application, définissez les paramètres log_level et trace_level dans le fichier manifeste, comme indiqué dans l’exemple suivant :

artifacts:
  setup_script: setup.sql
configuration:
  trace_level: OFF
  log_level: DEBUG

Lorsqu’un fournisseur active le traçage, une Snowflake Native App capture automatiquement les heures de début et de fin de toutes les requêtes et de tous les appels de procédures stockées.

Reportez-vous à Réglage du niveau de trace et Réglage du niveau de journalisation pour obtenir des informations sur les valeurs prises en charge pour trace_level et log_level.

Lors de son installation initiale, l”Snowflake Native App utilise les niveaux de journalisation définis dans le fichier manifeste. Si le niveau de journalisation est modifié lors d’une mise à niveau ultérieure, le nouveau niveau de journalisation prend effet après la fin du processus de mise à niveau.

Le niveau de journalisation et de traçage ne peut être défini que dans le fichier manifeste. Le consommateur n’est pas autorisé à modifier le niveau de journalisation à l’aide des commandes ALTER APPLICATION ou ALTER DATABASE.

De même, tout paramètre de niveau de session pour le niveau de journalisation est ignoré par l’application.

Configuration d’un compte pour stocker des événements partagés¶

Pour stocker les journaux et les événements partagés, vous devez sélectionner un compte qui contiendra une table d’événements. Il peut s’agir de n’importe quel compte auquel un fournisseur peut accéder. Toutefois, si votre organisation compte plusieurs fournisseurs publiant des paquets d’applications, envisagez d’utiliser un compte Snowflake dédié au stockage des événements partagés du consommateur.

Les restrictions suivantes s’appliquent au compte des événements partagés :

• Vous devez utiliser le rôle ORGADMIN pour définir un compte comme compte d’événements.

• Le compte doit avoir une table d’événements actifs.

• Le compte spécifié ne peut pas être :

  • Un compte bloqué ou suspendu.

  • Un compte de lecteurs.

  • Un compte d’essai.

  • Un compte géré par Snowflake.

CALL SYSTEM$SET_EVENT_SHARING_ACCOUNT_FOR_REGION('<snowflake_region>', '<region_group>', '<account_name>')

CALL SYSTEM$UNSET_EVENT_SHARING_ACCOUNT_FOR_REGION('<snowflake_region>', '<region_group>', '<account_name>')

CALL SYSTEM$SHOW_EVENT_SHARING_ACCOUNTS()

Vue des niveaux de journalisation et de traçage définis dans un paquet d’application¶

Utilisez la commande DESCRIBE APPLICATION pour afficher le niveau de journalisation d’une application installée, comme le montre la commande suivante :

DESC APPLICATION HelloSnowflake;

Utilisez la commande SHOW VERSIONS pour voir le niveau de journalisation des versions d’application définies dans un paquet d’application, comme le montre l’exemple suivant :

SHOW VERSIONS
  IN APPLICATION PACKAGE HelloSnowflake;

Vue des journaux et des événements dans la table des événements¶

Pour voir les journaux et les événements stockés dans la table des événements, utilisez la commande SELECT comme indiqué dans l’exemple suivant :

SELECT * FROM EVENT_DB.EVENT_SCHEMA.MY_EVENT_TABLE

Informations sur les événements partagés disponibles par le fournisseur¶

Les sections suivantes décrivent les informations que le Native Apps Framework partage avec les fournisseurs.