Konfigurera diagnostik för Azure Cloud Services (utökad support) och virtuella datorer

Not

Den här artikeln gäller för Azure Azure Cloud Services (utökad support). Cloud Services (klassisk) har dragits tillbaka från och med den 31 augusti 2024. Mer information finns i Distributionsmodellen för molntjänster (klassisk) upphör den 31 augusti 2024. För ny utveckling rekommenderar vi att du använder en nyare tjänsttyp som utformats för ditt specifika ändamål, till exempel Azure App Service, Azure Functionseller Azure Container Apps. Den senaste listan över tillgängliga tjänster finns i Directory för Azure-produkter.

När du behöver felsöka en Azure Cloud Services-tjänst (utökad support) eller virtuell dator kan du använda Visual Studio för att enklare konfigurera Azure Diagnostics. Diagnostik samlar in systemdata och loggningsdata på de virtuella datorer och virtuella datorinstanser som kör molntjänsten. Diagnostikdata överförs till ett lagringskonto som du väljer. Mer information om diagnostikloggning i Azure finns i Aktivera diagnostikloggning för Web Apps i Azure App Service.

I den här artikeln visar vi hur du använder Visual Studio för att aktivera och konfigurera Azure Diagnostics. Lär dig hur du konfigurerar diagnostik på virtuella Azure-datorer, hur du väljer vilka typer av diagnostikinformation som ska samlas in och hur du visar informationen när den har samlats in.

Om du vill konfigurera Azure Diagnostics ändrar du diagnostikinställningarna i dialogrutan Diagnostikkonfiguration i Visual Studio. Inställningarna sparas i en fil med namnet diagnostics.wadcfgx. Du kan också ändra konfigurationsfilen direkt. Om du uppdaterar filen manuellt börjar konfigurationsändringarna gälla nästa gång du distribuerar molntjänsten till Azure eller kör tjänsten i emulatorn.

Varning

I Visual Studio 2022 ersattes den inaktuella Azure Storage-emulatorn med Azurite-emulatorn när du felsöker dina Molntjänstprojekt. Den här Azurite-emulatorn fungerar inte med plugin-programmet Azure Diagnostics, som ger stöd för Azure Diagnostics när du kör och testar lokalt. Om du behöver plugin-programmet för lokala scenarier för körning och testning kan du antingen uppdatera anslutningssträngen i den lokala tjänstkonfigurationen (.cscfg) till ett Azure Storage-konto (se Hantera anslutningssträngar för lagringskonton) eller ladda ned den tidigare Azure Storage-emulatorn. I Visual Studio 17.10-versionen görs det lokala Azure Diagnostics-insticksprogrammet inaktuellt och inaktiverat som standard, men det finns möjlighet att aktivera det i denna version. Plugin-programmet togs bort i Visual Studio 17.11. Det här plugin-programmet användes endast med den lokala Azure Compute-emulatorn och inaktivering påverkar inte distribuerade Molntjänster som använder Azure Diagnostics-tillägget i Azure. Om du vill aktivera plugin-programmet för diagnostik i Visual Studio 17.10 lägger du till följande egenskapsinställning i alla PropertyGroup i projektfilen: <EnableEmulatorDiagnosticsPlugin>True</EnableEmulatorDiagnosticsPlugin>.

Så här avgör Visual Studio diagnostiklagringskontot

• Om en diagnostikanslutningssträng anges i filen .cscfg använder Visual Studio den för att konfigurera diagnostiktillägget under publiceringen och när det genererar xml-filerna för offentlig konfiguration under paketeringen.
• Om en diagnostikanslutningssträng inte anges i .cscfg-filen återgår Visual Studio till att använda lagringskontot som anges i filen .wadcfgx för att konfigurera diagnostiktillägget för publicering och för att generera XML-filerna för offentlig konfiguration under paketeringen.
• Anslutningssträngen för diagnostik i .cscfg-filen har företräde framför lagringskontot i .wadcfgx-filen. Om en diagnostikanslutningssträng anges i .cscfg-filen använder Visual Studio anslutningssträngen och ignorerar lagringskontot i .wadcfgx.

Vad gör kryssrutan "Uppdatera anslutningssträngar för utvecklingslagring..."?

Kryssrutan Uppdatera anslutningssträngar för utvecklingslagring för diagnostik och cachelagring med autentiseringsuppgifter för Microsoft Azure-lagringskonto vid publicering till Microsoft Azure är ett bekvämt sätt att uppdatera anslutningssträngar för utvecklingslagringskonton med det Azure Storage-konto som du anger under publiceringen. När du publicerar projektet till Azure uppdaterar Visual Studio automatiskt diagnostikanslutningssträngen med det lagringskonto som du angav i guiden Publicera. Men om ett verkligt lagringskonto angavs som anslutningssträng för diagnostik används kontot i stället.

Konfigurera diagnostikdatakällor

När du har aktiverat insamling av diagnostikdata kan du välja exakt vilka datakällor du vill samla in och vilken information som samlas in. I nästa avsnitt beskrivs flikarna i dialogrutan Diagnostikkonfiguration och vad varje konfigurationsalternativ innebär.

Programloggar

Programloggar har diagnostikinformation som skapas av ett webbprogram. Om du vill samla in programloggar markerar du kryssrutan Aktivera överföring av programloggar. Om du vill öka eller minska intervallet mellan överföringen av programloggar till ditt lagringskonto ändrar du värdet överföringsperiod (min). Du kan också ändra mängden information som samlas in i loggen genom att ange värdet loggnivå. Välj till exempel Utförligt för att få mer information, eller välj Kritiskt för att endast samla in kritiska fel. Om du har en specifik diagnostikleverantör som genererar programloggar kan du fånga upp loggarna genom att lägga till leverantörens globalt unika identifierare (GUID) i rutan Provider GUID.

Mer information om programloggar finns i Aktivera diagnostikloggning för Web Apps i Azure App Service.

Windows-händelseloggar

Om du vill samla in Windows-händelseloggar markerar du kryssrutan Aktivera överföring av Windows-händelseloggar. Om du vill öka eller minska intervallet mellan överföringen av händelseloggar till ditt lagringskonto ändrar du värdet överföringsperiod (min). Markera kryssrutorna för de typer av händelser som du vill spåra.

Om du vill ange en anpassad datakälla anger du den i textrutan <Datakällans namn> och väljer sedan Lägg till. Datakällan läggs till i filen diagnostics.cfcfg.

Prestandaräknare

Information om prestandaräknare kan hjälpa dig att hitta systemflaskhalsar och finjustera system- och programprestanda. Mer information finns i Skapa och använda prestandaräknare i ett Azure-program. Om du vill samla in prestandaräknare markerar du kryssrutan Aktivera överföring av prestandaräknare. Om du vill öka eller minska intervallet mellan överföringen av händelseloggar till ditt lagringskonto ändrar du värdet överföringsperiod (min). Markera kryssrutorna för de prestandaräknare som du vill spåra.

Om du vill spåra en prestandaräknare som inte visas anger du prestandaräknaren med hjälp av den föreslagna syntaxen. och välj sedan Lägg till. Operativsystemet på den virtuella datorn avgör vilka prestandaräknare du kan spåra. Mer information om syntax finns i Ange en räknarsökväg.

Infrastrukturlogg

Infrastrukturloggar innehåller information om Azure-diagnostikinfrastrukturen, RemoteAccess-modulen och RemoteForwarder-modulen. Om du vill samla in information om infrastrukturloggar markerar du kryssrutan Aktivera överföring av infrastrukturloggar. Om du vill öka eller minska intervallet mellan överföringen av infrastrukturloggar till ditt lagringskonto ändrar du värdet överföringsperiod (min).

Mer information finns i Samla in loggningsdata med hjälp av Azure Diagnostics.

Loggkataloger

Loggkataloger har data som samlas in från loggkataloger för IIS-begäranden (Internet Information Services), misslyckade begäranden eller mappar som du väljer. Om du vill samla in loggkataloger markerar du kryssrutan Aktivera överföring av loggkataloger. Om du vill öka eller minska intervallet mellan överföringen av loggar till ditt lagringskonto ändrar du värdet överföringsperiod (min).

Markera kryssrutorna för de loggar som du vill samla in, till exempel IIS-loggar och misslyckade begärandeloggar. Standardnamn för lagringscontainer tillhandahålls, men du kan ändra namnen.

Du kan samla in loggar från valfri mapp. Ange sökvägen i Logg i avsnittet Absolut katalog och välj sedan Lägg till katalog. Loggarna fångas upp i de angivna containrarna.

ETW-loggar

Om du använder Händelsespårning för Windows (ETW) (ETW) och vill fånga ETW-loggar väljer du kryssrutan Aktivera överföring av ETW-loggar. Om du vill öka eller minska intervallet mellan överföringen av loggar till ditt lagringskonto ändrar du värdet överföringsperiod (min).

Händelserna samlas in från händelsekällor och händelsemanifest som du anger. Om du vill ange en händelsekälla i avsnittet Händelsekällor anger du ett namn och väljer sedan Lägg till händelsekälla. På samma sätt kan du ange ett händelsemanifest i avsnittet Händelsemanifest och sedan välja Lägg till händelsemanifest.

ETW-ramverket stöds i ASP.NET via klasser i System.Diagnostics.aspx namnområdet. Namnområdet Microsoft.WindowsAzure.Diagnostics, som ärver från och utökar standardklasserna System.Diagnostics.aspx, möjliggör användning av System.Diagnostics.aspx som ett loggningsramverk i Azure-miljön. Mer information finns i Ta kontroll över loggning och spårning i Microsoft Azure och Aktivera diagnostik i Azure Cloud Services (utökad support) och virtuella datorer.

Kraschdumpar

Om du vill samla in information om när en rollinstans kraschar markerar du kryssrutan Aktivera överföring av kraschdumpar. (Eftersom ASP.NET hanterar de flesta undantag är detta vanligtvis endast användbart för arbetsroller.) Om du vill öka eller minska procentandelen lagringsutrymme som ägnas åt kraschdumpar ändrar du katalogkvot (%) värdet. Du kan ändra lagringscontainern där kraschdumpar lagras och välja om du vill samla in en Fullständig eller Mini dump.

De processer som för närvarande spåras visas i nästa skärmbild. Markera kryssrutorna för de processer som du vill samla in. Om du vill lägga till ytterligare en process i listan anger du processnamnet och väljer sedan Lägg till process.

Mer information finns i Ta kontroll över loggning och spårning i Microsoft Azure.

Felsöka problem med Azure Cloud Services (utökad support)

Om du får problem med dina molntjänstprojekt, till exempel en roll som fastnar i statusen "upptagen", återvinner flera gånger eller utlöser ett internt serverfel, finns det verktyg och tekniker som du kan använda för att diagnostisera och åtgärda problemet. Specifika exempel på vanliga problem och lösningar och en översikt över de begrepp och verktyg som du kan använda för att diagnostisera och åtgärda dessa fel finns i PaaS-beräkningsdiagnostikdata (Plattform som en tjänst) i Azure.

Q & A

Vad är buffertstorleken och hur stor ska den vara?

På varje virtuell datorinstans begränsar kvoterna hur mycket diagnostikdata som kan lagras i det lokala filsystemet. Dessutom anger du en buffertstorlek för varje typ av diagnostikdata som är tillgängliga. Den här buffertstorleken fungerar som en enskild kvot för den typen av data. Information om hur du fastställer den totala kvoten och mängden minne som återstår finns längst ned i dialogrutan för diagnostikdatatypen. Om du anger större buffertar eller fler typer av data närmar du dig den totala kvoten. Du kan ändra den totala kvoten genom att ändra konfigurationsfilen diagnostics.wadcfgx. Diagnostikdata lagras i samma filsystem som programmets data. Om programmet använder en stor mängd diskutrymme bör du inte öka den totala diagnostikkvoten.

Vad är överföringsperioden och hur lång ska den vara?

Överföringsperioden är den tid som förflutit mellan datainsamlingar. Efter varje överföringsperiod flyttas data från det lokala filsystemet på en virtuell dator till tabeller i ditt lagringskonto. Om mängden data som samlas in överskrider kvoten före slutet av en överföringsperiod ignoreras äldre data. Om du förlorar data på grund av att dina data överskrider buffertstorleken eller den totala kvoten kanske du vill minska överföringsperioden.

Vilken tidszon finns tidsstämplarna i?

Tidsstämplar finns i den lokala tidszonen för det datacenter som är värd för din molntjänst. Följande tre tidsstämpelkolumner i loggtabellerna används:

• PreciseTimeStamp: ETW-tidsstämpeln för händelsen. Det vill: den tid då händelsen loggas från klienten.
• TIMESTAMP: Värdet för PreciseTimeStamp avrundat nedåt till gränsen för uppladdningsfrekvens. Om din uppladdningsfrekvens till exempel är 5 minuter och händelsetiden 00:17:12 är TIMESTAMP 00:15:00.
• Tidsstämpel: Tidsstämpeln då entiteten skapades i Azure-tabellen.

Hur hanterar jag kostnader när jag samlar in diagnostikinformation?

Standardinställningarna (Loggnivå inställd på Feloch Överföringsperiod inställd på 1 minut) är utformade för att minimera kostnaderna. Dina beräkningskostnader ökar när du samlar in mer diagnostikdata eller om du minskar överföringsperioden. Samla inte in mer data än du behöver och glöm inte att inaktivera datainsamling när du inte längre behöver dem. Du kan alltid aktivera den igen, även vid körning, enligt beskrivningen tidigare i den här artikeln.

Hur samlar jag in loggar för misslyckade begäranden från IIS?

IIS samlar som standard inte in loggar för misslyckade begäranden. Du kan konfigurera IIS för att samla in loggar för misslyckade begäranden genom att redigera web.config-filen för webbrollen.

Jag får inte spårningsinformation från RoleEntryPoint-metoder som OnStart. Vad är fel?

Metoderna för RoleEntryPoint anropas i kontexten för WAIISHost.exe, inte i IIS. Konfigurationsinformationen i web.config som normalt aktiverar spårning gäller inte. Lös problemet genom att lägga till en .config fil i webbrollsprojektet och namnge filen så att den matchar utdatasammansättningen som innehåller RoleEntryPoint- kod. I standardprojektet för webbrollen ska namnet på den .config filen vara WAIISHost.exe.config. Lägg till följande rader i den här filen:

<system.diagnostics>
  <trace>
      <listeners>
          <add name "AzureDiagnostics" type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener">
              <filter type="" />
          </add>
      </listeners>
  </trace>
</system.diagnostics>

I fönstret Egenskaper anger du egenskapen Kopiera till utdatakatalog till Kopiera alltid.

Relaterat innehåll

Mer information om diagnostikloggning i Azure finns i Aktivera diagnostik i Azure Cloud Services (utökad support) och virtuella datorer och Aktivera diagnostikloggning för Web Apps i Azure App Service.