Suivi des composants Sync Framework

Sync Framework vous permet d'effectuer le suivi de l'exécution de plusieurs composants, ce qui s'avère utile pendant le débogage d'applications. Pour la plupart des composants Sync Framework, le suivi est effectué au niveau du code natif à l'aide de l'infrastructure de suivi d'événements pour Windows. Pour plus d'informations sur l'infrastructure ETW, consultez Event Tracing (en anglais).

Même si vous développez avec la version managée d'une API, vous utilisez toujours l'infrastructure de suivi d'événements pour Windows, car l'API managée est un wrapper fin sur l'API native. Les fournisseurs de bases de données Sync Framework proposent un suivi managé basé sur l'implémentation du .NET Framework. Pour plus d'informations, consultez Procédure : tracer le processus de synchronisation.

Téléchargement et utilisation des outils de suivi

Les outils de suivi requis par l'infrastructure de suivi d'événements pour Windows sont inclus dans les outils de support de Windows, qui sont disponibles pour chaque version de Windows. Par exemple, les outils pour Windows XP SP2 sont disponibles sur cette page du Centre de téléchargement Microsoft. Les outils qui concernent le suivi de Sync Framework sont décrits dans le tableau suivant :

Outil de suivi	Description	Référence de syntaxe
Tracelog.exe	Démarre, arrête ou active la journalisation du suivi.	Syntaxe de la commande Tracelog
Tracefmt.exe	Met en forme et affiche les messages de suivi à partir d'un fichier journal de suivi d'événements (.etl) ou d'une session de suivi en temps réel.	Tracefmt

Pour afficher le résultat d'un suivi, démarrez un journal de suivi, activez le suivi, puis mettez en forme le suivi pour affichage.

Pour démarrer un enregistreur d'événements de suivi

Pour démarrer un enregistreur d'événements de suivi, spécifiez un nom d'enregistreur d'événements, un nom de fichier de trace et plusieurs paramètres qui contrôlent la façon dont le fichier est écrit : tracelog.exe -start <LoggerName> <LoggerParameters> -f <PathToEtlFile>. Par exemple, la commande suivante peut être utilisée :

tracelog.exe -start "Sync" -paged -b 32 -max 100 -cir 20 -ls -f %TEMP%\SyncFramework.etl

Pour activer le suivi

Pour activer le suivi, spécifiez le GUID du composant qui doit faire l'objet d'un suivi, un masque de bits d'indicateurs qui signalent les sous-composants sur lesquels effectuer un suivi et un entier qui représente le niveau de suivi : tracelog.exe - enable <LoggerName> -guid <ComponentTracingId> -flags <Flags> -level <Level>. Dans cet exemple, nous activons le suivi du composant principal Sync Framework et de tous ses sous-composants, avec un niveau de suivi de 4 (messages d'information qui incluent des cas sans erreur) :

tracelog.exe -enable "Sync" -guid #5978339c-8ab2-467e-bb85-8832659d5ed0 -flags 0xffff -level 4

Pour obtenir une liste complète d'options pour Sync Framework, consultez Référence de suivi de Sync Framework dans cette rubrique.

Pour mettre en forme et afficher le fichier de trace

Pour afficher une trace, videz l'enregistreur d'événements et mettez en forme le fichier de trace binaire à l'aide des fichiers .tmf qui sont disponibles pour Sync Framework à partir du Centre de téléchargement Microsoft. Utilisez des commandes semblables aux suivantes pour afficher le suivi à partir de l'enregistreur d'événements Sync :

1. Pour vider l'enregistreur d'événements, exécutez tracelog.exe -flush "Sync".

2. Copiez les fichiers .tmf à partir du chemin d'accès d'installation de Sync Framework (Program Files\Microsoft SDKs\Microsoft Sync Framework\v2.0) vers un répertoire de travail, tel que %TEMP%\TMF.

3. Pour mettre en forme le fichier, exécutez tracefmt.exe %TEMP%\SyncFramework.etl -p %TEMP%\TMF -o %TEMP%\SyncFrameworkTrace.txt.

4. Pour afficher le fichier, ouvrez %TEMP%\SyncFrameworkTrace.txt.

Pour arrêter le suivi

Pour arrêter l'enregistreur d'événements Sync que nous avons démarré précédemment, exécutez tracelog.exe -stop "Sync".

Référence de suivi de Sync Framework

Le tableau suivant répertorie les GUID qui représentent chaque composant Sync Framework :

Composant	ID de suivi de composant
Infrastructure principale et exécutable	5978339c-8ab2-467e-bb85-8832659d5ed0
Fournisseurs simples	69c896b3-e183-428d-9e30-4b519b156828
Composants de synchronisation Web	0958c02f-01cb-4b28-badf-1431c83a931e
Service de stockage des métadonnées	67161b7f-60ff-4368-832e-670f2327a7e4
Fournisseur de synchronisation de fichiers	b5fac8e8-25e0-4468-926e-54cd8514f8a0

Indicateurs de suivi

Les tableaux suivants montrent les indicateurs de masque de bits qui peuvent être passés au paramètre -flags de tracelog.exe pour spécifier les sous-composants qui doivent faire l'objet d'un suivi :

Infrastructure principale et indicateurs d'exécutables

Nom de l'indicateur de suivi	Masque de bits	Description
TRACE_MSG_KNOWLEDGE	0x0001	Opérations de connaissance de synchronisation
TRACE_MSG_SYNC_SERVICES	0x0002	Services de synchronisation, tels que les services de synchronisation des applications et des fournisseurs
TRACE_MSG_SYNC_SESSION	0x0004	Session de synchronisation et état de la session de synchronisation
TRACE_MSG_CHANGE_APPLIER	0x0008	Applicateur de modifications de notification
TRACE_MSG_CHANGE_BATCH	0x0010	Lot de modifications
TRACE_MSG_CHANGE	0x0020	Modification individuelle
TRACE_MSG_FILTER	0x0040	Filtrage des modifications
TRACE_MSG_IN_MEMORY_CONFLICT_LOG	0x0080	Journal des conflits en mémoire
TRACE_MSG_CHANGE_APPLICATION_SERVICES	0x0100	Services d'application de modifications avancés

Indicateurs de fournisseurs simples

Nom de l'indicateur de suivi	Masque de bits	Description
TRACE_MSG_SIMPLESYNCWRAPPER	0x0001	Fournisseurs simples (aucun sous-composant n'est défini)

Indicateurs de composants de synchronisation Web

Nom de l'indicateur de suivi	Masque de bits	Description
TRACE_MSG_FEEDSYNC	0x0001	Composants de synchronisation Web (aucun sous-composant n'est défini)

Indicateurs du service de stockage des métadonnées

Nom de l'indicateur de suivi	Masque de bits	Description
TRACE_MSG_METADATA_STORE	0x0001	Service de stockage des métadonnées (aucun sous-composant n'est défini)

Indicateurs du fournisseur de synchronisation de fichiers

Nom de l'indicateur de suivi	Masque de bits	Description
TRACE_MSG_FSP	0x0001	Fournisseur de synchronisation de fichiers (aucun sous-composant n'est défini)

Niveaux de suivi

Le tableau suivant répertorie les niveaux de suivi qui sont utilisés par Sync Framework. Une augmentation du niveau représente une augmentation des commentaires de journalisation, et les niveaux sont cumulatifs. Par exemple, un suivi de niveau 4 contient toutes les informations des niveaux 1 à 3 et d'autres informations :

Niveau de suivi	Valeur	Description
TRACE_LEVEL_NONE	0	Aucun suivi
TRACE_LEVEL_CRITICAL	1	Fin ou fermeture anormale
TRACE_LEVEL_ERROR	2	Erreurs graves
TRACE_LEVEL_WARNING	3	Avertissements qui peuvent révéler des problèmes
TRACE_LEVEL_INFORMATION	4	Informations qui incluent des cas sans erreur
TRACE_LEVEL_METADATA_INFORMATION	5	Informations sur les métadonnées de synchronisation
TRACE_LEVEL_FUNCTION	6	Informations sur le moment où chaque fonction est lancée et arrêtée

Voir aussi

Concepts

Dépannage de Sync Framework