Partager via

Assurer le suivi du flux dans une application Cloud Services (classique) avec Diagnostics Azure

  • Article

Important

Cloud Services (classique) est désormais déconseillé pour tous les clients depuis le 1er septembre 2024. Tous les déploiements existants en cours d’exécution seront arrêtés par Microsoft, et les données seront définitivement perdues à partir d’octobre 2024. Les nouveaux déploiements doivent utiliser le nouveau modèle de déploiement basé sur Azure Resource Manager Azure Cloud Services (support étendu) .

Le suivi vous permet de superviser l’exécution de votre application alors qu’elle est en cours d’exécution. Vous pouvez utiliser les classes System.Diagnostics.Trace, System.Diagnostics.Debug et System.Diagnostics.TraceSource pour enregistrer des informations relatives aux erreurs et à l’exécution des applications dans des journaux d’activité, des fichiers texte ou d’autres périphériques pour une analyse ultérieure. Pour plus d’informations sur le suivi, consultez Applications de suivi et instrumentation.

Utilisez les instructions et commutateurs de suivi

Mettez en œuvre le suivi dans votre application Cloud Services en ajoutant DiagnosticMonitorTraceListener à la configuration d’application et en lançant des appels vers System.Diagnostics.Trace ou vers System.Diagnostics.Debug dans votre code d’application. Utilisez le fichier de configuration app.config pour les rôles de travail et le fichier web.config pour les rôles web. Lorsque vous créez un nouveau service hébergé à l’aide d’un modèle Visual Studio, Diagnostics Azure est automatiquement ajouté au projet et DiagnosticMonitorTraceListener est ajouté au fichier config approprié pour les rôles que vous ajoutez.

Pour plus d’informations sur le placement des instructions de suivi, consultez Comment : Ajoutez des instructions de traçage au code d’application.

En plaçant des Commutateurs de suivi dans votre code, vous pouvez contrôler le traçage et son importance. Le suivi vous permet de surveiller l’état de votre application dans un environnement de production. L’état de l’application de surveillance est particulièrement important dans une application métier qui utilise plusieurs composants s’exécutant sur plusieurs ordinateurs. Pour plus d’informations, consultez Procédure : Configurer des commutateurs de Trace.

Configurer l’écouteur de suivi dans une application Azure

Trace, Debug et TraceSource nécessitent que vous définissiez des « écouteurs » pour recueillir et enregistrer les messages qui sont envoyés. Les écouteurs recueillent, stockent et acheminent les messages de suivi. Ils orientent la sortie de suivi vers une cible appropriée, par exemple un journal, une fenêtre ou un fichier texte. Diagnostics Azure utilise la classe DiagnosticMonitorTraceListener .

Avant d’exécuter la procédure suivante, vous devez initialiser le moniteur de diagnostic Azure. Pour initialiser le moniteur du diagnostic Azure, consultez Activation des diagnostics dans Microsoft Azure.

Remarque

Si vous utilisez les modèles fournis par Visual Studio, la configuration de l’écouteur est automatiquement ajoutée pour vous.

Ajouter un écouteur de suivi

  1. Ouvrez le fichier web.config ou app.config correspondant à votre rôle.

  2. Ajoutez le code suivant au fichier. Modifiez l’attribut de version pour utiliser le numéro de version de l’assembly que vous référencez. La version de l’assembly ne change pas nécessairement avec chaque version du Kit de développement logiciel (SDK) Azure, sauf s’il existe des mises à jour.

    <system.diagnostics>
    <trace>
        <listeners>
            <add type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener,
              Microsoft.WindowsAzure.Diagnostics,
              Version=2.8.0.0,
              Culture=neutral,
              PublicKeyToken=31bf3856ad364e35"
              name="AzureDiagnostics">
                <filter type="" />
            </add>
        </listeners>
    </trace>
</system.diagnostics>

    Important

    Assurez-vous de disposer d’une référence de projet à l’assembly Microsoft.WindowsAzure.Diagnostics. Mettre à jour le numéro de version dans le fichier XML précédent pour la faire correspondre à la version de l’assembly Microsoft.WindowsAzure.Diagnostics référencé.

  3. Enregistrez le fichier de configuration.

Pour plus d’informations sur les écouteurs, consultez Suivi des écouteurs.

Une fois les opérations destinées à ajouter l’écouteur terminées, vous pouvez ajouter des instructions de suivi à votre code.

Pour ajouter des instructions de suivi à votre code

  1. Ouvrez un fichier source pour votre application. Par exemple, le fichier <RoleName>.cs pour le rôle de travail ou le rôle Web.
  2. Ajoutez-le au moyen de la directive s’il n’est pas présent : 
        using System.Diagnostics;
  3. Ajoutez les instructions de suivi à l’endroit où vous souhaitez capturer des informations sur l’état de votre application. Vous pouvez utiliser diverses méthodes pour mettre en forme la sortie de la déclaration de trace. Pour plus d’informations, consultez Procédure : Ajoutez des instructions de traçage au code d’application.
  4. Enregistrez le fichier source.