start
Affiche les options de démarrage de l’enregistreur d’événements.
xperf [-start [LoggerName] [ProfileFileName!ProfileName|SessionName]|-update [LoggerName]|[ProfileFileName!ProfileName|SessionName]] -flush [LoggerName] -save ProfileFileName!ProfileName|SessionName merged.etl -setprofint [<n>] [cached] -seteresourcesample <n1> <n2> <n3> -setspinlocksample <n1> <n2> <n3> -pooltag <P1>+<P2>+<P3>+<P4> -on (GUID|KnownProviderName)[:Flags[:Level[<:0xnnnnnnnn|’stack|[,]sid[,]tsid’]]]
Paramètres
| Commande | Description |
|---|---|
-start[LoggerName]|[ ProfileFileName! ProfileName|SessionName]] |
Démarre une session de journalisation pour LoggerName, démarre les enregistreurs d’événements dans le profil ProfileName défini dans le fichier ProfileFileName ou démarre l’enregistreur d’événements SessionName défini dans le fichier ProfileFileName . |
-update[LoggerName]|[ ProfileFileName! ProfileName|SessionName]] |
Mises à jour une session de journalisation pour LoggerName, met à jour les enregistreurs d’événements dans le profil ProfileName défini dans le fichier ProfileFileName ou met à jour l’enregistreur d’événements SessionName défini dans le fichier ProfileFileName. |
-flushLoggerName |
Vide une session de journalisation pour LoggerName. Ce paramètre est requis pour enregistrer une trace du mode de mémoire tampon (voir le paramètre -buffering ci-dessous). Pour enregistrer une trace du mode tampon, vous devez émettre le paramètre -flush . |
-capturestateIndicateurs LoggerName |
Capture l’état de la session de journalisation non-noyau à partir des fournisseurs spécifiés dans Indicateurs. Le format de fournisseur accepté est le même que pour -on. Si des indicateurs et un niveau sont spécifiés, ils sont activés lors de la capture de l’état. Ceci est appelé pour le suivi démarré avec l’option –buffering . Elle doit être suivie de –stop pour arrêter le suivi. |
-onFlags|Groupes |
Pour les sessions de journalisation du noyau, séquence d’indicateurs et de groupes de noyau à activer, séparée par des signes plus (+). Pour les sessions de journalisation des utilisateurs, séquence de fournisseurs à activer, séparée par des signes plus (+). Le format de fournisseur accepté est |
-ffilename |
Consigne les événements dans le fichier spécifié. La valeur par défaut est \Kernel.etl pour les traces de noyau et \User.etl pour les traces utilisateur. |
-buffersizeSize |
Définit la taille de la mémoire tampon de trace sur Taille, en Ko. Les valeurs possibles sont de 4 à 1024. La valeur par défaut est 64. |
-minbuffersn |
Définit le nombre minimal de mémoires tampons de trace sur n. La valeur par défaut est 64. |
-maxbuffersn |
Définit le nombre maximal de mémoires tampons de trace sur n. La valeur par défaut est 320. |
-maxfileSize |
Définit la taille maximale du fichier sur Taille En Mo. |
-flushtimern |
Définit le minuteur de vidage sur n secondes. |
-boottraceFlags|Groupes|off |
Configure le suivi d’événements pour l’enregistreur d’événements Windows afin de suivre le démarrage. Définissez les indicateurs sur « off » pour désactiver le suivi de démarrage. Tout le contrôle de journalisation peut être utilisé conjointement avec cela. Utilisez conjointement avec -f pour vous connecter à un fichier autre que \Perf.etl. |
-Realtime |
Active le suivi en temps réel. |
-Tampon |
Active le suivi du mode de mise en mémoire tampon. Pour enregistrer, utilisez -flush. L’option -stop n’enregistre pas la trace. |
-filemodeMode |
Définit le mode de fichier. La valeur par défaut est « Séquentiel ». Modes possibles : « Séquentiel », « Circulaire », « Append » et « NewFile ». |
-clocktypeClockType |
Définit le type d’horloge. La valeur par défaut est « PerfCounter ». Types possibles : « Cycle », « PerfCounter » et « SystemTime ». |
-stackwalkflags|@file |
Active la marche à pas de la pile pour les événements spécifiés en tant que |
-pidspid [...] |
Applique des indicateurs aux processus Lorsque vous spécifiez plusieurs pids, séparez-les par un espace, comme dans |
Ligne> de commande -pidnewprocess< |
Applique des indicateurs à un nouveau processus que Xperf démarrera avec <la ligne> de commande. Utilisé conjointement avec des enregistreurs d’événements privés. |
-waitfornewprocess |
Attend qu’un nouveau processus créé à l’aide |
-Tas |
Active le suivi de tas dans les processus spécifiés par Pids et PidNewProcess. |
-critsec |
Active le suivi de section critique dans les processus spécifiés par Pids et PidNewProcess. |
-setprofint[<n>] [cached] |
Définit l’intervalle de profil échantillonné sur |
-saveProfileFileName! ProfileName|SessionName merged.etl |
Vide les enregistreurs d’événements dans le profil ProfileName défini dans le fichier ProfileFileName et fusionne les fichiers ETL dans merged.etl ; ou vide l’enregistreur d’événements SessionName défini dans le fichier ProfileFileName et fusionne le fichier ETL dans Merged.etl. |
-seteresourcesample<n1><n2><n3> |
Définit l’échantillonnage ERESOURCE, où le taux d’échantillonnage de mise en production n1 est supérieur ou égal à 1 000, le taux d’échantillonnage de contention n2 est supérieur ou égal à 1 et n3 le nombre de délais d’expiration excessifs est supérieur ou égal à 1. Le taux d’échantillonnage de contention est la vitesse à laquelle les événements de verrouillage tournant sont acquis lorsque des collisions se produisent. Par exemple, si cette valeur est 100, un événement de verrouillage tournant est acquis pour chaque cent collisions spin lock. |
-setspinlocksample<n1><n2><n3> |
Définit le seuil de spinlock sur |
-pooltag<P1>+<P2>+<P3>+<P4> |
Définit les filtres de balises de pool (Pn) séparés par des signes plus (+) ou des points-virgules (;). Utilisez un point d’interrogation (?) pour un caractère générique à caractère unique ou un astérisque (*) pour un caractère générique à plusieurs caractères. Un maximum de quatre filtres peut être spécifié. |
Notes
Plusieurs enregistreurs d’événements peuvent être démarrés à l’aide de plusieurs options de démarrage, chacune suivie des options à appliquer à cet enregistreur d’événements. Si LoggerName ou -start LoggerName est omis, l’enregistreur d’événements du noyau est implicite. Une seule instance du journal du noyau peut exister à tout moment. Si l’un des enregistreurs ne parvient pas à démarrer, tous les enregistreurs d’événements déjà démarrés sont arrêtés.