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

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årningsuttryck och spårningsväxlar

Implementera spårning i ditt Cloud Services-program 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årningsuttryck finns i Så här lägger du till spårningsuttryck i programkoden.

Genom att placera spårningsväxlar i koden kan du styra om spårning sker och hur omfattande den är. Med spårning kan du övervaka statusen för ditt program i en produktionsmiljö. Övervakning av programstatus ä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-diagnostikövervakaren. Information om hur du initierar Azure-diagnostikövervakaren finns i Aktivera diagnostik i Microsoft Azure.

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 versionsattributet så att det använder 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 föregående XML så att det matchar versionen av den refererade sammansättningen Microsoft.WindowsAzure.Diagnostics.

3. Spara konfigurationsfilen.

Mer information om lyssnare finns i Spåra lyssnare.

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

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

1. Öppna en källfil för ditt program. Till exempel <RoleName>.cs-filen för arbetsrollen eller webbrollen.
2. Lägg till följande användningsdirektiv om det inte finns:

       using System.Diagnostics;
   

3. Lägg till Spårningsinstruktioner där du vill samla in information om programmets tillstånd. Du kan använda olika metoder för att formatera utdata från 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.