Configuration du suivi d'.NET s sur IIS

Modifier en ligne

Vous pouvez configurer le traçage pour les applications..NET s hébergées sur Internet Information Services (IIS) en utilisant InstanaAutoTrace ou en configurant manuellement les variables d'environnement.

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

Avant de commencer
Activation du traçage
Etape suivante

Avant de commencer

Modifier en ligne

Pour configurer le suivi d'.NET Core s sur IIS, procédez comme suit :

Assurez-vous que l'agent d' Instana ation est en cours d'exécution sur la machine hôte. Consultez les conditions préalables à la surveillance d'.NET Core.
Vérifiez que le PCP d' Instana est en cours d'exécution sur la machine hôte. Pour vérifier si le PCP d' Instana est en cours d'exécution, utilisez le Gestionnaire des tâches sur Windows.
Installez le capteur «.NET Core » 1.0.56 ou une version ultérieure.
Consultez les informations relatives à l'assistance.

Activation du traçage

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

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

Modifiez le fichier de l'agent configuration.yaml comme indiqué dans l'exemple suivant :
```
# netcore Tracing
com.instana.plugin.netcore:
  tracing:
    enabled: true
```
Exécutez la réinitialisation d'IIS pour vous assurer que les processus de travail IIS chargent l'instrumentation :
```
iisreset
```
Remarque : si IIS n'est pas réinitialisé, les processus IIS ne sont pas instrumentés et vous ne pouvez pas tracer les applications hébergées par IIS. Vous devez réinitialiser IIS même si l'application a déjà été instrumentée.
Commencez votre candidature. Lors du démarrage de la phase de découverte, le capteur active automatiquement la fonction de suivi.

Méthode 2 : Activer le traçage manuellement

Modifier en ligne

Pour les applications .NET Core hébergées sur IIS, vous pouvez configurer manuellement le traçage en ajoutant des variables d'environnement au Web.config fichier.

Suivez les étapes suivantes pour activer le traçage manuellement :

Installez les paquets suivants dans votre application :
- Instana.Tracing.Core
- Instana.Tracing.Core.Rewriter.Windows
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.

Ajoutez les variables d'environnement suivantes dans le Web.config fichier de l'application :

<aspNetCore>
    <environmentVariables>
        <environmentVariable name="CORECLR_ENABLE_PROFILING" value="1" />
        <environmentVariable name="CORECLR_PROFILER" value="{FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}" />
        <environmentVariable name="CORECLR_PROFILER_PATH_64" value="[Path_to_your_app]/instana_tracing/CoreRewriter_x64.dll" />
        <environmentVariable name="CORECLR_PROFILER_PATH_32" value="[Path_to_your_app]/instana_tracing/CoreRewriter_x86.dll" />
        <environmentVariable name="DOTNET_STARTUP_HOOKS" value="[Path_to_your_app]/Instana.Tracing.Core.dll" />
    </environmentVariables>
</aspNetCore>

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

Une fois les variables ajoutées, exécutez la iisreset commande pour recharger les processus de travail IIS :
```
iisreset
```
Remarque : si IIS n'est pas réinitialisé, les processus IIS ne sont pas instrumentés et vous ne pouvez pas tracer les applications hébergées par IIS. Vous devez réinitialiser IIS même si l'application a déjà été instrumentée.

Etape suivante

Modifier en ligne