Configuration du traçage d'.NET s sur les conteneurs d' Docker

Modifier en ligne

Configurez le traçage d'.NET s pour les applications s'exécutant dans des conteneurs Docker à l'aide d'images de base Instana préconfigurées ou via une configuration manuelle.

Important : les images de base « Instana » et « .NET » sont disponibles à partir de la version .NET Core Tracer 1.319.7. Ces images fournissent une configuration de traçage préconfigurée et évitent d'avoir à effectuer une configuration manuelle pour les applications conteneurisées d'.NET.

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

Choisir votre méthode d'installation
Configuration manuelle du suivi d'.NET sur Docker
- Prérequis
- Installation des paquets d' NuGet s et configuration des variables d'environnement
Etape suivante

Choisir votre méthode d'installation

Modifier en ligne

Vous pouvez configurer le suivi d'.NET s sur Docker en utilisant l'une des méthodes suivantes, en fonction de vos besoins :

Utilisation des images de base Instana .NET : utilisez les images préconfigurées Docker dotées d'un agent de suivi Instana intégré. Cette approche élimine la configuration manuelle et simplifie la mise en place du traçage. Disponible à partir de la version .NET Core Tracer 1.319.7. Pour plus d'informations, consultez la section « Configuration du traçage d'.NET s sur Docker avec les images de base Instana ».
Utilisation des paquets « NuGet » et configuration du fichier Dockerfile (configuration manuelle) : installez les paquets « NuGet » et configurez les variables d'environnement dans votre fichier Dockerfile. Utilisez cette méthode si vous avez besoin d'une configuration personnalisée ou si vous utilisez des versions d'.NET Core Tracer antérieures à 1.319.7.

Configuration manuelle du suivi d'.NET sur Docker

Modifier en ligne

Pour activer le traçage « .NET » pour les applications s’exécutant dans des conteneurs « Docker », procédez comme suit :

Prérequis

Modifier en ligne

Avant d'activer le traçage d'.NET s pour les conteneurs, assurez-vous que les conditions préalables suivantes sont remplies :

Un agent Instana est installé, en cours d'exécution et accessible depuis votre conteneur Docker. Consultez la section « Installation de l'agent d' Instana » sur Docker.
Vérifiez la connectivité réseau entre votre conteneur Docker et l'agent Instana. Le conteneur doit pouvoir accéder à l'hôte et au port de l'agent.
Consultez les informations d'assistance.

Installation des paquets d' NuGet s et configuration des variables d'environnement

Modifier en ligne

Pour les applications et les services exécutés dans des conteneurs, procédez comme suit :

Installez les paquets NuGet suivants dans votre application .NET :
- Instana.Tracing.Core
- Instana.Tracing.Core.Rewriter.Linux
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 indiqué à l'étape suivante.
Remarque : vous pouvez ajouter le package à votre projet ou l'ajouter avant la publication.
Configurez votre fichier Dockerfile : ajoutez les variables d'environnement requises à votre fichier Dockerfile. L'exemple suivant présente un fichier Dockerfile contenant les variables d'environnement requises :
```
### your docker-image and application-build/-publish here

# set CoreCLR tracing environment variables
ENV DOTNET_STARTUP_HOOKS=/app/Instana.Tracing.Core.dll
ENV CORECLR_ENABLE_PROFILING=1
ENV CORECLR_PROFILER={cf0d821e-299b-5307-a3d8-b283c03916dd}
ENV CORECLR_PROFILER_PATH=/app/instana_tracing/CoreProfiler.so

# provide agent-endpoint
ENV INSTANA_AGENT_HOST=host_or_other_container_name_or_ip
ENV INSTANA_AGENT_PORT=42699
ENTRYPOINT ["dotnet", "YourApp.dll","some","parameters"]
```
Remplacez les valeurs suivantes :
- host_or_other_container_name_or_ip: Le nom d'hôte, le nom du conteneur ou l'adresse IP sur lequel l'agent d' Instana ation est en cours d'exécution.
- 42699: Le port sur lequel l'agent « Instana » est à l'écoute.
- YourApp.dll: Le nom de la DLL de votre application.
- some,parameters: Tout paramètre supplémentaire requis par votre application.
Compilez et exécutez votre conteneur.

Votre application est instrumentée, et l'agent d' Instana s collecte et affiche automatiquement les données de trace dans l'interface utilisateur d' Instana.

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

Pour une installation simplifiée, utilisez plutôt les images de base disponibles sur Instana. Voir les images de base Instana.

Etape suivante

Modifier en ligne