Options de ligne de commande WPR
Windows Performance Recorder (WPR) offre une interface de ligne de commande simple. La complexité complète de WPR est intégrée dans les profils d’enregistrement.
Options générales
WPR nécessite un système d’exploitation Windows 8.1 ou une version ultérieure.
Syntaxe
wpr FirstLevelOption [<arguments>] [Additional options [<arguments>]]
Vous pouvez obtenir de l’aide supplémentaire avec :
wpr -help [start | stop | status | profiles | providers | tracing | boottrace | heap | hardwarecounter | advanced]
Les FirstLevelOptions suivantes sont disponibles :
| Option | Description |
|---|---|
| -help | Fournit la liste des informations d’aide de sous-niveau. |
| -profiles | Énumère les noms de profils et les descriptions à partir d’un profil. |
| -purgecache | Purge le cache des symboles dynamiques. |
| -start | Démarre un ou plusieurs profils. |
| -marker | Déclenche un marqueur d’événement. |
| -markerflush | (Obsolète) Déclenche un marqueur d’événement et vide l’ensemble de travail. |
| -status | Affiche l’état d’un enregistrement actif (le cas échéant). |
| -profiledetails | Déclenche un marqueur d’événement et vide l’ensemble de travail. |
| -exportprofile | Exporte un profil intégré vers un fichier. |
| -providers | Affiche des informations détaillées sur les fournisseurs. |
| -cancel | Annule l’enregistrement initié par WPR (le cas échéant). |
| -stop | Annule et enregistre l’enregistrement initié par WPR (le cas échéant). |
| -merge | Fusionne les fichiers etl dans le fichier donné. |
| -flush | Vide les sessions de journalisation initiées par WPR (le cas échéant). |
| -log | Configure les informations de débogage enregistrées dans le journal des événements. |
| -disablepagingexecutive | Change les paramètres de Disable Paging Executive. |
| -heaptracingconfig | Change les paramètres de suivi du tas d’un processus. |
| -snapshotconfig | Change les paramètres de capture instantanée pour un processus. |
| -capturestateondemand | Capture les états des fournisseurs configurés dans l’enregistrement actuel. |
| -pmcsources | Interroge la liste des événements PMU disponibles sur le système. |
| -pmcsessions | Interroge la liste des sessions utilisant des événements PMU. |
| -setprofint | Définit l’intervalle de profil échantillonné. |
| -profint | Interroge l’intervalle de profil actuel. |
| -resetprofint | Restaure les valeurs d’intervalle de profil par défaut. |
| -boottrace | Configure les entrées de registre pour les sessions autologger/globallogger. |
| -enableperiodicsnapshot | Active Periodic Snapshot pour l’intervalle spécifié et l’identifiant de processus donné. |
| -disableperiodicsnapshot | Désactive Periodic Snapshot pour tous les processus. |
| -singlesnapshot | Obtient une capture instantanée à la demande pour le processus spécifié. |
Profiles
L’option Profiles répertorie les profils WPR utilisés par l’enregistrement.
Syntaxe
wpr -profiles [<path>]
Le tableau suivant décrit les arguments disponibles que vous pouvez appliquer à cette option. Pour voir les profils intégrés, omettez l’argument.
| Argument | Description |
|---|---|
| <path> | Spécifie le chemin et le nom du fichier contenant les définitions de profil. Par exemple : wpr -profiles “c:\Users\User1\Documents\WPR Files\Custom Profiles\CustomProfile1.wprp” |
Démarrer
L’option Start démarre un enregistrement en utilisant un ou plusieurs profils.
Syntaxe
wpr -start <profile> [-start <profilen>]... [-filemode] [-recordtempto <temp folder path>] [-onoffscenario <OnOff Transition Type>] [-onoffresultspath <path to which the trace files are saved>] [-onoffproblemdescription <description of the scenario>] [-numiterations <number of iterations for OnOff tracing>]
Le tableau suivant décrit les commutateurs disponibles que vous pouvez appliquer à cette option.
| Switch | Description |
|---|---|
| <profile> [-start <profilen>]... | Spécifie soit un profil intégré, soit le chemin vers un profil défini par l’utilisateur. Vous pouvez spécifier jusqu’à 64 profils sur une seule ligne de commande, chaque profil étant spécifié comme suit : <profile> := [<filename.wprp>!]<nom du profil>[.{light|verbose}] Chaque profil peut définir des versions légères ou détaillées, ou les deux versions. Si aucune option n’est spécifiée, la version verbose est utilisée sauf si le profil inclut uniquement une version light. |
| -shutdown [<KSR>] | Spécifie que les informations de session et les enregistrements persisteront après le redémarrage. L’option de fermeture fonctionne uniquement avec la trace en mode fichier, tandis que KSR fonctionne uniquement en mode mémoire. Appelez la commande -stop au prochain démarrage pour fusionner la trace. |
| -filemode | Spécifie que l’enregistrement se fait en mode fichier. (Le mode par défaut est la mémoire.) En utilisant cette option, les données sont enregistrées dans un fichier sans limites, qui peut croître jusqu’à remplir le disque. |
| -recordtempto <chemin du dossier temporaire> | Spécifie le chemin du dossier temporaire dans lequel l’enregistrement est sauvegardé. |
| -onoffscenario <Type de transition On/Off> | Spécifie l’un des types de transition on/off. Ceux-ci sont : Démarrage, Démarrage rapide, Arrêt, Cycle de redémarrage, Veille, ou Hibernation. |
| -onoffresultspath <chemin vers lequel les fichiers de trace sont enregistrés> | Spécifie le chemin vers lequel les fichiers de trace sont enregistrés. |
| -onoffproblemdescription <description du scénario> | Spécifie la description du scénario. |
| -numiterations <nombre d’itérations pour la trace On/Off> | Définit le nombre d’itérations pour l’enregistrement On/Off. Par défaut, les paramètres du fichier de profil intégré ou personnalisé sont utilisés. |
Exemple
wpr -start CPU (Starts verbose CPU profile in memory mode)
wpr -start CPU.light -filemode (Starts light CPU profile in file mode)
wpr -start filename.wprp!ProfileName.Verbose (Starts verbose ProfileName profile defined in filename.wprp)
Arrêter
L’option Stop arrête l’enregistrement en cours et l’enregistre dans le fichier spécifié par l’argument.
Syntaxe
wpr -stop <file> <problem description> -[skipPdbGen] [-force] [-compress]
Le tableau suivant décrit les arguments disponibles que vous pouvez appliquer à cette option.
| Argument | Description |
|---|---|
| <nom de fichier> | Spécifie le fichier de journalisation des événements (ETL) dans lequel WPR enregistre l’enregistrement. Cet argument est obligatoire. |
| <Description du problème :> | Spécifie la description du problème. Bien que cet argument soit facultatif, nous vous recommandons de l’utiliser. |
| -skipPdbGen | Désactive la génération dynamique de ngen et des pdbs intégrés pour les modules .NET. Cette option peut réduire le temps de l’opération d’arrêt. |
| -force | Désactive l’avertissement lorsque l’extension du fichier cible n’est pas .etl. |
| -compress | Compresse le fichier de trace de sortie. |
Fusionner (Merge)
L’option Merge fusionne les fichiers etl dans le fichier donné.
Syntaxe
wpr -merge <trace files ...> <merged file> -[skipPdbGen] [-compress] [-supresspii] [-mergeonly] [-injectonly]
Le tableau suivant décrit les arguments disponibles que vous pouvez appliquer à cette option.
| Argument | Description |
|---|---|
| <fichiers de trace ...> | Spécifie un ou plusieurs fichiers de journalisation d’événements (ETL) non fusionnés. Cet argument est obligatoire. |
| <fichier fusionné> | Spécifie le fichier de sortie dans lequel WPR fusionne les fichiers ETL. |
| -skipPdbGen | Désactive la génération dynamique de ngen et des pdbs intégrés pour les modules .NET. Cette option peut réduire le temps de l’opération d’arrêt. |
| -compress | Compresse le fichier de trace de sortie. |
| -supresspii | Supprime les informations personnellement identifiables (PII). |
| -mergeonly | Fusionne les traces sans ajouter d’informations spécifiques à la machine ou d’événements d’identification d’image. Ne peut pas être utilisé avec -injectonly. |
| -injectonly | Génère uniquement des événements spécifiques à la machine et/ou des ID d’image sans copier les événements originaux dans le fichier fusionné. |
Annuler
L’option Cancel annule l’enregistrement en cours sans enregistrer les données enregistrées. Si aucune instance n’est actuellement active, l’option Cancel renvoie une erreur.
Syntaxe
wpr -cancel
Cette option ne prend aucun argument.
État
L’option Status affiche des informations sur l’état de l’enregistrement WPR en cours.
Syntaxe
wpr -status [profiles] [collectors [-details]]
Si aucun enregistrement n’est actuellement actif, un message indique que WPR n’enregistre pas. Si un enregistrement est actuellement actif et qu’aucun argument n’est utilisé, les informations d’état suivantes s’affichent :
WPR recording is in progress...
Time since start : 00:04:27
Dropped event : 0
Logging mode : Memory
Si vous fournissez des arguments avec l’option -status, les informations listées ci-dessus s’affichent avec les données spécifiques à cette option. Le tableau suivant décrit les arguments disponibles que vous pouvez appliquer à cette option.
| Argument | Description et exemple de sortie |
|---|---|
| profiles | Cet argument liste chaque profil utilisé dans l’enregistrement WPR en cours.
Exemple : Enregistrement de l’activité système en utilisant le jeu de profils suivant : |
| collectors | Liste les informations des collecteurs. Si des tampons ont été perdus, ces tampons sont listés.
Exemple : Collecteurs enregistrant activement : |
| details | Liste des informations supplémentaires sur chaque collecteur. |
Profiledetails
L’option Profiledetails affiche des informations détaillées sur un profil ou un ensemble de profils. Pour spécifier plusieurs profils, utilisez la syntaxe suivante où <profilen> se réfère au nom de chaque profil.
Syntaxe
wpr -profiledetails <profile1>+<profile2>+...+<profilen> [-filemode] -onoffscenario <OnOff Transition Type>
Le tableau suivant décrit les commutateurs disponibles que vous pouvez appliquer à cette option.
| Switch | Description |
|---|---|
| -filemode | Spécifie que l’enregistrement a été effectué en mode fichier. (Le mode par défaut est mémoire). |
| -onoffscenario <Type de transition On/Off> | Spécifie l’un des types de transition on/off. Ceux-ci sont : Démarrage, Démarrage rapide, Arrêt, Cycle de redémarrage, Veille, ou Hibernation. |
ExportProfile
L’option ExportProfile exporte le(s) profil(s) intégré(s) vers le fichier donné. Utilisez la commande wpr -Profiles pour énumérer les profils intégrés disponibles. Pour spécifier plusieurs profils, utilisez la syntaxe suivante où <profilen> se réfère au nom de chaque profil. La convention de nommage des profils est exactement la même que celle utilisée dans wpr -start. Un profil est spécifié comme <profile name>[.{light|verbose}].
Syntaxe
wpr -exportprofile <profile1>+<profile2>+...+<profilen> <ExportedFileName.wprp> [-filemode]
Cet exemple exporte le profil GeneralProfile verbose en mode fichier vers le fichier GeneralProfileVerboseFile.wprp.
Exemple
wpr -exportprofile GeneralProfile d:\profiles\GeneralProfileVerboseFile.wprp -filemode
Fournisseurs
L’option Providers affiche des informations détaillées sur les fournisseurs. Les fournisseurs font référence aux composants Event Tracing for Windows (ETW) qui exposent des événements à Windows Performance Recorder (WPR). Pour afficher des informations sur les fournisseurs, utilisez la syntaxe suivante, où -providers fait référence à tous les fournisseurs installés/connu et enregistrés.
Syntaxe
wpr -providers
Cette option ne prend aucun argument.
Boottrace
L’option Boottrace configure les entrées de registre pour les sessions autologger/globallogger pour le profil donné.
Syntaxe
wpr -boottrace {-addboot [<filename.wprp>!]<profile> [-addboot <profile> ...] [-filemode] [-recordtempto <temp folder path>] | -stopboot <recording filename> <Problem description> | -cancelboot}
Le tableau suivant décrit les mots-clés disponibles que vous pouvez appliquer à cette option.
| Argument | Description |
|---|---|
| -boottrace | Spécifie que l’argument suivant est pour configurer l’autologger. Dans le WPR actuel, cet argument est facultatif. |
| -addboot | Configure les entrées de registre de l’autologger pour le profil donné. La commande wpr -addboot prend les mêmes options que la commande wpr -start. Notez que ces options ne démarrent pas immédiatement la trace. Après le redémarrage, l’autologger sera démarré par le système d’exploitation. |
| -stopboot | Supprime l’autologger configuré par addboot, arrête l’enregistrement de démarrage et fusionne tous les enregistrements dans le fichier donné. Notez que cette option enregistre la trace uniquement si la session d’autologger est en cours d’exécution (c’est-à-dire après le redémarrage). Sinon, cette option supprimera uniquement la configuration de l’autologger. |
| -cancelboot | Supprime l’autologger configuré par addboot et annule l’enregistrement de démarrage initié par WPR. |
CaptureStateOnDemand
L’option CaptureStateOnDemand capture les états pour les fournisseurs configurés dans l’enregistrement en cours. Le fournisseur d’événements doit être configuré pour capturestateondemand dans le fichier de profil pendant que la session est en cours d’exécution.
Syntaxe
wpr-capturestateondemand
Voici un exemple de EventProvider :
<EventProvider Id="EventProvider_Microsoft-Windows-Win32k" Name="Microsoft-Windows-Win32k" NonPagedMemory="true" CaptureStateOnly="true">
<CaptureStateOnDemand Timeout="5">
<Keyword Value="0x0"/>
</CaptureStateOnDemand>
</EventProvider>
Marqueur
L’option Marker déclenche un marqueur d’événement avec le texte donné dans la session de journalisation système en cours.
Syntaxe
wpr -marker <text> [-flush]
| Argument | Description |
|---|---|
| -flush | Vide l’ensemble de travail. Équivalent à -MarkerFlush. |
MarkerFlush (Obsolète)
L’option MarkerFlush déclenche un marqueur d’événement avec le texte donné et vide l’ensemble de travail. Cette commande est obsolète dans le WPR actuel.
Syntaxe
wpr -markerflush <text>
Purge
L’option Flush vide les sessions de journalisation vers les fichiers initiés via WPR.
Syntaxe
wpr -flush
Cette option ne prend aucun argument.
HeapTracingConfig
L’option HeapTracingConfig active ou désactive le suivi de tas pour un processus ou une application spécifique.
Syntaxe
wpr -HeapTracingConfig <process name> [<package full name> <package relative app ID>] [{enable|disable}]
Remarque
- Si le paramètre {enable|disable} est omis, la configuration actuelle du suivi de tas pour le processus ou l’application sera affichée. Par exemple :
wpr -HeapTracingConfig Heaptest.exe enable - Cette commande ne démarre pas immédiatement la trace et doit être exécutée avant de prendre la trace du tas. Veuillez consulter la section Enregistrement pour l’analyse des tas pour plus de détails.
- Désactivez toujours HeapTracingConfig pour le processus après avoir terminé le suivi car cela peut affecter les performances du processus.
Disablepagingexecutive
L’option Disablepagingexecutive spécifie si les pilotes et le code système en mode noyau peuvent être paginés sur le disque. La définition de cette option sur on empêche la pagination. Cette option définit la valeur de DisablePagingExecutive dans le registre.
Syntaxe
wpr -disablepagingexecutive {on | off}
Remarque
Pour capturer correctement les piles d’événements sur les systèmes 64 bits exécutant Windows 7, disablepagingexecutive doit être défini sur On, et le système doit être redémarré avant de commencer l’enregistrement des performances. Pour les systèmes 32 bits exécutant Windows 7 et pour tous les systèmes exécutant Windows 8 ou supérieur, vous pouvez enregistrer les performances sans définir disablepagingexecutive sur On.
Journal
L’option Log ajoute et configure la journalisation de débogage dans le journal des événements.
Syntaxe
wpr -log {enabled | disabled | remove}
Le tableau suivant décrit les mots-clés disponibles que vous pouvez appliquer à cette option.
| Mot clé | Description |
|---|---|
| activé | Active la journalisation de débogage dans le journal des événements |
| disabled | Désactive la journalisation de débogage dans le journal des événements |
| remove | Désinstalle le manifeste du fournisseur de journalisation de débogage WPR du système |
Purgecache
L’option Purgecache purge le cache des symboles gérés.
Syntaxe
wpr -purgecache
Cette option ne prend aucun argument.
Aide
Utilisez cette option pour afficher l’aide en ligne dans la fenêtre Invite de commande.
Syntaxe
wpr -help [start | stop | status | profiles | providers | tracing | boottrace | heap | hardwarecounter | advanced]
Le tableau suivant décrit les mots-clés disponibles que vous pouvez appliquer à cette option.
| Mot clé | Description |
|---|---|
| Aucun mot-clé | Affiche une liste d’options et des descriptions courtes. Pour obtenir une aide supplémentaire pour des options spécifiques, utilisez un mot-clé. Par exemple : wpr -help start. |
| start | Décrit l’argument de ligne de commande -start. Pour plus d’informations, veuillez consulter Start. |
| stop | Décrit les arguments de ligne de commande -stop, -merge, et -cancel. |
| statut | Décrit les arguments de ligne de commande -status. Pour plus d’informations, veuillez consulter Status. |
| profiles | Décrit les arguments de ligne de commande -profiles, -profiledetails, et -exportprofile. |
| fournisseurs | Décrit l’argument de ligne de commande -providers. Pour plus d’informations, veuillez consulter Providers. |
| tracing | Décrit les arguments de ligne de commande -marker, -flush, et -capturestateondemand. |
| boottrace | Décrit les arguments de ligne de commande -addboot, -stopboot, et -cancelboot. |
| segment de mémoire | Décrit les arguments de ligne de commande -heaptracingconfig, -snapshotconfig, -enableperiodicsnapshot, -disableperiodicsnapshot, et -singlesnapshot. |
| hardwarecounter | Décrit les arguments de ligne de commande -pmcsources, -pmcsessions, -setprofint, -profint, et -resetprofint. |
| advanced | Décrit les arguments de ligne de commande -purgecache, -log, -disablepagingexecutive, -instancename, et -container. |
SnapshotConfig
L’option SnapshotConfig active ou désactive la possibilité de capturer des instantanés uniques ou périodiques de <option de snapshot>\ pour un processus ou des processus spécifiques. Actuellement, vous pouvez prendre des instantanés du tas.
Syntaxe
wpr -SnapshotConfig <snapshot option> {-name <process name> | -pid <pid 1> [pid 2] ...} [{enable|disable}]
Si le {enable|disable} paramètre est omis, la configuration actuelle de l’instantané pour le processus sera affichée (c’est-à-dire uniquement l’option -name).
Cet exemple utilise la commande snapshotconfig avec des noms d’image :
wpr -snapshotconfig heap -name Win32Project1.exe //query snapshot config
wpr -snapshotconfig heap -name Win32Project1.exe enable //enable snapshot config
wpr -snapshotconfig heap -name Win32Project1.exe disable //disable snapshot config
Cet exemple utilise la commande snapshotconfig avec un PID :
wpr -snapshotconfig heap -pid 8048 enable //enable snapshot config
Remarque
Si l’architecture du processus et du système d’exploitation ne correspond pas (par exemple, une application win32 sur un système d’exploitation 64 bits), utilisez l’option de nom d’image.
Le tableau suivant décrit les commutateurs disponibles que vous pouvez appliquer à cette option.
| Switch | Description |
|---|---|
| <option de snapshot> | Spécifie l’un des types d’options de snapshot. Actuellement, seul le tas est disponible. |
| -name | Spécifie le nom du processus. Ce commutateur ne peut pas être utilisé avec le commutateur -Pid. Si ce commutateur est utilisé pour activer l’instantané, la configuration s’appliquera à toutes les nouvelles instances du nom de processus spécifié. Veuillez vous assurer de le désactiver lorsque les tests sont terminés. |
| -pid | Spécifie l’identifiant du processus. Ce commutateur ne peut pas être utilisé avec le commutateur -name. Si ce commutateur est utilisé pour activer l’instantané, la configuration sera appliquée immédiatement et pendant la durée de vie du processus. |
SingleSnapshot
L’option SingleSnapshot déclenche une capture instantanée à la demande de <option de snapshot> pour l’identifiant de processus spécifié.
Syntaxe
wpr -SnapshotConfig <snapshot option> <pid 1> [pid 2] ... [up to pid 8]
Remarque
La fonction de capture instantanée doit être activée pour l’identifiant de processus (ou le nom) avant d’appeler SingleSnapshot.
Par exemple : wpr -singlesnapshot heap <pid for foo.exe>
Veuillez vous référer à la commande SnapshotConfig pour plus d’informations.
Le tableau suivant décrit les commutateurs disponibles que vous pouvez appliquer à cette option.
| Switch | Description |
|---|---|
| <option de snapshot> | Spécifie l’un des types d’options de snapshot. |
| <pid> | Spécifie l’identifiant du processus. |
EnablePeriodicSnapshot
L’option EnablePeriodicSnapshot déclenche des captures instantanées périodiques à des intervalles spécifiés et aux identifiants de processus donnés.
Syntaxe
wpr -enableperiodicsnapshot <snapshot option> <interval (in seconds)> <pid 1> [pid 2] ... [up to pid 8]
Remarque
La fonction de capture instantanée doit être activée pour l’identifiant de processus (ou le nom) avant d’appeler SingleSnapshot.
Par exemple : wpr -enableperiodicsnapshot heap 60 <pid for foo.exe>
Veuillez vous référer à la commande SnapshotConfig pour plus d’informations.
Le tableau suivant décrit les commutateurs disponibles que vous pouvez appliquer à cette option.
| Switch | Description |
|---|---|
| <option de snapshot> | Spécifie l’un des types d’options de snapshot. |
| <interval> | Spécifie l’intervalle en secondes. Notez que l’intervalle minimum valide est de 5. |
| <pid> | Spécifie l’identifiant du processus. |
DisablePeriodicSnapshot
L’option DisablePeriodicSnapshot désactive les captures instantanées périodiques pour tous les processus spécifiés par l’option enableperiodicsnapshot.
Syntaxe
wpr -disableperiodicsnapshot <snapshot option>
Exemple
wpr -disableperiodicsnapshot heap
Le tableau suivant décrit les commutateurs disponibles que vous pouvez appliquer à cette option.
| Switch | Description |
|---|---|
| <option de snapshot> | Spécifie l’un des types d’options de snapshot. |
PMCSources
L’option PMCSources interroge la liste des événements PMU (Performance Monitoring Unit) sur le système et leur valeur d’intervalle par défaut pour le dépassement du compteur. L’intervalle est le nombre d’événements.
Syntaxe
wpr -pmcsources
Remarque
Les événements de l’unité de surveillance des performances sont utilisés pour mesurer les performances du CPU et comprendre la caractérisation des charges de travail du CPU. Seul un sous-ensemble d’événements PMU dans les documents de référence Arm/intel est implémenté dans Windows HAL. L’exemple de sortie de cette option sur un appareil CPU Intel est ci-dessous :
C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -pmcsources
Id Name Interval Min Max
--------------------------------------------------------------
0 Timer 10000 1221 1000000
2 TotalIssues 698400 4096 2147483647
6 BranchInstructions 65536 4096 2147483647
10 CacheMisses 65536 4096 2147483647
11 BranchMispredictions 65536 4096 2147483647
19 TotalCycles 65536 4096 2147483647
25 UnhaltedCoreCycles 65536 4096 2147483647
26 InstructionRetired 65536 4096 2147483647
27 UnhaltedReferenceCycles 65536 4096 2147483647
28 LLCReference 65536 4096 2147483647
29 LLCMisses 65536 4096 2147483647
30 BranchInstructionRetired 65536 4096 2147483647
31 BranchMispredictsRetired 65536 4096 2147483647
32 LbrInserts 65536 4096 2147483647
PMCSessions
L’option PMCSessions interroge la liste des sessions utilisant des compteurs matériels. Cette option n’est disponible que sur Windows 11 ou les versions ultérieures.
Syntaxe
wpr -pmcsessions
ProfInt
L’option ProfInt interroge l’intervalle de « profilage ».
Syntaxe
wpr -profint
Exemple
C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -profint
Current Profile Interval = 10000 [1.0000ms]
SetProfInt
L’option SetProfInt définit l’intervalle de profil d’échantillonnage pour les événements PMU. Si le nom de l’événement PMU est omis, le défaut est Timer.
Syntaxe
wpr -setprofint [PMU event name] 1221...10000000
Exemple
C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -setprofint 100000
New Profile Interval = 100000 [10.0000ms]
C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -setprofint TotalIssues 1000000
New Profile Interval = 100000 [Counter: TotalIssues]
ResetProfInt
L’option ResetProfInt réinitialise l’intervalle de profil à la valeur par défaut.
Syntaxe
wpr -resetprofint [Profile Source Name]
Notez que si [Nom de la source de profil] n’est pas fourni, toutes les sources de profil seront réinitialisées à la valeur par défaut.
Instancename
L’option Instancename spécifie un nom pour identifier de manière unique l’instance de traçage.
Cette option peut être appliquée à toutes les commandes qui manipulent la session de journalisation et attribue un nom de session de journalisation fourni par l’utilisateur. WPR définit le nom de session par défaut si cette option est omise.
Syntaxe
wpr –{option <arguments>} -instancename <text>
Remarque
-instancename doit être le dernier paramètre. Si les sessions de journalisation ont été démarrées avec cette option, toutes les commandes suivantes doivent utiliser la même option instancename. Par exemple :
C:\wpt>wpr -start cpu -instancename CpuSession
C:\wpt>wpr -status -instancename CpuSession
WPR recording is in progress...
...
Time since start : 00:00:05
Dropped event : 0
Logging mode : Memory
C:\wpt>wpr -stop cpu.etl -> omitting instancename option would not find CpuSession
There are no trace profiles running.
Error code: 0xc5583000
C:\wpt>wpr -stop cpu.etl -instancename CpuSession -> trace will be saved
Notes
Chaque fois que WPR enregistre une trace capturée lorsque des applications gérées étaient en cours d’exécution sur le système, WPR enregistre des symboles gérés à côté du fichier de trace. Cette fonctionnalité permet l’analyse des performances des applications gérées.
La génération de symboles gérés est une opération gourmande en ressources et en temps. WPR crée automatiquement un cache de symboles gérés pour accélérer la génération de symboles gérés. Lorsque WPR a besoin de symboles gérés, il vérifie d’abord ce cache et utilise tous les symboles disponibles et appropriés au lieu de les régénérer.
L’emplacement par défaut du cache de symboles gérés est C:\ProgramData\WindowsPerformanceRecorder\NGenPdbs_Cache.