start
Affiche les options de démarrage du journal.
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 journaliseurs dans le profil ProfileName défini dans le fichier ProfileFileName, ou démarre le journaliseur SessionName défini dans le fichier ProfileFileName. |
-update [LoggerName]|[ProfileFileName!ProfileName|SessionName]] |
Met à jour une session de journalisation pour LoggerName, met à jour les journaliseurs dans le profil ProfileName défini dans le fichier ProfileFileName, ou met à jour le journaliseur SessionName défini dans le fichier ProfileFileName. |
-flush LoggerName |
Vide une session de journalisation pour LoggerName. Ce paramètre est nécessaire pour sauvegarder une trace en mode tampon (voir paramètre -buffering ci-dessous). Pour sauvegarder une trace en mode tampon, vous devez utiliser le paramètre -flush. |
-capturestate LoggerName Flags |
Capture l’état pour une session de journalisation non-noyau à partir des fournisseurs spécifiés dans Flags. Le format de fournisseur accepté est le même que pour -on. Si des indicateurs et des niveaux sont spécifiés, ils sont activés lors de la capture de l’état. Cela est appelé pour la traçabilité commencée avec l’option -buffering. Cela doit être suivi de -stop pour arrêter la traçabilité. |
-on Flags|Groups |
Pour les sessions de journalisation noyau, la séquence d’indicateurs et de groupes noyau à activer, séparée par des signes plus (+). Pour les sessions de journalisation utilisateur, la séquence de fournisseurs à activer, séparée par des signes plus (+). Le format de fournisseur accepté est |
-f filename |
Journalise les événements dans le fichier spécifié. La valeur par défaut est \Kernel.etl pour les traces noyau et \User.etl pour les traces utilisateur. |
-buffersize Size |
Définit la taille du tampon de traçabilité à Size, en Ko. Les valeurs possibles sont de 4 à 1024. La valeur par défaut est 64. |
-minbuffers n |
Définit le nombre minimum de tampons de traçabilité à n. La valeur par défaut est 64. |
-maxbuffers n |
Définit le nombre maximum de tampons de traçabilité à n. Valeur par défaut : 320. |
-maxfile Size |
Définit la taille maximale du fichier à Size Mo. |
-flushtimer n |
Définit le minuteur de vidage à n secondes. |
-boottrace Flags|Groups|off |
Configure le journaliseur Event Tracing for Windows pour tracer le démarrage. Définir les indicateurs sur « off » pour désactiver la traçabilité de démarrage. Tous les contrôles de journalisation peuvent être utilisés en conjonction avec ceci. Utilisez en conjonction avec -f pour journaliser dans un fichier autre que \Perf.etl. |
-realtime |
Active la traçabilité en temps réel. |
-buffering |
Active la traçabilité en mode tampon. Pour sauvegarder, utilisez -flush. L’option -stop ne sauvegarde pas la trace. |
-filemode Mode |
Définit le mode de fichier. La valeur par défaut est « Sequential ». Modes possibles : « Sequential », « Circular », « Append », et « NewFile ». |
-clocktype ClockType |
Définit le type d’horloge. La valeur par défaut est « PerfCounter ». Types possibles : « Cycle », « PerfCounter », et « SystemTime ». |
-stackwalk flags|@file |
Active la marche de pile pour les événements spécifiés comme |
-pids pid [...] |
Applique les indicateurs aux processus Lors de la spécification de plusieurs pids, séparez-les par un espace, comme dans |
-pidnewprocess <command-line> |
Applique les indicateurs à un nouveau processus que Xperf démarrera avec <command-line>. Utilisé en conjonction avec les journaliseurs privés. |
-waitfornewprocess |
Attend qu’un nouveau processus créé à l’aide de |
-heap |
Active la traçabilité du tas dans les processus spécifiés par Pids et PidNewProcess. |
-critsec |
Active la traçabilité de la section critique dans les processus spécifiés par Pids et PidNewProcess. |
-setprofint [<n>] [cached] |
Définit l’intervalle de profil échantillonné à |
-save ProfileFileName!ProfileName|SessionName merged.etl |
Vide les journaliseurs dans le profil ProfileName défini dans le fichier ProfileFileName et fusionne les fichiers ETL dans merged.etl ; ou vide le journaliseur 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ù n1 est le taux d’échantillonnage de libération supérieur ou égal à 1000, n2 est le taux d’échantillonnage de contention supérieur ou égal à 1, et n3 est le nombre de dépassements de délai excessifs supérieur ou égal à 1. Le taux d’échantillonnage de la contention est le taux auquel les événements de verrouillage de rotation sont acquis lorsque des collisions se produisent. Par exemple, si cette valeur est 100, un événement de verrouillage de rotation est acquis pour chaque cent collisions de verrouillage de rotation. |
-setspinlocksample <n1><n2><n3> |
Définit le seuil de rotation du verrou de rotation à |
-pooltag <P1>+<P2>+<P3>+<P4> |
Définit les filtres d’étiquette 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 ou un astérisque (*) pour un caractère générique multiple. Un maximum de quatre filtres peuvent être spécifiés. |
Notes
Plusieurs journaliseurs peuvent être démarrés en utilisant plusieurs options de démarrage, chacune suivie des options à appliquer à ce journaliseur. Si LoggerName ou -start LoggerName est omis, le journaliseur noyau est implicite. Une seule instance du journaliseur noyau peut exister à tout moment. Si l’un des journaliseurs ne parvient pas à démarrer, tous les journaliseurs déjà démarrés sont arrêtés.