Spåra flödet för ett Cloud Services-program (klassiskt) med Azure Diagnostics

  • Artikel

Viktigt

Cloud Services (klassisk) är nu inaktuell för nya kunder och kommer att dras tillbaka den 31 augusti 2024 för alla kunder. Nya distributioner bör använda den nya Azure Resource Manager-baserade distributionsmodellen Azure Cloud Services (utökad support).

Spårning är ett sätt att övervaka körningen av ditt program medan det körs. Du kan använda klasserna System.Diagnostics.Trace, System.Diagnostics.Debug och System.Diagnostics.TraceSource för att registrera information om fel och programkörning i loggar, textfiler eller andra enheter för senare analys. Mer information om spårning finns i Spårnings- och instrumenteringsprogram.

Använda spårningsinstruktioner och spårningsväxlar

Implementera spårning i Cloud Services genom att lägga till DiagnosticMonitorTraceListener i programkonfigurationen och göra anrop till System.Diagnostics.Trace eller System.Diagnostics.Debug i programkoden. Använd konfigurationsfilen app.config för arbetsroller och web.config för webbroller. När du skapar en ny värdbaserad tjänst med hjälp av en Visual Studio-mall läggs Azure Diagnostics automatiskt till i projektet och DiagnosticMonitorTraceListener läggs till i lämplig konfigurationsfil för de roller som du lägger till.

Information om hur du placerar spårningsinstruktioner finns i How to: Add Trace Statements to Application Code (Så här lägger du till spårningsuttryck i programkod).

Genom att placera spårningsväxlar i koden kan du styra om spårningen sker och hur omfattande den är. På så sätt kan du övervaka statusen för ditt program i en produktionsmiljö. Detta är särskilt viktigt i ett affärsprogram som använder flera komponenter som körs på flera datorer. Mer information finns i Så här konfigurerar du spårningsväxlar.

Konfigurera spårningslyssnaren i ett Azure-program

Trace, Debug och TraceSource kräver att du konfigurerar "lyssnare" för att samla in och registrera de meddelanden som skickas. Lyssnare samlar in, lagrar och dirigerar spårningsmeddelanden. De dirigerar spårningsutdata till ett lämpligt mål, till exempel en logg-, fönster- eller textfil. Azure Diagnostics använder klassen DiagnosticMonitorTraceListener.

Innan du slutför följande procedur måste du initiera Azure Diagnostic Monitor. Information om hur du gör detta finns i Aktivera diagnostik i Microsoft Azure.

Observera att om du använder mallarna som tillhandahålls av Visual Studio läggs konfigurationen av lyssnaren till automatiskt åt dig.

Lägga till en spårningslyssnare

  1. Öppna filen web.config eller app.config för din roll.

  2. Lägg till följande kod i filen. Ändra attributet Version för att använda versionsnumret för den sammansättning som du refererar till. Sammansättningsversionen ändras inte nödvändigtvis med varje Azure SDK-version om det inte finns uppdateringar av den.

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

    Viktigt

    Kontrollera att du har en projektreferens till sammansättningen Microsoft.WindowsAzure.Diagnostics. Uppdatera versionsnumret i xml-koden ovan så att det matchar versionen av den refererade sammansättningen Microsoft.WindowsAzure.Diagnostics.

  3. Spara konfigurationsfilen.

Mer information om lyssnare finns i Spårningslyssnare.

När du har slutfört stegen för att lägga till lyssnaren kan du lägga till spårningsuttryck i koden.

Så här lägger du till spårningsuttryck i koden

  1. Öppna en källfil för ditt program. Till exempel <filen RoleName.cs> för arbetsrollen eller webbrollen.
  2. Lägg till följande användningsdirektiv om det inte redan har lagts till:
        using System.Diagnostics;
  3. Lägg till Trace-instruktioner där du vill samla in information om programmets tillstånd. Du kan använda en mängd olika metoder för att formatera utdata för Trace-instruktionen. Mer information finns i How to: Add Trace Statements to Application Code (Så här lägger du till spårningsuttryck i programkod).
  4. Spara källfilen.