De stroom van een Cloud Services (klassieke) toepassing traceren met Azure Diagnostics

Tracering is een methode waarmee u de uitvoering van uw toepassing kunt bewaken terwijl deze wordt uitgevoerd. U kunt de klassen System.Diagnostics.Trace, System.Diagnostics.Debug en System.Diagnostics.TraceSource gebruiken om informatie over fouten en toepassingsuitvoering vast te leggen in logboeken, tekstbestanden of andere apparaten voor latere analyse. Zie Toepassingen traceren en instrumenteren voor meer informatie over tracering.

Traceringsinstructies en schakelopties voor tracering gebruiken

Implementeer tracering in uw Cloud Services-toepassing door de DiagnosticMonitorTraceListener toe te voegen aan de toepassingsconfiguratie en system.diagnostics.trace of System.Diagnostics.Debug in uw toepassingscode aan te roepen. Gebruik het configuratiebestandapp.config voor werkrollen en de web.config voor webrollen. Wanneer u een nieuwe gehoste service maakt met behulp van een Visual Studio-sjabloon, wordt Azure Diagnostics automatisch toegevoegd aan het project en wordt diagnosticMonitorTraceListener toegevoegd aan het juiste configuratiebestand voor de rollen die u toevoegt.

Zie Procedure: Traceringsinstructies toevoegen aan toepassingscode voor informatie over het plaatsen van traceringsinstructies.

Door traceringsswitches in uw code te plaatsen, kunt u bepalen of tracering plaatsvindt en hoe uitgebreid deze is. Hiermee kunt u de status van uw toepassing in een productieomgeving bewaken. Dit is met name belangrijk in een zakelijke toepassing die gebruikmaakt van meerdere onderdelen die op meerdere computers worden uitgevoerd. Zie Procedure: Traceringsswitches configureren voor meer informatie.

De traceringslistener configureren in een Azure-toepassing

Trace, Debug en TraceSource vereisen dat u 'listeners' instelt om de verzonden berichten te verzamelen en vast te leggen. Listeners verzamelen, opslaan en traceringsberichten routeren. Ze sturen de traceringsuitvoer naar een geschikt doel, zoals een logboek, venster of tekstbestand. Azure Diagnostics gebruikt de klasse DiagnosticMonitorTraceListener.

Voordat u de volgende procedure voltooit, moet u de Diagnostische monitor van Azure initialiseren. Zie Diagnostische gegevens inschakelen in Microsoft Azure om dit te doen.

Houd er rekening mee dat als u de sjablonen van Visual Studio gebruikt, de configuratie van de listener automatisch voor u wordt toegevoegd.

Een traceringslistener toevoegen

1. Open het web.config- of app.config-bestand voor uw rol.

2. Voeg de volgende code toe aan het bestand. Wijzig het kenmerk Versie om het versienummer te gebruiken van de assembly waarnaar u verwijst. De assemblyversie verandert niet noodzakelijkerwijs met elke Azure SDK-release, tenzij er updates voor zijn.

   <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>
   

   Belangrijk

   Zorg ervoor dat u een projectreferentie hebt naar de assembly Microsoft.WindowsAzure.Diagnostics. Werk het versienummer in de bovenstaande XML bij zodat deze overeenkomt met de versie van de microsoft.WindowsAzure.Diagnostics-assembly waarnaar wordt verwezen.

3. Sla het configuratiebestand op.

Zie Listeners traceren voor meer informatie over listeners.

Nadat u de stappen voor het toevoegen van de listener hebt voltooid, kunt u traceringsinstructies toevoegen aan uw code.

Een traceringsinstructie toevoegen aan uw code

1. Open een bronbestand voor uw toepassing. Bijvoorbeeld het <bestand RoleName.cs> voor de werkrol of webrol.
2. Voeg de volgende using-instructie toe als deze nog niet is toegevoegd:

       using System.Diagnostics;
   

3. Voeg Traceringsinstructies toe waar u informatie over de status van uw toepassing wilt vastleggen. U kunt verschillende methoden gebruiken om de uitvoer van de traceringsinstructie op te maken. Zie Procedure: Traceringsinstructies toevoegen aan toepassingscode voor meer informatie.
4. Sla het bronbestand op.