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

Le suivi est un moyen de surveiller l’exécution de votre application pendant son 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 de configuration 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. Vous pouvez ainsi surveiller l’état de votre application dans un environnement de production, ce qui est particulièrement important dans une application 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 ce faire, voir Activation des diagnostics dans Microsoft Azure.

Notez que 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 d’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 document xml ci-dessus pour 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 la directive d’utilisation suivante si elle n’a pas encore été ajoutée :

       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 différentes méthodes pour mettre en forme la sortie de l’instruction de suivi. Pour plus d’informations, consultez Procédure : Ajoutez des instructions de traçage au code d’application.
4. Enregistrez le fichier source.