Configuration du suivi d'.NET s sur Cloud Foundry

Modifier en ligne

Vous pouvez mettre en place le traçage d'.NET Core s sur Cloud Foundry en configurant votre application pour qu'elle génère des données de traçage et en la connectant à l'agent Instana exécuté sur les nœuds Diego.

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

Avant d'activer le suivi d'.NET s sur Cloud Foundry, assurez-vous que les conditions préalables suivantes sont remplies :

  • L'agent « Instana » est en cours d'exécution sur les nœuds Diego de la plateforme « Cloud Foundry ». Pour plus d'informations sur la configuration des agents d' Instana, ainsi que sur les fonctionnalités associées d' Cloud Foundry ou de Pivotal Platform, consultez la documentation d' Cloud Foundry et de Pivotal Platform.
  • Consultez les informations d'assistance.
Remarque : cette configuration s'applique uniquement aux applications non autonomes de l'.NET sur Cloud Foundry.

Activation du traçage d'.NET

Modifier en ligne

Pour activer le traçage dans votre application .NET Core hébergée sur Cloud Foundry, procédez comme suit :

Étape 1 : Installez le paquet « Instana » ( NuGet )

Modifier en ligne

Ajoutez le module de traçage « Instana » à votre application « Cloud Foundry » en exécutant la commande suivante :

dotnet add myproject.csproj package Instana.Tracing.Core.Rewriter.Linux

Remplacez myproject.csproj par le nom réel de votre fichier de projet.

Étape 2 : Préparer la demande en vue de sa publication

Modifier en ligne

Préparez votre application .NET en vue de sa publication en exécutant la commande suivante :

dotnet publish -c Release

Cette commande publie l'application dans Release la configuration. Vous pouvez utiliser une autre configuration si nécessaire.

Étape 3 : Configurer les variables d'environnement (si vous n'utilisez pasRelease de fichier de configuration)

Modifier en ligne

Si vous utilisez une configuration différente de Release celle-ci, définissez les variables d'environnement requises dans le manifeste de l'application (manifest.yml).

---
applications:
- name: <application_name>
  path: bin/Release/<TargetFramework>/publish/
  env:
    DOTNET_STARTUP_HOOKS:[path-to-your-app]/Instana.Tracing.Core.dll
    CORECLR_ENABLE_PROFILING: 1
    CORECLR_PROFILER: "{cf0d821e-299b-5307-a3d8-b283c03916dd}"
    CORECLR_PROFILER_PATH: "/home/vcap/app/instana_tracing/CoreProfiler.so"
    LD_LIBRARY_PATH: "/home/vcap/app/instana_tracing"

Remplacez <application_name> par le nom réel de votre application.

Remarque : selon le SDK d'.NET utilisé et le nom de configuration transmis à la dotnet publish commande via l'option -c (Release dans l'exemple), la valeur de la path variable peut varier.

Étape 4 : Déployer l'application sur Cloud Foundry

Modifier en ligne

Déployez votre application sur Cloud Foundry en exécutant la commande suivante :

cf push
Remarque : cette commande suppose que le fichier de l'application manifest.yml se trouve dans le même dossier que celui à partir duquel vous exécutez la cf push commande.

Pour plus d'informations sur l'utilisation de la cf push commande avec un fichier manifeste, consultez la section « Déploiement avec des manifestes d'application ».

Étape 5 : Vérifiez que le traçage fonctionne

Modifier en ligne

Une fois l'application déployée, vérifiez que les traces sont bien collectées :

  1. Dans le menu de navigation de l'interface utilisateur d' Instana, sélectionnez Applications > Services.
  2. Sélectionnez le service surveillé pour consulter les traces et les informations recueillies.