SPTAggregate

SPTAggregate est un outil en ligne de commande pour Sample Profile-Guided Optimization (SPGO). Utilisez-le pour combiner un ou plusieurs fichiers ETL (journal de suivi des événements) collectés par xperf en un seul fichier SPT (trace de profil échantillonné). Vous pouvez éventuellement filtrer les données par nom de processus ou binaire et exclure des événements de noyau. Après avoir créé le fichier SPT, utilisez SPDConvert pour l’importer dans un fichier SPD (Exemple de base de données de profil) pour les flux de travail d’optimisation.

Les fichiers ETL (Event Trace Log) contiennent des événements bruts de performances matérielles qu’enregistre xperf. SPTAggregate convertit ces fichiers ETL au format SPT, qui empaquete les exemples d’événements à importer dans un fichier SPD (Exemple de base de données de profil) par SPDConvert.

Syntax

SPTAggregate [options] /etletlfilessptfile

Paramètres

Options
Spécifiez les options suivantes pour SPTAggregate:

• /Processus:<Processus> Filtrez les événements par nom de processus. Spécifiez un ou plusieurs noms de processus en tant que liste séparées par des virgules.
  Exemple : /process:myapp.exe
• /Binaire:<Binaires> Filtrez les événements par nom binaire. Spécifiez un ou plusieurs noms binaires en tant que liste séparées par des virgules.
  Exemple : /binary:mylib.dll,myapp.exe
• /nokernel Exclure les événements du noyau du système d’exploitation.
• /Aide Affichez les informations d’aide.

etlfiles
Liste séparée par des virgules des fichiers ETL (journal des traces d’événements) à traiter. Collecter des fichiers ETL à l’aide de xperf.

sptfile
Fichier SPT de sortie à créer.

Remarques

Note

Exécutez cet outil depuis une invite de commandes développeur pour Visual Studio.

Permet SPTAggregate de convertir un ou plusieurs fichiers ETL collectés par xperf un fichier SPT. L’indicateur /etl est requis et doit précéder la liste des fichiers ETL. Vous pouvez importer le fichier SPT obtenu dans un fichier SPD à l’aide de SPDConvert.

SPTAggregate utilise xperf, qui doit se trouver dans votre variable PATH et être configuré avec les modifications perfcore.ini comme décrit dans Configurer perfcore.ini.

Lorsque SPTAggregate exécute xperf, il utilise des paramètres comme : xperf -a spt -genSPT outputfile.spt -binary application.exe,support.dll,companion.dll où -a spt spécifie de générer un exemple de rapport d’analyse de trace de profil, -genSPT spécifie le fichier SPT de sortie, et -binary concentre l’analyse sur les binaires spécifiés.

Pour plus d’informations sur les indicateurs xperf, consultez la documentation Xperf Command-Line Reference.

Example

Cet exemple convertit un fichier ETL unique en fichier SPT :

SPTAggregate /etl filename.etl filename.spt

Cet exemple filtre les événements dans un processus spécifique :

SPTAggregate /process:filename.exe /etl filename.etl filename.spt

Cet exemple agrège deux fichiers ETL et exclut les événements de noyau :

SPTAggregate /nokernel /etl run1.etl,run2.etl filename.spt

Voir aussi

Tutoriel : utilisez l’optimisation guidée par échantillonnage (SPGO) pour améliorer les performances
Optimisations guidées par profil
SPDConvert
SPDDump
SPTDump