Configuration du suivi d'.NET Framework s sur Windows
Vous pouvez activer le suivi d'.NET Framework s sur les systèmes Windows pour les applications autonomes, les processus et les services d' Windows en configurant manuellement les variables d'environnement. Cette méthode est obligatoire pour les applications qui ne sont pas hébergées sur IIS.
Ce sujet aborde les points suivants :
Avant de commencer
Pour configurer le suivi d'.NET Framework s sur Windows, procédez comme suit :
- Assurez-vous que l'agent d' Instana ation est en cours d'exécution sur la machine hôte. Consultez la section « Installation de l'agent » sur Windows.
- Vérifiez que le service « InstanaPCP » est en cours d'exécution sur la machine hôte. InstanaPCP permet à l'agent d' Instana s de communiquer avec votre application .NET Framework. Pour vérifier si le service « InstanaPCP » est en cours d'exécution, ouvrez le Gestionnaire des tâches sur Windows et recherchez
InstanaPCP.exe. - Vérifiez que votre application fonctionne sous .NET Framework 4.5.2 ou une version ultérieure.
- Consultez les informations d'assistance.
Activation du traçage pour les applications autonomes
L'agent d' Instana s n'active pas automatiquement la traçabilité pour toutes les applications basées sur l'.NET. Par exemple, les applications du système d' Windows s ou les processus autonomes sont exclus, sauf configuration contraire explicite.
IIS et WebSphere Application Server sont configurés pour lancer automatiquement le profileur grâce à la définition de variables d'environnement appropriées. Cependant, les processus autonomes doivent être configurés manuellement.
Pour activer le traçage d'un processus, définissez les variables d'environnement suivantes :
- Si vous utilisez des comptes utilisateurs spécifiques pour exécuter vos applications, définissez les variables d'environnement au niveau de ces comptes.
- Définissez les variables d'environnement avant de lancer le processus.
SET COR_ENABLE_PROFILING=1
SET COR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}
Vous pouvez intégrer ces paramètres dans un script batch ou shell qui définit les variables d'environnement, puis lance votre processus.
Activation du traçage pour les services d' Windows
Si vous utilisez les services d' Windows, vous pouvez ajouter des paramètres de variables d'environnement dans le registre pour chaque service. L'ajout de ces paramètres vous permet de mieux contrôler le choix des services à surveiller.
Pour configurer la variable d'environnement pour les services d' Windows, procédez comme suit :
- Go vers l'Éditeur du Registre dans le
HKLM\System\CurrentControlSet\Services\serviceNamerépertoire. EnvironmentAjoutez laMULTI_SZvaleur portant le nom.- Si
MULTI_SZn'existe pas, copiez les variables COR_ENABLE_PROFILING, COR_PROFILER et INSTANA_ALLOW_ROOT_EXIT_SPAN dans cette valeur. - Pour définir le contenu d'une
MULTI_SZvaleur, ajoutez une paire clé-valeur par ligne, comme le montre l'exemple suivant :COR_ENABLE_PROFILING=1 COR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3} INSTANA_ALLOW_ROOT_EXIT_SPAN=1 - Après la dernière ligne, appuyez sur Entrée.
- Redémarrez le service « Windows » pour que les modifications prennent effet.