Préfixe de message de trace
Tracefmt ajoute un préfixe à chaque message de trace qui se compose de données stockées dans le fichier journal de trace des événements (.etl) et le fichier de format de message de trace (.tmf).
Tracefmt inclut des éléments de données particuliers par défaut, mais les utilisateurs peuvent ajouter et supprimer des éléments en modifiant la variable d’environnement %TRACE_FORMAT_PREFIX%, chaîne qui spécifie une définition de message compatible avec FormatMessage.
Le format du préfixe de message de trace par défaut est le suivant :
[%9!d!]%8!04X!.%3!04X!::%4!s! [%1!s!]
qui produit le préfixe suivant :
[CPUNumber]ProcessID.ThreadID :: SystemTime [MessageGUIDFriendlyName]
Chaque variable %n représente un paramètre décrit dans le tableau suivant.
| Identificateur de variable de préfixe | Type de variable | Description |
|---|---|---|
%1 |
string |
Nom convivial du GUID de message du message de trace. Par défaut, le nom convivial d’un GUID de message est le nom du répertoire dans lequel le fournisseur de trace a été créé. Pour modifier le nom convivial du GUID du message, utilisez le paramètre -p avec Tracewpp ou avec la macro RUN_WPP. Pour plus d’informations, consultez Options Run_WPP. |
%2 |
string |
Fichier source et numéro de ligne. Cette variable représente le nom convivial du message de trace. Par défaut, le nom convivial d’un message de trace est le nom du fichier source et le numéro de ligne du code qui a généré le message de trace. |
%3 |
ULONG |
ID de thread. Identifie le thread qui a généré le message de trace. |
4 |
string |
Horodatage de l’heure à laquelle le message de trace a été généré. |
%5 |
string |
Heure du noyau. Affiche le temps d’exécution écoulé pour l’instruction en mode noyau, en cycles du processeur, au moment où le message de trace a été généré. |
%6 |
string |
Temps utilisateur. Affiche le temps d’exécution écoulé pour l’instruction en mode utilisateur, en cycles du processeur, au moment où le message de trace a été généré. |
%7 |
LONG |
Numéro de séquence. Affiche le numéro séquentiel local ou global du message de trace. Les numéros de séquence locaux, qui sont uniques uniquement à cette session de trace, sont les numéros par défaut. |
%8 |
ULONG |
ID de processus. Identifie le processus qui a généré le message de trace. |
%9 |
ULONG |
Numéro de processeur. Identifie le processeur sur lequel le message de trace a été généré. |
%! FUNC! |
string |
Le nom de la fonction Affiche le nom de la fonction qui a généré le message de trace. |
%! DRAPEAUX! |
string |
Affiche le nom des indicateurs de trace qui activent le message de trace. (Étant donné que la macro DoTraceMessage inverse les indicateurs et les arguments de niveau, les messages générés par DoTraceMessage affichent la valeur du niveau de trace dans ce champ.) |
%! NIVEAU! |
string |
Affiche la valeur du niveau de trace qui active le message de trace. (Étant donné que la macro DoTraceMessage inverse les indicateurs et les arguments de niveau, les messages générés par DoTraceMessage affichent le nom des indicateurs de trace dans ce champ.) |
%! COMPNAME! |
string |
Nom du composant. Affiche le nom du composant du fournisseur qui a généré le message de trace. Le nom du composant apparaît uniquement s’il est spécifié dans le code de suivi. |
%! SUBCOMP! |
string |
Nom du sous-composant. Affiche le nom du sous-composant du fournisseur qui a généré le message de trace. Le nom du composant apparaît uniquement s’il est spécifié dans le code de suivi. |
Le symbole dans les points d’exclamation est un caractère de conversion qui spécifie la mise en forme et la précision de la variable. Par exemple, %8!04X! spécifie l’ID de processus représenté sous la forme d’un nombre hexadécimal non signé à quatre chiffres. Ces caractères de conversion doivent être inclus.
Pour modifier les éléments, l’ordre ou la mise en forme du préfixe de message de trace, utilisez la variable d’environnement %TRACE_FORMAT_PREFIX%. Pour obtenir un exemple, consultez Exemple 7 : Personnalisation du préfixe de message de trace.
Pour obtenir un exemple de contenu dans un fichier TMF, consultez Mise en forme des messages de trace à partir de l’exemple tracedrv.
En outre, le paramètre -csv ajoute un préfixe détaillé non configuré à chaque message de trace avant le préfixe Tracefmt standard. Pour obtenir une description des champs dans le préfixe CSV, utilisez le paramètre -csvheader .