Options de configuration du runtime pour le débogage et le profilage

Article
12/12/2023

Cet article détaille les paramètres que vous pouvez utiliser pour configurer le débogage et le profilage .NET.

Notes

.NET 6 se normalise sur le préfixe DOTNET_ au lieu de COMPlus_ pour les variables d’environnement qui configurent le comportement au moment de l’exécution de .NET. Toutefois, le préfixe COMPlus_ continuera à fonctionner. Si vous utilisez une version précédente du runtime .NET, vous devez tout de même utiliser le préfixe COMPlus_.

Activation des diagnostics

Configure si les diagnostics du débogueur, du profileur et EventPipe sont activés ou désactivés.
Si vous omettez ce paramètre, les diagnostics sont activés. Ceci équivaut à définir la valeur 1.

	Nom du paramètre	Valeurs
runtimeconfig.json	N/A	N/A
Variable d'environnement	`COMPlus_EnableDiagnostics` ou `DOTNET_EnableDiagnostics`	`1` - activé `0` - désactivé

Activer le profilage

Configure si le profilage est activé pour le processus en cours d’exécution.
Si vous omettez ce paramètre, le profilage est désactivé. Ceci équivaut à définir la valeur 0.

	Nom du paramètre	Valeurs
runtimeconfig.json	N/A	N/A
Variable d'environnement	`CORECLR_ENABLE_PROFILING`	`0` - désactivé `1` - activé

GUID du profileur

Spécifie le GUID du profileur à charger dans le processus en cours d’exécution.

	Nom du paramètre	Valeurs
runtimeconfig.json	N/A	N/A
Variable d'environnement	`CORECLR_PROFILER`	string-guid

Emplacement du profileur

Spécifie le chemin de la DLL du profileur à charger dans le processus en cours d’exécution (ou processus 32 bits ou 64 bits).
Si plusieurs variables sont définies, les variables spécifiques au nombre de bits sont prioritaires. Ils spécifient le nombre de bits du profileur à charger.
Pour plus d’informations, consultez Recherche de la bibliothèque du profileur.

	Nom du paramètre	Valeurs
Variable d'environnement	`CORECLR_PROFILER_PATH`	string-path
Variable d'environnement	`CORECLR_PROFILER_PATH_32`	string-path
Variable d'environnement	`CORECLR_PROFILER_PATH_64`	string-path

Exporter des mappages de performance et des images mémoire jit

Active ou désactive l’activation sélective des mappages de performance ou des images mémoire jit. Ces fichiers permettent aux outils tiers, comme l’outil Linux perf, d’identifier les sites d’appel pour le code généré dynamiquement et les modules ReadyToRun (R2R) précompilés.
Si vous omettez ce paramètre, l’écriture des fichiers de mappage de performance et d’image mémoire jit est désactivée. Ceci équivaut à définir la valeur 0.
Lorsque les mappages de performances sont désactivés, tous les sites d’appels gérés ne sont pas correctement résolus.
En fonction de la version du noyau Linux, les deux formats sont pris en charge par l’outil perf.
L’activation des mappages de performances occasionne une surcharge de 10 à 20 %. Pour réduire l’impact sur les performances, une activation sélective des mappages de performances ou des images mémoire jit est recommandée, mais pas les deux.

Le tableau suivant compare les mappages de performances et les mappages jit.

Format	Description	Prise en charge sur
Mappages de performance	Émet `/tmp/perf-<pid>.map` qui contient des informations symboliques pour le code généré dynamiquement. Émet `/tmp/perfinfo-<pid>.map` qui contient les informations sur le symbole du module ReadyToRun (R2R) et est utilisée par PerfCollect.	Les mappages de performance sont pris en charge sur toutes les versions du noyau Linux.
Images mémoire Jit	Le format de l’image mémoire jit remplace les mappages de performance et contient des informations symboliques plus détaillées. Lorsque cette option est activée, les images mémoire jit sont générées dans des fichiers `/tmp/jit-<pid>.dump`.	Version 5.4 (ou ultérieure) du noyau Linux.

	Nom du paramètre	Valeurs
runtimeconfig.json	N/A	N/A
Variable d'environnement	`COMPlus_PerfMapEnabled` ou `DOTNET_PerfMapEnabled`	`0` - désactivé `1` – mappages de performance et images mémoire jit activés `2` – images mémoire jit activées `3` – mappages de performance activés

Marqueurs de journal de performances

Permet ou non d’accepter et d’ignorer le signal spécifié en tant que marqueur dans les journaux de performances.
Si vous omettez ce paramètre, le signal spécifié n’est pas ignoré. Ceci équivaut à définir la valeur 0.

	Nom du paramètre	Valeurs
runtimeconfig.json	N/A	N/A
Variable d'environnement	`COMPlus_PerfMapIgnoreSignal` ou `DOTNET_PerfMapIgnoreSignal`	`0` - désactivé `1` – activé