Paramètres avancés, boîte de dialogue (visualiseur concurrentiel)Advanced Settings dialog box (Concurrency Visualizer)

La boîte de dialogue Paramètres avancés du visualiseur concurrentiel vous permet de contrôler la façon dont les traces sont collectées.By using the Advanced Settings dialog box in the Concurrency Visualizer, you can control how traces are collected. La boîte de dialogue comprend des onglets pour les symboles, « Uniquement mon code », la mise en mémoire tampon, le filtrage, les événements du CLR, les marqueurs, les fournisseurs et les fichiers.The dialog box has tabs for symbols, Just My Code, buffering, filtering, CLR events, markers, providers, and files.

SymbolesSymbols

Le visualiseur concurrentiel utilise les mêmes paramètres de symboles que le débogueur Visual Studio.The Concurrency Visualizer uses the same symbol settings as the Visual Studio Debugger. Le visualiseur concurrentiel utilise les paramètres pour résoudre les piles d’appels associées aux données de performance.The Concurrency Visualizer uses the settings to resolve call stacks that are associated with performance data. Quand il traite des traces, le visualiseur concurrentiel accède aux serveurs de symboles spécifiés dans la page des paramètres.When it processes traces, the Concurrency Visualizer accesses the symbol servers that are specified in the settings page. Si ces données sont accessibles sur un réseau, le traitement des traces ralentit.When this data is accessed over a network, trace processing slows down. Pour réduire la durée nécessaire à la résolution des symboles, vous pouvez les mettre en cache localement.To reduce the amount of time that's required to resolve symbols, you can cache symbols locally. Si les symboles ont été téléchargés, Visual Studio les charge à partir du cache local.If symbols have been downloaded, Visual Studio will load them from the local cache.

Uniquement mon codeJust My Code

Par défaut, Uniquement mon code représente l’ensemble des fichiers .exe et .dll associés à la solution actuelle dans Visual Studio.By default, Just My Code is the set of .exe and .dll files that are associated with the current solution in Visual Studio. Le Visualiseur concurrentiel évalue cet ensemble de fichiers quand vous utilisez la fonctionnalité « Uniquement mon code » pour filtrer les piles des appels.The Concurrency Visualizer evaluates this set of files when you use the Just My Code feature to filter call stacks. Sous l’onglet Uniquement mon code, vous pouvez ajouter des répertoires contenant les fichiers .exe et .dll aux emplacements utilisés par le visualiseur concurrentiel pour Uniquement mon code.On the Just My Code tab, you can add directories that contain .exe and .dll files to the locations that the Concurrency Visualizer uses for Just My Code.

Les chemins des fichiers .exe et .dll sont stockés dans le fichier de trace quand la trace est collectée.The paths of the .exe and .dll files are stored in the trace file when the trace is collected. La modification de ce paramètre n’affecte pas les traces déjà collectées.Changing this setting does not affect any previously collected traces.

Mise en mémoire tamponBuffering

Le visualiseur concurrentiel utilise le suivi d’événements pour Windows (ETW) quand il collecte une trace.The Concurrency Visualizer uses Event Tracing for Windows (ETW) when it collects a trace. ETW utilise plusieurs mémoires tampons quand il stocke des événements.ETW uses various buffers as it stores events. Les paramètres de mémoire tampon ETW par défaut peuvent ne pas être optimaux dans tous les cas. Ils peuvent même provoquer des problèmes tels que la perte d’événements dans certaines situations.The default ETW buffer settings might not be optimal in all cases, and in some cases, might cause problems such as lost events. Vous pouvez utiliser l’onglet Mise en mémoire tampon pour configurer les paramètres de mémoire tampon ETW.You can use the Buffering tab to configure ETW buffer settings. Pour plus d’informations, consultez Traçage d’événements et Structure d’EVENT_TRACE_PROPERTIES.For more information, see Event Tracing and EVENT_TRACE_PROPERTIES structure.

FiltreFilter

Sous l’onglet Filtre, vous pouvez sélectionner le jeu d’événements collecté par le visualiseur concurrentiel.On the Filter tab, you can select the set of events that the Concurrency Visualizer collects. La sélection d’un sous-ensemble d’événements limite les types de données qui s’affichent dans les rapports, réduit la taille de chaque trace et accélère le traitement des traces.Selecting a subset of events limits the types of data that are displayed in the reports, reduces the size of each trace, and reduces the time that's required to process traces.

événements CLRCLR events

Les événements générés par le Common Langage Runtime (CLR) permettent au visualiseur concurrentiel de résoudre les piles d’appels managées.Events generated by the Common Language Runtime (CLR) enable the Concurrency Visualizer to resolve managed call stacks. Si vous désactivez la collecte d’événements du CLR, la taille de la trace est réduite, mais certaines piles d’appels ne sont pas résolues.If you disable collection of CLR events, the trace size will be reduced, but some call stacks will not resolve. Il peut donc arriver que certaines activités de thread de l’UC ne soient pas correctement catégorisées.As a result, some CPU thread activity might be incorrectly categorized.

Collecter les processus natifsCollect for native processes

Par défaut, les événements du CLR sont collectés uniquement quand un processus managé est profilé car ils ne sont normalement pas nécessaires pour les processus natifs.By default, CLR events are collected only when a managed process is profiled because they are normally unnecessary for native processes. Dans certains cas (par exemple, quand un processus natif héberge le CLR), vous devrez peut-être collecter les événements du CLR pour un processus natif.In some cases (for example, when a native process is hosting the CLR), you might have to collect CLR events for a native process. Si tel est le cas, cochez la case Collecter les processus natifs.If this is the case, select the Collect for Native Processes check box.

Désactiver les événements d’arrêtDisable rundown events

Le CLR génère des événements de deux fournisseurs : runtime et rundown.The CLR generates events from two providers: runtime and rundown. Si vous souhaitez collecter les événements du runtime du CLR sans toutefois collecter les événements d’arrêt, cochez la case Désactiver les événements d’arrêt.If you want to collect CLR runtime events, but want to avoid collecting rundown events, select the Disable Rundown Events check box. Cela permet de réduire la taille du fichier de trace généré par la collection, mais il est possible que certaines piles ne soient pas résolues.This reduces the size of the trace file that's generated by collection, but some stacks might not resolve. Pour plus d’informations, consultez Fournisseurs ETW du CLR.For more information, see CLR ETW Providers

Échantillonner les événementsSample events

Vous pouvez utiliser des événements d’échantillon pour collecter les piles des appels associées à l’exécution de threads.You can use sample events to collect call stacks that are associated with thread execution. Ces événements sont collectés environ une fois par milliseconde pour les threads qui s’exécutent dans le processus actif.These events are collected approximately once per millisecond for threads that are executing in the current process. Si vous désactivez la collecte d’événements d’échantillon, vous réduisez la taille de la trace collectée, mais vous ne pouvez pas afficher les piles des appels associées à l’exécution de threads.If you disable the collection of sample events, the size of the collected trace is reduced, but you cannot view any call stacks that are associated with thread execution.

Événements GPUGPU events

Les événements GPU sont des événements générés par DirectX.GPU events are events generated by DirectX. Si vous désactivez la collecte d’événements GPU, vous réduisez la taille de la trace collectée, mais vous ne pouvez pas afficher l’activité GPU dans la vue Utilisation, ni l’activité Moteur DirectX dans la vue Threads.If you disable the collection of GPU events, the size of the collected trace is reduced, but you cannot view any GPU Activity in the Utilization view, or DirectX Engine activity in the Threads View.

Événements d’E/S de fichierFile I/O events

Les événements d’E/S de fichier représentent les accès au disque pour le compte du processus actuel.File I/O events represent accesses to the disk on behalf of the current process. Si vous désactivez les événements d’E/S de fichier, vous réduisez la taille de la trace, mais la vue Threads ne signale aucune information sur les canaux de disque ou des opérations de disque.If you disable File I/O events, the size of the trace is reduced, but the Threads View will not report any information about disk channels or Disk Operations.

MarkersMarkers

Sous l’onglet Marqueurs, vous pouvez configurer l’ensemble des fournisseurs ETW affichés en tant que marqueurs dans le visualiseur concurrentiel.On the Markers tab, you can configure the set of ETW providers that are shown as Markers in the Concurrency Visualizer. Vous pouvez également filtrer la collection de marqueurs selon le niveau d’importance et la catégorie ETW.You can also filter the Marker collection based on importance level and ETW category. Si vous utilisez le kit SDK du visualiseur concurrentiel et votre propre fournisseur de marqueurs, vous pouvez l’inscrire ici pour qu’il apparaisse dans la vue Threads.If you are using the Concurrency Visualizer SDK and are using your own Marker provider, you can register it here so that it appears in the Threads View.

Ajouter un nouveau fournisseurAdd a new provider

Si votre code utilise le SDK du visualiseur concurrentiel ou génère des événements ETW qui respectent la convention EventSource, vous pouvez afficher ces événements dans le visualiseur concurrentiel en les inscrivant dans cette boîte de dialogue.If your code uses the Concurrency Visualizer SDK or generates ETW events that follow the EventSource convention, you can view these events in the Concurrency Visualizer by registering them in this dialog box.

Dans le champ Nom, entrez un nom qui décrit les types d’événement générés par le fournisseur.In the Name field, enter a name that describes the types of events that are generated by the provider. Dans le champ GUID, entrez le GUID associé à ce fournisseur.In the GUID field, enter the GUID that is associated with this provider. (Un GUID est associé à chaque fournisseur ETW.)(A GUID is associated with every ETW provider.)

Vous pouvez éventuellement indiquer si vous souhaitez filtrer les événements de ce fournisseur selon la catégorie ou le niveau d’importance.Optionally, you can specify whether to filter out events from this provider, based on category or importance level. Vous pouvez utiliser le champ Catégorie pour filtrer les événements en fonction des catégories du kit SDK du visualiseur concurrentiel.You can use the category field to filter based on Concurrency Visualizer SDK categories. Pour cela, entrez une chaîne délimitée par des virgules de catégories ou de plages de catégories.To do this, enter a comma-delimited string of categories or ranges of categories. Cela permet de spécifier les catégories d’événements dans le fournisseur actif à afficher.This specifies the categories of events in the current provider to show. Si vous ajoutez un fournisseur EventSource, vous pouvez utiliser le champ Catégorie pour filtrer les événements par mot clé ETW.If you are adding an EventSource provider, you can use the category field to filter by ETW keyword. Étant donné que le mot clé est un masque de bits, vous pouvez utiliser une chaîne d’entiers délimitée par des virgules pour spécifier les bits définis dans le masque.Because the keyword is a bitmask, you can use a comma-delimited string of integers to specify which bits in the mask are set. Par exemple, « 1,2 » définit les premier et deuxième bits, ce qui se traduit par 6 au format décimal.For example, "1,2" sets the first and second bits, and this translates to 6 in decimal.

Vous pouvez utiliser la liste de niveaux d’importance pour filtrer les événements qui ont une importance ou un niveau ETW inférieur à la valeur spécifiée.You can use the importance-level list to filter out events that have an importance or ETW level that's less than the specified value.

Configurer un fournisseur existantConfigure an existing provider

Pour modifier les paramètres associés à un fournisseur existant, sélectionnez-le dans la liste, puis choisissez le bouton Modifier le fournisseur.To edit settings that are associated with an existing provider, select it in the list, and then choose the Edit provider button. Vous pouvez modifier le nom, le GUID et les paramètres de filtrage.You can change the name, GUID, and filtering settings.

Exclure les données de marqueur des rapports du visualiseur concurrentielFilter marker data out of Concurrency Visualizer reports

Si vous ne voulez pas que les données d’un fournisseur particulier s’affichent dans les futures traces, décochez la case située à coté du fournisseur à supprimer.If you don't want data for a particular provider to appear in future traces, clear the check box next to the provider that you want to remove.

FichiersFiles

Sous l’onglet Fichiers, vous pouvez spécifier le répertoire dans lequel les fichiers de trace sont stockés chaque fois qu’une trace est collectée.On the Files tab, you can specify the directory under which trace files are stored each time a trace is collected. Le visualiseur concurrentiel génère quatre fichiers pour chaque trace qu’il collecte :The Concurrency Visualizer generates four files for each trace it collects:

  • Un fichier ETL (Event Trace Log) en mode noyau (. kernel.etl*)A kernel-mode event trace log (ETL) file (. kernel.etl*)

  • Un fichier ETL (Event Trace Log) en mode utilisateur (. user.etl*)A user-mode event trace log file (. user.etl*)

  • Un fichier de données du visualiseur concurrentiel (. CVData*)A Concurrency Visualizer Data file (. CVData*)

  • Un fichier de trace du visualiseur concurrentiel (. CVTrace*)A Concurrency Visualizer Trace file (. CVTrace*)

    Les deux fichiers ETL stockent les données de trace brutes, et les deux fichiers du visualiseur concurrentiel stockent les données gérées.The two ETL files store the raw trace data, and the two Concurrency Visualizer files store the processed data. Les fichiers ETL bruts ne sont généralement pas utilisés après le traitement d’une trace.The raw ETL files are typically not used after a trace is processed. Pour réduire la quantité de données de trace stockées sur votre disque, cochez la case Supprimer les fichiers ETL (Event Trace Log) après l’analyse.Selecting the Delete Event Trace Log (ETL) files after analysis check box reduces the amount of trace data that's stored on your disk.

Voir aussiSee also

Uniquement mon code Just my code
Marqueurs du visualiseur concurrentielConcurrency Visualizer markers