Configuration du suivi d'.NET s sur Windows

Modifier en ligne

Vous pouvez activer le suivi d'.NET s sur Windows en utilisant Instana AutoTrace ou en configurant manuellement les variables d'environnement. .NET Tracer prend en charge le traçage automatique de l'hôte sur les systèmes d' Windows, à l'exception des conteneurs.

Pour plus d'informations sur le fonctionnement de la surveillance d'.NET, consultez la section « Comment fonctionne la surveillance d'.NET ».

Avant de commencer

Modifier en ligne

Pour configurer le suivi d'.NET Core 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 PCP d' Instana est en cours d'exécution sur la machine hôte. Instana Le protocole PCP permet à l'agent d' Instana s de communiquer avec votre application .NET. Pour vérifier si le PCP d' Instana est en cours d'exécution, ouvrez le Gestionnaire des tâches sur Windows et recherchez « Instana PCP ».
  • Installez le capteur «.NET Core » 1.0.56 ou une version ultérieure.
  • Consultez les informations relatives à l'assistance.

Activation du traçage d'.NET

Modifier en ligne

Activez le suivi d'.NET s sur Windows en utilisant l'une des méthodes suivantes :

Méthode 1 : Activer le traçage automatique

Modifier en ligne

Grâce à Instana AutoTrace, Instana, votre application est automatiquement détectée et instrumentée. Vous n'avez pas besoin de modifier le code.

Pour activer Instana AutoTrace,, procédez comme suit :

  1. Modifiez la .NET Core section du fichier de l'agent configuration.yaml (*instanaAgentDir*/etc/instana/configuration.yaml) comme suit :

    # netcore Tracing
com.instana.plugin.netcore:
  tracing:
    enabled: true
  2. Commencez votre candidature.

Lors du démarrage de la phase de découverte, l'agent d' Instana s détecte automatiquement votre application et commence le traçage. Aucune modification du code n'est nécessaire.

Pour vérifier si le suivi fonctionne, connectez-vous à votre tableau de bord Instana. On peut voir apparaître des traces.

Méthode 2 : Activer le traçage manuellement

Modifier en ligne

Utilisez cette méthode si vous avez besoin d'un plus grand contrôle ou si la commande ` AutoTrace ` ne fonctionne pas dans votre configuration. Cette approche consiste à ajouter des paquets d' NuGet s à votre application.

Pour activer manuellement le traçage d'une application .NET Core, procédez comme suit :

  1. Installez les paquets suivants d' NuGet :

    Lorsque les paquets sont distribués via NuGet.org, vous pouvez les installer sans avoir à recompiler l'application. Utilisez l'une des méthodes suivantes :

    • nuget.exe Disponible : Restaurez les paquets à l'aide de nuget.exe sans compiler le projet à instrumenter.
    • nuget.exe indisponible : téléchargez directement les paquets, décompressez-les, puis configurez les variables d'environnement pour qu'elles pointent vers les fichiers décompressés, comme décrit à l'étape suivante.
    Remarque : vous pouvez ajouter le Instana.Tracing.Core.Rewriter.Windows paquet à votre projet ou l'ajouter avant la publication.

  2. Définissez les variables d'environnement suivantes au niveau du système ou de l'application :

    CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}
CORECLR_PROFILER_PATH_64=[Path_to_your_app]/instana_tracing/CoreRewriter_x64.dll
CORECLR_PROFILER_PATH_32=[Path_to_your_app]/instana_tracing/CoreRewriter_x86.dll
DOTNET_STARTUP_HOOKS=[Path_to_your_app]/Instana.Tracing.Core.dll

    Remplacez [Path_to_your_app] par le chemin d'accès réel vers le répertoire de votre application.

    1. Si votre application s'exécute en tant que service de l' Windows, vous pouvez configurer le traçage via le registre Windows :

      1. Ouvrez l'Éditeur du Registre et accédez à :

        HKLM\System\CurrentControlSet\Services\

      2. Ajoutez un MULTI_SZ comme valeur pour « Environnement ». Si la variable d'environnement n'existe pas, copiez les variables suivantes dans le fichier :

        • CORECLR_ENABLE_PROFILING=1
        • CORECLR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}

      3. Pour définir le contenu d'une MULTI_SZ valeur, saisissez une paire clé-valeur par ligne, comme le montre l'exemple suivant :

        CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}
CORECLR_PROFILER_PATH_64=[Path_to_your_app]/instana_tracing/CoreRewriter_x64.dll
CORECLR_PROFILER_PATH_32=[Path_to_your_app]/instana_tracing/CoreRewriter_x86.dll
DOTNET_STARTUP_HOOKS=[Path_to_your_app]/Instana.Tracing.Core.dll

      4. Appuyez sur Entrée après avoir saisi la dernière ligne pour enregistrer la valeur.

  4. Redémarrez votre application pour que les variables d'environnement soient prises en compte.