Configuration du traçage d'.NET s sur les applications conteneurisées d' Azure

Modifier en ligne

Vous pouvez activer le traçage pour les applications d'.NET Core s qui s'exécutent sur Azure Container Apps en configurant le SDK de traçage Instana dans votre application et en le connectant à Instana à l'aide de l'agent sans serveur Instana.

Pour découvrir comment Instana surveille les applications .NET, consultez la page « Comment fonctionne la surveillance d'.NET ».

Avant de commencer

Modifier en ligne

Avant d'activer le traçage pour une application .NET Core sur Azure Container Apps, assurez-vous que les conditions préalables suivantes sont remplies :

  • Vous disposez d'un compte Instana actif vous donnant accès à l'interface utilisateur Instana.
  • Vous disposez d'un abonnement à Azure, qui inclut les applications de conteneurs d' Azure.
  • Consultez les informations relatives à la prise en charge afin de vous assurer de la compatibilité avec votre version d'.NET. et votre environnement d'exécution.

Activation du traçage d'.NET

Modifier en ligne

Pour activer le traçage dans votre application .NET Core hébergée sur Azure Container App Service, procédez comme suit :

Étape 2 : Mettre à jour le fichier Dockerfile

Modifier en ligne

Configurez l'.NET Core ez les variables d'environnement de traçage dans votre Dockerfile :

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

Étape 3 : Créer et déployer une application conteneurisée sur Azure

Modifier en ligne
  1. Go vers le portail de l' Azure.
  2. Recherchez « Container Apps » et sélectionnez « Container Apps ».
  3. Créez un groupe de ressources s'il n'en existe pas :
    1. Sur la page « Applications conteneurisées », cliquez sur « Créer ».
    2. Sélectionnez « Groupe de ressources », puis cliquez sur « Créer un nouveau ».
    3. Saisissez un nom (par exemple, myResourceGroup), sélectionnez une région, puis cliquez sur OK.
  4. Créer un environnement Container Apps :
    1. Dans l'onglet « Paramètres de base », sélectionnez « Abonnement », puis le groupe de ressources créé précédemment.
    2. Saisissez un nom pour l'application conteneur (par exemple, myDotnetApp).
    3. Sélectionnez une région, puis cliquez sur Suivant : Environnement.
    4. Dans la section Environnement, cliquez sur Créer un nouvel environnement et saisissez un nom d'environnement (par exemple, myContainerAppEnv).
    5. Sélectionnez une région et un espace de travail Log Analytics.
    6. Cliquez sur « Vérifier + Créer », puis sur « Créer ».
  5. Déployer une application.NET Core :
    1. Dans le portail de l' Azure, rendez-vous sur AzureContainer Registry (ACR) et créez un nouveau registre s'il n'existe pas encore.
    2. Importez votre image « Docker » dans ACR (par exemple, mycontainerregistry.azurecr.io/my-dotnet-app:v1). Assurez-vous que votre application « .NET Core » est conteneurisée à l'aide de Docker.
    3. Dans « Applications conteneurisées » d' Azure, cliquez sur « Créer une application conteneurisée ».
    4. Sélectionnez le groupe de ressources créé et l'environnement Container App.
    5. Dans les paramètres du conteneur, sélectionnez « Docker Hub » ou « Azure Container Registry » et indiquez le nom de l'image.
    6. Définissez le port du conteneur (par exemple, 80).
    7. Activez Ingress et sélectionnez « Accès externe ».
    8. Cliquez sur « Vérifier + Créer », puis sur « Créer ».

Étape 4 : Configurer les paramètres de l'agent sans serveur d' Instana

Modifier en ligne
  1. Connectez-vous à votre compte Instana (par exemple : https://sesandbox-instana.instana.io).
  2. Récupérez l' URL du point de terminaison Instana et la clé de l'agent Instana :
    1. Dans le menu de navigation de l'interface utilisateur d' Instana, sélectionnez Plus > Agents > Installer des agents.
    2. Sélectionnez les applications conteneurisées d' Azure.
    3. Copiez l'URL de l'endpoint Instana, l'identifiant d' URL, ainsi que la clé de l'agent.
  3. Définissez les variables d'environnement dans le portail Azure :
    1. Go vers les applications conteneurisées d' Azure dans le portail d' Azure.
    2. Sélectionnez votre application conteneurisée.
    3. Cliquez sur Paramètres > Variables d'environnement.
    4. Ajoutez les variables d'environnement suivantes :
      CORECLR_ENABLE_PROFILING = 1
CORECLR_PROFILER = {cf0d821e-299b-5307-a3d8-b283c03916dd}
CORECLR_PROFILER_PATH = /app/instana_tracing/CoreProfiler.so
DOTNET_STARTUP_HOOKS = /app/Instana.Tracing.Core.dll
INSTANA_ENDPOINT_URL = instana_endpoint_url
AZURE_SUBSCRIPTION_ID = your_azure_subscription_id
AZURE_RESOURCE_GROUP = your_azure_resource_group
INSTANA_SERVICE_NAME = your_service_name
INSTANA_AGENT_KEY = your_instana_agent_key
      Remarque : INSTANA_SERVICE_NAME est le nom du service que vous souhaitez surveiller, par exemple dotnetcore-webapp.
    5. Sauvegardez les modifications.

Étape 5 : Vérifier la configuration

Modifier en ligne

Dans le menu de navigation de l'interface utilisateur d' Instana, accédez à Applications > Services pour consulter les métriques et les traces collectées.