Configurer la journalisation et le traçage des événements pour une application¶

À propos des messages de journal et des événements de trace dans une application¶

Snowflake Native App Framework prend en charge l’utilisation de la journalisation et du traçage Snowflake permettant de collecter des informations sur une application. Les fournisseurs peuvent configurer une application pour enregistrer et analyser les éléments suivants :

• Messages de journal - Messages indépendants et détaillés contenant des informations sur l’état d’un élément spécifique de code d’application.

• Événements de trace - Données structurées que les fournisseurs peuvent utiliser pour obtenir des informations couvrant et regroupant plusieurs parties de votre code. Les événements de trace permettent à une application d’émettre des informations liées à ses performances et à son comportement.

Pour configurer une application afin d’émettre des messages de journal et des événements de trace, les fournisseurs définissent les niveaux de journal et de trace dans le fichier manifeste. Voir Définir les niveaux de journalisation et de trace pour une application.

Les fournisseurs peuvent également configurer une application pour utiliser le partage d’événements afin de permettre au consommateur de partager les messages du journal et de suivre les événements avec le fournisseur. Consultez À propos du partage d’événements pour plus d’informations.

À propos du partage d’événements¶

Le partage d’événements permet au fournisseur de collecter des informations sur les performances et le comportement d’une application. Un fournisseur peut configurer une application pour demander aux consommateurs de partager les messages de journal et les événements de trace avec le fournisseur. Le partage d’événements nécessite que le fournisseur et le consommateur configurent une table d’événements dans leur compte pour stocker les messages de journal et les événements de trace émis par l’application.

Lorsque le partage d’événements est activé, les messages de journal et les événements de trace insérés dans la table d’événements du compte consommateur sont également insérés dans la table d’événements du compte fournisseur.

Considérations lors de l’utilisation du partage d’événements¶

Avant de configurer la journalisation et le partage d’événements pour une application, les fournisseurs doivent prendre en compte les éléments suivants :

• Les fournisseurs sont responsables 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.

• Les fournisseurs doivent 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.

• Les fournisseurs doivent définir le niveau de journalisation et le niveau de trace par défaut pour une application dans le fichier manifeste.

Considérations à prendre en compte lors de la migration depuis l’ancienne fonctionnalité de partage d’événements¶

Lors de la migration de la fonctionnalité de partage d’événements existante vers l’utilisation de définitions d’événements, les fournisseurs doivent prendre en compte les éléments suivants.

• La fonctionnalité de partage d’événements précédente est équivalente à la définition d’événement OPTIONAL ALL.

• Les versions publiées et les correctifs d’une application qui utilisaient la fonctionnalité précédente auront la définition d’événement OPTIONAL ALL par défaut. Les fournisseurs n’ont pas besoin d’ajouter cette définition d’événement au fichier manifeste.

Pour commencer à utiliser les définitions d’événements, les fournisseurs peuvent ajouter des définitions d’événements prises en charge au fichier manifeste. Ceci s’applique aux nouvelles applications ainsi qu’aux nouvelles versions et correctifs des applications existantes.

Flux de travail - Configurer le partage d’événements pour une application¶

Le partage d’événements permet aux consommateurs de partager des messages de journal et de suivre les événements avec le fournisseur.

Le flux de travail suivant montre comment configurer et activer le partage d’événements pour une application :

1. Le fournisseur définit les niveaux de journal et de trace pour l’application.

2. Le fournisseur ajoute des définitions d’événements au fichier manifeste.

   Les définitions d’événements agissent comme des filtres sur les messages de journal et les événements de trace émis par l’application. Les fournisseurs peuvent configurer les définitions d’événements comme étant obligatoires ou facultatives.

3. Le fournisseur met en place une table d’événements dans son organisation.

4. Le fournisseur publie l’application.

Lorsqu’un consommateur installe une application, il peut configurer une table d’événements et activer le partage d’événements. Voir Activer la journalisation et le partage d’événements pour une application pour plus d’informations sur les exigences des consommateurs en matière de partage d’événements.