Share via

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

  • Artikel

Belangrijk

Cloud Services (klassiek) is vanaf 1 september 2024 afgeschaft voor alle klanten. Bestaande actieve implementaties worden gestopt en afgesloten door Microsoft en de gegevens gaan vanaf oktober 2024 permanant verloren. Nieuwe implementaties moeten gebruikmaken van het nieuwe op Azure Resource Manager gebaseerde implementatiemodel Azure Cloud Services (uitgebreide ondersteuning).

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 uitvoering van toepassingen in logboeken, tekstbestanden of andere apparaten vast te leggen voor latere analyse. Zie Tracerings- en instrumentatietoepassingen voor meer informatie over tracering.

Traceringsinstructies en traceringsswitches gebruiken

Implementeer tracering in uw Cloud Services-toepassing door diagnosticMonitorTraceListener toe te voegen aan de toepassingsconfiguratie en aanroepen te doen naar System.Diagnostics.Trace of System.Diagnostics.Debug in uw toepassingscode. Gebruik de configuratiebestand app.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 de DiagnosticMonitorTraceListener toegevoegd aan het juiste configuratiebestand voor de rollen die u toevoegt.

Zie Instructies voor het plaatsen van traceringsinstructies voor informatie over het plaatsen van traceringsinstructies aan toepassingscode.

Door Trace Switches in uw code te plaatsen, kunt u bepalen of tracering plaatsvindt en hoe uitgebreid het is. Met tracering kunt u de status van uw toepassing in een productieomgeving bewaken. Het bewaken van de toepassingsstatus is vooral belangrijk in een bedrijfstoepassing die gebruikmaakt van meerdere onderdelen die op meerdere computers worden uitgevoerd. Zie Instructies voor het configureren van traceringsswitches voor meer informatie.

De traceerlistener configureren in een Azure-toepassing

Voor tracering, foutopsporing en TraceSource moet u listeners instellen om de verzonden berichten te verzamelen en vast te leggen. Listeners verzamelen, opslaan en routetraceren berichten. Ze leiden de traceringsuitvoer naar een geschikt doel, zoals een logboek, venster of tekstbestand. Azure Diagnostics maakt gebruik van de klasse DiagnosticMonitorTraceListener .

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

Notitie

Als u de sjablonen gebruikt die door Visual Studio worden geleverd, wordt de configuratie van de listener automatisch voor u toegevoegd.

Een traceerlistener toevoegen

  1. Open het bestand web.config of app.config 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 wordt niet noodzakelijkerwijs gewijzigd bij elke Azure SDK-release, tenzij er updates 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 voorgaande XML bij zodat deze overeenkomt met de versie van de microsoft.WindowsAzure.Diagnostics-assembly waarnaar wordt verwezen.

  3. Sla het configuratiebestand op.

Zie Trace Listeners voor meer informatie over listeners.

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

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 niet aanwezig is: 
        using System.Diagnostics;
  3. Voeg traceringsinstructies toe waar u informatie wilt vastleggen over de status van uw toepassing. U kunt verschillende methoden gebruiken om de uitvoer van de Trace-instructie op te maken. Zie Instructies voor meer informatie : Traceringsinstructies toevoegen aan toepassingscode.
  4. Sla het bronbestand op.