Contrôle et suppression du suivi côté client Kusto SDK

Article
02/03/2025

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer

Les bibliothèques clientes Kusto sont instrumentées pour écrire des traces dans des fichiers locaux. Par défaut, le mécanisme de suivi est désactivé, mais peut être activé par programme.

Activer le suivi

Pour activer le suivi, vérifiez que le package NuGet Microsoft.Azure.Kusto.Cloud.Platform installé. Exécutez ensuite le code suivant :

using Kusto.Cloud.Platform.Utils; // Requires the NuGet package, Microsoft.Azure.Kusto.Cloud.Platform.

var manifest = new RollingCsvTraceListener2Manifest
{
  TracesLocalRootPath=@"c:\temp" // The folder where trace files will be written.
};
RollingCsvTraceListener2.CreateAndInitialize(manifest);
TraceSourceManager.StartupDone();

Contrôler le niveau de trace

Chaque source de trace de la bibliothèque peut avoir son propre niveau de détail par défaut. Une source de trace écrit uniquement dans des traces de fichiers dont la détail est égale ou supérieure à son propre niveau de détail. Vous pouvez contrôler la détail des sources de trace. L’exemple suivant définit le niveau de détail de toutes les sources de trace sur Verbose, ce qui garantit que toutes les traces sont écrites dans des fichiers :

using Kusto.Cloud.Platform.Utils; // Requires the NuGet package, Microsoft.Azure.Kusto.Cloud.Platform.

TraceSourceManager.SetOverrideTraceVerbosityLevel(TraceVerbosity.Verbose);

Utilisez l’argument TraceVerbosity.Fatal pour tracer uniquement les événements les plus graves.

Vider toutes les traces en attente

Le vidage de la trace en attente est recommandé lorsque l’application hébergeant le système de trace est fermée pour s’assurer que les traces non écrites sont enregistrées. Elle peut être effectuée en toute sécurité même si le système de suivi n’est pas initialisé. Le code suivant force toutes les traces en attente à vider dans les fichiers et à recycler tous les fichiers :

TraceSourceManager.SuperFlush(SuperFlushMode.Emergency);

Activer le suivi MSAL (Bibliothèque d’authentification Microsoft)

L’activation du suivi pour les bibliothèques clientes active automatiquement le suivi pour MSAL (bibliothèque d’authentification Microsoft).

Lire les fichiers de trace

Une fois le système de suivi initialisé, les fichiers de trace sont écrits dans le dossier spécifié ou dans ses sous-dossiers. Ils sont mis en forme en tant que fichiers CSV avec l’extension .csv. Les fichiers en cours d’écriture utilisent l’extension .csv.in-progress et sont automatiquement renommés une fois qu’ils sont terminés.

Chaque enregistrement de fichier de trace inclut les champs suivants :

identificateur d’enregistrement de trace : identifie de manière unique chaque enregistrement de trace.
Timestamp : l’horodatage de l’enregistrement de trace.
nom de la source de trace : Nom de la source de trace.
niveau de trace : niveau de détail de la trace.
contenu textuel : contenu de l’enregistrement de trace.

Partager via