Visningsverktyg för tjänstspårning (SvcTraceViewer.exe)
Verktyget Windows Communication Foundation (WCF) Service Trace Viewer hjälper dig att analysera diagnostikspårningar som genereras av WCF. Service Trace Viewer är ett sätt att enkelt sammanfoga, visa och filtrera spårningsmeddelanden i loggen så att du kan diagnostisera, reparera och verifiera problem med WCF-tjänsten.
Konfigurera spårning
Med diagnostikspårningar får du information som visar vad som händer under programmets drift. Som namnet antyder kan du följa åtgärder från källan till målet och via mellanliggande punkter också.
Du kan konfigurera spårning med hjälp av programmets konfigurationsfil– antingen Web.config för webbaserade program eller Appname.config för program med egen värd. Följande utgör ett exempel:
<system.diagnostics>
<trace autoflush="true" />
<sources>
<source name="System.ServiceModel"
switchValue="Information, ActivityTracing"
propagateActivity="true">
<listeners>
<add name="sdt"
type="System.Diagnostics.XmlWriterTraceListener"
initializeData= "SdrConfigExample.e2e" />
</listeners>
</source>
</sources>
</system.diagnostics>
I det här exemplet anges namnet och typen av spårningslyssnare. Lyssnaren heter sdt och standardspårningslyssnaren för .NET Framework (System.Diagnostics.XmlWriterTraceListener) läggs till som typ. Attributet initializeData används för att ange namnet på loggfilen för lyssnaren till SdrConfigExample.e2e. För loggfilen kan du ersätta en fullständigt kvalificerad sökväg med ett enkelt filnamn.
Exemplet skapar en fil i rotkatalogen med namnet SdrConfigExample.e2e. När du använder Spårningsvisaren för att öppna filen enligt beskrivningen i avsnittet "Öppna och visa WCF-spårningsfiler" kan du se alla meddelanden som har skickats.
Spårningsnivån styrs av inställningen switchValue . Tillgängliga spårningsnivåer beskrivs i följande tabell.
| Spårningsnivå | beskrivning |
|---|---|
| Kritiskt | – Loggar poster för felsnabb och händelselogg och spårning av korrelationsinformation. Följande är några exempel på när du kan använda nivån Kritisk: – Din AppDomain gick ned på grund av ett ohanterat undantag. – Det går inte att starta programmet. – Meddelandet som orsakade felet kom från processen MyApp.exe. |
| Fel | – Loggar alla undantag. Du kan använda felnivån i följande situationer: - Koden kraschade på grund av ett ogiltigt cast-undantag. – Ett undantag för "det gick inte att skapa slutpunkten" gör att programmet misslyckas vid start. |
| Varning | – Det finns ett villkor som senare kan leda till ett fel eller ett kritiskt fel. Du kan använda den här nivån i följande situationer: – Programmet tar emot fler begäranden än vad inställningarna för begränsning tillåter. – Den mottagande kön ligger på 98 procent av den konfigurerade kapaciteten. |
| Information | – Meddelanden som är användbara för att övervaka och diagnostisera systemstatus, mäta prestanda eller profilering genereras. Du kan använda sådan information för kapacitetsplanering och prestandahantering. Du kan använda den här nivån i följande situationer: – Ett fel uppstod när meddelandet nådde AppDomain och deserialiserades. – Ett fel inträffade när HTTP-bindningen skapades. |
| Utförlig | – Spårning på felsökningsnivå för både användarkod och service. Ange den här nivån när: – Du är inte säker på vilken metod i koden som anropades när felet inträffade. – Du har konfigurerat en felaktig slutpunkt och tjänsten kunde inte starta eftersom posten i reservationsarkivet är låst. |
| ActivityTracing | Flödeshändelser mellan bearbetningsaktiviteter och komponenter. På den här nivån kan administratörer och utvecklare korrelera program i samma programdomän. – Spårningar för aktivitetsgränser: start/stopp. - Spårningar för överföringar. |
Du kan använda add för att ange namnet och typen av spårningslyssnare som du vill använda. I exempelkonfigurationen namnges sdt lyssnaren och standardspårningslyssnaren för .NET Framework (System.Diagnostics.XmlWriterTraceListener) läggs till som typ. Använd initializeData för att ange namnet på loggfilen för lyssnaren. Dessutom kan du ersätta en fullständigt kvalificerad sökväg med ett enkelt filnamn.
Från och med .NET Framework 4.8 visas ComboBox-kontroller i vissa högkontrasteman i rätt färg. Du kan inaktivera den här ändringen genom att ta bort följande inställning från filen svcTraceViewer.exe.config :
<AppContextSwitchOverrides value="Switch.UseLegacyAccessibilityFeatures=false;Switch.UseLegacyAccessibilityFeatures.2=false" />
Använda visningsverktyget för tjänstspårning
Öppna och visa WCF-spårningsfiler
Service Trace Viewer har stöd för tre filtyper:
WCF-spårningsfil (.svcLog)
Händelsespårningsfil (.etl)
Crimson Spårningsfil
Med Service Trace Viewer kan du öppna alla spårningsfiler som stöds, lägga till och integrera ytterligare spårningsfiler eller öppna och slå samman en grupp spårningsfiler samtidigt.
Öppna en spårningsfil
- Starta Visningsprogram för tjänstspårning med hjälp av ett kommandofönster för att navigera till WCF-installationsplatsen (C:\Program Files\Microsoft SDK:er\Windows\v6.0\Bin) och skriv
SvcTraceViewer.exesedan .
Kommentar
Verktyget Service Trace Viewer kan associeras med två filtyper: .svclog och .stvproj. Du kan använda två parametrar på kommandoraden för att registrera och avregistrera filnamnstilläggen.
/register: registrera associationen för filnamnstilläggen ".svclog" och ".stvproj" med SvcTraceViewer.exe
/unregister: avregistrera associationen för filnamnstilläggen ".svclog" och ".stvproj" med SvcTraceViewer.exe
När Service Trace Viewer startar klickar du på Arkiv och pekar sedan på Öppna. Navigera till den plats där spårningsfilerna lagras.
Dubbelklicka på den spårningsfil som du vill öppna.
Kommentar
Tryck på SKIFT medan du klickar på flera spårningsfiler för att välja och öppna dem samtidigt. Service Trace Viewer sammanfogar innehållet i alla filer och visar en vy. Du kan till exempel öppna spårningsfiler för både klient och tjänst. Detta är användbart när du har aktiverat meddelandeloggning och aktivitetsspridning i konfigurationen. På så sätt kan du undersöka meddelandeutbyte mellan klient och tjänst. Du kan också dra flera filer till visningsprogrammet eller använda fliken Projekt . Mer information finns i avsnittet Hantera projekt.
Om du vill lägga till ytterligare spårningsfiler i samlingen som är öppen klickar du på Arkiv och pekar sedan på Lägg till. I fönstret som öppnas navigerar du till platsen för spårningsfilerna och dubbelklickar på den fil som du vill lägga till.
Varning
Vi rekommenderar inte att du läser in en spårningsloggfil som är större än 200 MB. Om du försöker läsa in en fil som är större än den här gränsen kan inläsningsprocessen ta lång tid, beroende på datorresursen. Service Trace Viewer-verktyget kanske inte är responsivt under en längre tid, eller så kan det uttömma datorns minne. Vi rekommenderar att du konfigurerar partiell inläsning för att undvika detta. Mer information om hur du gör detta finns i avsnittet "Läser in stora spårningsfiler".
Händelsespårning och Crimson-spårning
Visningsprogrammets interna format är det aktivitetsspårningsformat som WCF genererar. Spårningar som genereras i ett annat format måste konverteras innan visningsprogrammet visar dem. Förutom aktivitetsspårningsformatet stöder visningsprogrammet för närvarande spårning av händelser och crimson-spårning.
När du öppnar en fil som inte innehåller aktivitetsspårningar försöker visningsprogrammet konvertera filen. Du måste ange namnet och platsen för filen som ska innehålla konverterade spårningsdata. När data har konverterats visar visningsprogrammet innehållet i den nya filen.
Kommentar
Konvertering kräver diskutrymme för att lagra konverterade spårningsdata. Kontrollera att du har tillräckligt med diskutrymme för att lagra data innan du påbörjar en konvertering. Annars misslyckas konverteringen.
Hantera projekt
Visningsprogrammet stöder projekt för att underlätta visning av flera spårningsfiler. Om du till exempel har en klientspårningsfil och en tjänstspårningsfil kan du lägga till dem i ett projekt. Varje gång du öppnar projektet läses sedan alla spårningsfiler i projektet in samtidigt.
Det finns två sätt att hantera projekt:
I menyn Arkiv kan du öppna, spara och stänga projekt.
På fliken Projekt kan du lägga till filer i ett projekt.
Visa WCF-spårningar
WCF genererar spårningar med hjälp av aktivitetsspårningsformatet. I aktivitetsspårningsmodellen grupperas enskilda spårningar i aktiviteter enligt deras syfte. Flöde för logisk kontroll överförs mellan aktiviteter. Under programmets livslängd visas till exempel många "meddelandesändningsaktiviteter" och försvinner. Mer information om hur du visar spårningar och aktiviteter samt användargränssnittet för Service Trace Viewer finns i Använda tjänstspårningsvisaren för att visa korrelerade spårningar och felsökning.
Växla till olika vyer
Visningsprogrammet för tjänstspårning innehåller följande olika vyer. De visas som flikar i den vänstra rutan i Visningsprogrammet och kan också nås från menyn Visa .
Aktivitetsvy
Projektvy
Meddelandevy
Diagramvy
Aktivitetsvy
När spårningsfilerna har öppnats kan du se spårningarna grupperade i aktiviteter och visas i aktivitetsvyn i den vänstra rutan.
I vyn Aktivitet visas aktivitetsnamn, antal spårningar i aktiviteten, varaktighetstid, starttid och sluttid.
Genom att klicka på någon av de aktiviteter som visas visas spårningarna i den här aktiviteten i spårningsfönstret till höger. Du kan sedan välja en spårning för att visa dess information.
Du kan välja flera aktiviteter genom att trycka på Ctrl- eller Skift-tangenten och klicka på önskade aktiviteter. Spårningsfönstret visar alla spårningar av de valda aktiviteterna.
Du kan dubbelklicka på en aktivitet för att visa den i Graph View. Det alternativa sättet är att välja en aktivitet och växla till Graph View.
Kommentar
Aktiviteten "00000000000000" är en särskild aktivitet som inte kan visas i grafvyn. Eftersom alla andra aktiviteter är länkade till den har det en allvarlig prestandapåverkan att visa den här aktiviteten.
Du kan klicka på kolumnrubriken för att sortera aktivitetslistan. Aktiviteter som innehåller varningsspårningar har en gul bakgrund och de som innehåller felspårningar har en röd.
Det finns olika typer av aktiviteter och varje typ motsvarar en ikon till vänster om varje aktivitet. Du kan läsa avsnittet Förstå spårningsikoner för deras innebörd.
Projektvy
Med den här vyn kan du hantera spårningsfiler i det aktuella projektet. Mer information finns i avsnittet Hantera projekt.
Meddelandevy
Med den här vyn kan du visa alla spårningar av meddelandeloggar, inklusive Åtgärd, Datum/tid, Process, Aktivitet och Från/Till, och navigera till information om den associerade spårningen av meddelandeloggen. Du kan gruppera spårningar av meddelandeloggen efter Aktivitetsgräns, Process/Tråd eller Skicka och ta emot för enklare navigering av meddelandeflödet.
Diagramvy
Den här vyn visar spårningsdata för en viss aktivitet i diagramform. Med diagramformuläret kan du se stegvis körning av händelser och sambanden mellan flera aktiviteter när data flyttas mellan dem.
Om du vill växla till Graph-vyn väljer du en aktivitet i aktivitetsvyn och klickar på fliken Aktivitet eller en spårning av meddelandeloggen i meddelandevyn. Om flera spårningsfiler läses in och aktiviteten omfattar spårningar från mer än en fil visas alla relevanta spårningar i grafvyn. Om du dubbelklickar på aktiviteter och spårningar av meddelandeloggar leder du även till Graph-vyn .
I grafvyn representerar varje lodrät kolumn en aktivitet, och varje block i kolumnen representerar en spårning. Aktiviteterna grupperas efter process (eller tråd). De små pilarna mellan aktiviteterna representerar överföringar. De stora pilarna mellan processer representerar meddelandeutbyte. Aktiviteten i markeringen är alltid gul.
Välja spårningar i grafen
Klicka på ett block i diagrammet.
Använd upp- och nednycklarna för att välja dess närliggande spårningar.
Observera spårningsinformationen i spårningsfönstret och informationsfönstret.
Expandera eller komprimera aktivitetsöverföringar
Du kan expandera aktivitetsöverföringar när aktiviteten i markeringen överförs till en annan aktivitet. Det gör att du kan följa överföringarna.
Om du vill expandera eller dölja aktivitetsöverföringar
Leta upp överföringsspårningen med ett "+"-tecken till vänster om överföringsikonen.
Klicka på "+" eller tryck på Ctrl och "+" med hjälp av tangentbordet.
Nästa aktivitet visas i diagrammet.
Ett "-" visas till vänster om överföringsikonen. Klicka på tecknet "-" eller tryck på Ctrl och "-", komprimeras aktivitetsöverföringen.
Kommentar
När en aktivitet har flera överföringar till den och du expanderar en av överföringarna visas aktiviteter som leder fram till den nya aktiviteten från rotaktiviteten. Dessa nya aktiviteter visas i komprimerad form. Om du vill se information om dessa aktiviteter expanderar du dem lodrätt genom att klicka på expanderingsikonen i diagrammets rubrik.
Expandera eller komprimera aktiviteter lodrätt
Visningsprogrammet döljer onödig information i aktivitetsdiagrammet genom att komprimera aktiviteter. I en komprimerad aktivitet visas inte enskilda spårningar. Endast överföringsspårning visas. Om du vill visa alla spårningar i en aktivitet expanderar du aktiviteten lodrätt genom att klicka på aktivitetssymbolen i diagrammets rubrik.
Om du vill expandera eller komprimera aktiviteter lodrätt,
Klicka på ikonen "+" i aktivitetshuvudet för att expandera aktiviteten lodrätt.
Observera att alla spårningar visas i diagrammet.
Klicka på ikonen "-" i aktivitetshuvudet för att minimera aktiviteten lodrätt.
Observera att endast viktiga överföringar, meddelandeloggar, varnings- och undantagsspårningar visas i aktiviteten.
Alternativ
Du kan välja två alternativ på menyn Alternativ i diagramvyn.
Visa aktivitetsgränsspårningar, som när de avmarkeras ignorerar aktivitetsgränsspårningarna i diagrammet.
Visa utförliga spårningar utan meddelande, som när de avmarkeras ignorerar utförliga nivåspårningar, förutom meddelandespårningar. I de flesta fall är utförliga nivåspårningar mindre viktiga för analys. Det här alternativet är användbart när du inte vill analysera utförliga nivåspårningar och bara vill fokusera på viktigare spårningar.
Layoutläge
Visningsprogrammet har två layoutlägen: Process och Tråd. Den här inställningen definierar den största organisationsenheten. Standardlayoutläget är Process, vilket innebär att aktiviteter grupperas efter processer i diagrammet.
Körningslista
Du kan välja vilken process eller tråd som ska visas i diagrammet i den här listrutan. Om du till exempel har öppnat spårningsfilerna för två klienter (A och B) och en tjänst, och du bara vill visa tjänsten och klient A i diagrammet, kan du avmarkera klient B från listan.
Visa spårningsinformation
Om du vill visa en spårningsinformation väljer du en spårning i fönstret Spårning. Informationen visas i fönstret Information.
Spårningsfönster
Det övre högra fönstret i visningsprogrammet för tjänstspårning är spårningsfönstret. Den visar alla spårningar i den valda aktiviteten med extra information, till exempel spårningsnivå, tråd-ID och processnamn.
Du kan kopiera xml-koden för spårningen till Urklipp genom att högerklicka på en spårning och välja Kopiera spårning till Urklipp.
Informationsfönster
Det nedre vänstra fönstret i visningsprogrammet för tjänstspårning är informationsfönstret. Den innehåller tre flikar för att visa spårningsinformation.
Den formaterade vyn visar informationen på ett mer ordnat sätt. Den visar alla kända XML-element i tabeller och träd, vilket gör det lättare att läsa och förstå informationen.
XML-vyn visar XML som motsvarar den valda spårningen. Den stöder markering och syntaxfärg. När du använder Sök för att söka efter strängar markeras sökresultaten.
Meddelandevyn visar meddelandedelen av XML i spårningar av meddelandeloggar. Den är osynlig när du väljer en spårning som inte är meddelande.
Filtrera WCF-spårningar
För att göra analysen av spårning enklare kan du filtrera dem på följande sätt:
Filterverktygsfältet ger åtkomst till fördefinierade och anpassade filter. Den kan aktiveras via menyn Visa .
Det fördefinierade filtret för visningsprogrammet kan användas för att selektivt filtrera delar av WCF-spårningarna. Som standard är den inställd på att tillåta att alla infrastrukturspårningar passerar. Inställningarna för det här filtret definieras på undermenyn Filteralternativ under Visa-menyn .
Anpassade XPath-filter ger användarna fullständig kontroll över filtreringen. De kan definieras i det anpassade filtret på menyn Visa .
Endast spårningar som passerar genom alla filter visas.
Använda verktygsfältet Filter
Filterverktygsfältet visas överst i verktyget. Om den inte finns kan du aktivera den på menyn Visa . Fältet har tre komponenter:
Leta efter: Leta efter definierar ämnet som ska sökas efter i filteråtgärden. Om du till exempel vill hitta alla spårningar som har genererats i kontexten för process X anger du fältet till X och fältet Sök i till "Processnamn". Det här fältet ändras till en DateTime-väljare när ett tidsbaserat filter väljs.
Sök i: Det här fältet definierar vilken typ av filter som ska tillämpas.
Nivå: Nivåinställningen definierar den minsta spårningsnivå som tillåts av filtret. Om nivån till exempel är inställd på Fel och Upp visas endast spårningar på fel- och kritisk nivå. Det här filtret kombineras med de villkor som anges av Sök efter och Sök i.
Knappen Filtrera nu startar filteråtgärden. Vissa filter, särskilt när de tillämpas på en stor datamängd, tar lång tid att slutföra. Du kan avbryta filteråtgärden genom att trycka på knappen Stoppa som visas i statusfältet under åtgärdsmenyn .
Knappen Rensa återställer fördefinierade och anpassade filter så att alla spårningar kan passera.
Filteralternativ
Visningsprogrammet kan automatiskt ta bort WCF-spårningar från vyn. Den kan selektivt ta bort spårningar som genereras av specifika områden i WCF, till exempel genom att ta bort transaktionsrelaterade spårningar från vyn.
Inställningarna för det här filtret definieras på undermenyn Filteralternativ under Visa-menyn .
Anpassade filter
Om du är bekant med XML Path Language (XPath) kan du använda det för att konstruera anpassade filter för att söka i spårningsdata efter xml-element av intresse. Filtren är tillgängliga via filterverktygsfältet.
Anpassade filter kan innehålla parametrar. Du kan också importera befintliga anpassade filter.
Skapa ett anpassat filter
Filter kan skapas på två sätt:
Skapa ett anpassat filter med hjälp av mallguiden
Du kan klicka på en befintlig spårning och skapa ett filter baserat på spårningens struktur. Det här exemplet skapar ett anpassat filter baserat på tråd-ID.
I spårningsfönstret i det övre högra området i visningsprogrammet väljer du en spårning som innehåller det element som du vill filtrera efter.
Klicka på knappen Skapa anpassat filter längst upp i spårningsfönstret.
I dialogrutan som visas anger du ett namn för filtret. I det här exemplet anger du
Thread ID. Du kan också ange en beskrivning av filtret.Trädvyn till vänster visar strukturen för den spårningspost som du valde i steg 1. Bläddra till det element som du vill skapa ett villkor för. I det här exemplet bläddrar du till ThreadID som ska finnas i noden XPath: /E2ETraceEvent/System/Execution/@ThreadID. Dubbelklicka på attributet ThreadID i trädvyn. Detta skapar ett uttryck för attributet till höger om dialogrutan.
Ändra parameterfältet för ThreadID-villkoret från Ingen till "{0}". Det här steget gör att ThreadID-värdet kan konfigureras när filtret tillämpas. (Se avsnittet Så här använder du ett filter) Du kan definiera upp till fyra parametrar. Villkor kombineras med operatorn OR.
Klicka på Ok för att skapa filtret.
Kommentar
När ett filter har skapats med hjälp av mallguiden kan det bara redigeras manuellt. Det går inte att aktivera guiden för ett filter som har skapats tidigare. Dessutom kombineras villkoren för ett XPath-filter som skapats i mallguiden med operatorn OR. Om du behöver en AND-åtgärd kan du redigera filteruttrycket när det har skapats.
Skapa ett anpassat filter manuellt
På menyn Anpassade filter kan du ange XPath-filter manuellt.
I menyn Visa klickar du på menyalternativet Anpassade filter .
I dialogrutan som visas klickar du på Ny.
Ange minst ett filternamn och ett XPath-uttryck.
Klicka på OK.
Använda ett anpassat filter
När ett anpassat filter har skapats är det tillgängligt via filterverktygsfältet. Välj det filter som du vill använda i fältet Sök i i filterverktygsfältet. I föregående exempel väljer du "Tråd-ID".
Ange det värde som du letar efter i fältet Hitta vad . I vårt exempel anger du ID för den tråd som du vill söka efter.
Klicka på Filtrera nu och observera resultatet av åtgärden.
Om filtret använder flera parametrar anger du dem med hjälp av ";" som avgränsare i fältet Hitta vad . Följande sträng definierar till exempel 3 parametrar: '1; findValue; text'. Visningsprogrammet tillämpar "1" på parametern {0} för filtret. "findValue" och "text" tillämpas {1} på respektive {2} .
Dela anpassade filter
Anpassade filter kan delas mellan olika sessioner och olika användare. Du kan exportera filtren till en definitionsfil och importera den här filen på en annan plats.
Så här importerar du ett anpassat filter:
I menyn Visa klickar du på Anpassade filter.
I dialogrutan som öppnas klickar du på knappen Importera .
Gå till den anpassade filterfilen (.stvcf), klicka på filen och klicka på knappen Öppna .
Så här exporterar du ett anpassat filter:
I menyn Visa klickar du på Anpassade filter.
I dialogrutan som öppnas väljer du det filter som du vill exportera.
Klicka på knappen Exportera .
Ange namnet och platsen för den anpassade filterdefinitionsfilen (.stvcf) och klicka på knappen Spara .
Kommentar
Dessa anpassade filter kan bara importeras och exporteras från Service Trace Viewer. De kan inte läsas av andra verktyg.
Hitta data
Visningsprogrammet innehåller följande sätt att hitta data:
Verktygsfältet Sök ger snabb åtkomst till de vanligaste sökalternativen.
Dialogrutan Sök innehåller fler sökalternativ. Den är tillgänglig via menyn Redigera eller med kort tangenten Ctrl + F.
Verktygsfältet sök visas överst i visningsprogrammet. Om den inte finns kan du aktivera den på menyn Visa . Fältet har två komponenter:
Hitta vad: Gör att du kan ange nyckelord för sökning.
Titta i: Gör att du kan ange sökomfånget. Du kan välja om du vill söka i alla aktiviteter eller endast i den aktuella aktiviteten.
Dialogrutan Sök innehåller ytterligare två alternativ:
Sök efter mål:
Alternativet "Rådata" söker efter nyckelordet i alla rådata.
Alternativen "XML-text" och "XML-attribut" söker bara i XML-element.
Alternativet "Loggat meddelande" söker bara efter nyckelordet i meddelanden.
Ignorera rotaktivitet: Sökningen ignorerar spårningarna i aktiviteten "0000000000000". Detta förbättrar prestanda i stora spårningsfiler när rotaktiviteten har tusentals spårningar, varav de flesta är överföringar.
Navigera i spårningar
Eftersom spårningar registreras steg för steg under programkörningen kan det hjälpa dig att felsöka ditt program genom att navigera i spårningar. Service Trace Viewer innehåller olika sätt att navigera i spårningar.
Steg framåt eller bakåt
Om du betraktar varje spårning som en kodrad i programmet liknar steg framåt "Step over" i Visual Studio Integrated Development Environment (IDE). Skillnaden är att du också kan gå bakåt i spårningarna. Steg framåt innebär att gå vidare till nästa spårning i aktiviteten.
Steg framåt: Använd aktivitetsmenyn eller tryck på "F10". Du kan också använda piltangenten "nedåt" i spårningsfönstret.
Steg bakåt: Använd aktivitetsmenyn eller tryck på "F9". Du kan också använda piltangenten "up" i spårningsfönstret.
Kommentar
Detta kan ta dig till en aktivitet som inträffar i en annan process eller till och med på en annan dator, eftersom WCF-meddelanden kan innehålla aktivitets-ID:n som sträcker sig över datorer.
Följ överföring
Överföringsspårningar är särskilda spårningar i spårningsfilen. En aktivitet kan överföras till en annan aktivitet med en överföringsspårning. Till exempel kan "Aktivitet A" överföras till "Aktivitet B". I sådana fall finns det en överföringsspårning i "Aktivitet A" med namnet "Till: Aktivitet" och överföringsikonen. Den här överföringsspårningen är en länk mellan de två spårningarna. I "Aktivitet B" kan det också finnas en överföringsspårning i slutet av aktiviteten för att överföra tillbaka till "Aktivitet A". Detta liknar funktionsanrop i program: A anropar B och sedan returnerar B.
"Följ överföring" liknar "Step into" i ett felsökningsprogram. Den följer överföringen från A till B. Det har ingen effekt på andra spårningar.
Det finns två sätt att följa en överföring: med mus eller tangentbord:
Efter mus: Dubbelklicka på överföringsspårningen i spårningsfönstret.
Efter tangentbord: Välj en överföringsspårning och använd "Följ överföring" på aktivitetsmenyn eller tryck på "F11"
Kommentar
I många fall, när Aktivitet A överförs till aktivitet B, väntar aktivitet A tills aktivitet B överförs tillbaka till aktivitet A. Det innebär att aktivitet A inte har någon spårning loggad under den period då aktivitet B aktivt spårar. Det är dock också möjligt att aktivitet A inte väntar och fortsätter att logga spårningar. Det är också möjligt att aktivitet B inte överförs tillbaka till aktivitet A. Därför skiljer sig aktivitetsöverföringar fortfarande från funktionsanrop i den här meningen. Du kan förstå aktivitetsöverföringar bättre i Graph-vyn.
Gå till Nästa eller Föregående överföring
När du analyserar den aktuella aktiviteten eller valda aktiviteter när flera aktiviteter har valts kan det vara bra att snabbt hitta de aktiviteter som den överför till. Med "Hoppa till nästa överföring" kan du hitta nästa överföringsspårning i aktiviteten. När du hittar överföringsspårningen kan du använda "Följ överföring" för att gå in i nästa aktivitet.
Hoppa till Nästa överföring: Använd aktivitetsmenyn eller tryck på "Ctrl + F10".
Hoppa till Föregående överföring: Använd aktivitetsmenyn eller tryck på "Ctrl + F9".
Navigera i diagramvyn
Även om navigering i aktivitetsfönstret och spårningsfönstret liknar felsökning, ger graph-vyn en mycket bättre upplevelse i navigeringen. Mer information finns i avsnittet "Graph View".
Läser in stora spårningsfiler
Spårningsfiler kan vara mycket stora. Om du till exempel aktiverar spårning på nivån "Utförlig" kan den resulterande spårningsfilen för att köra några minuter enkelt vara hundratals megabyte eller ännu större, beroende på nätverkets hastighet och kommunikationsmönster.
När du öppnar en mycket stor spårningsfil i Service Trace Viewer kan systemets prestanda påverkas negativt. Inläsningshastigheten och svarstiden efter inläsningen kan vara långsam. Den faktiska hastigheten skiljer sig från tid till annan, beroende på maskinvarukonfigurationen. I de flesta datorer har inläsning av en spårningsfil som är större än 200 M en allvarlig prestandapåverkan. För spårningsfiler som är större än 1 G kan verktyget använda upp allt tillgängligt minne eller sluta svara under mycket lång tid.
För att undvika långsam inläsning och svarstid vid analys av stora spårningsfiler tillhandahåller Tjänstspårningsläsaren en funktion som kallas "Partiell inläsning", som bara läser in en liten del av spårningen i taget. Du kan till exempel ha en spårningsfil över 1 GB som körs i flera dagar på servern. När vissa fel har inträffat och du vill analysera spårningen är det inte nödvändigt att öppna hela spårningsfilen. I stället kan du läsa in spårningarna inom en viss tidsperiod när felet kan ha inträffat. Eftersom omfånget är mindre kan verktyget Service Trace Viewer läsa in filen snabbare och du kan identifiera felen med hjälp av en mindre uppsättning data.
Aktivera partiell inläsning
Du behöver inte aktivera partiell inläsning manuellt. Om den totala storleken på spårningsfilerna som du försöker läsa in överskrider 40 MB, visar Service Trace Viewer automatiskt en dialogruta för partiell inläsning där du kan välja den del som du vill läsa in.
Kommentar
Eftersom spårningar kanske inte fördelas jämnt under tidsperioden kanske längden på den tidsperiod som du anger i verktygsfältet Partiell inläsning inte är proportionell mot den inläsningsstorlek som visas. Den faktiska inläsningsstorleken kan vara mindre än den uppskattade storleken i dialogrutan för partiell inläsning.
Justera partiell inläsning
När du delvis har läst in spårningsfilen kanske du vill ändra datauppsättningen som läses in. Du kan göra det genom att justera verktygsfältet Partiell inläsning överst i visningsprogrammet.
Flytta verktygsfältet med musen eller ange start- och sluttiden.
Klicka på knappen Justera .
Förstå spårningsikoner
Följande är en lista över ikoner som verktyget Tjänstspårningsvisning använder i aktivitetsvyn , diagramvyn och spårningsfönstret för att representera olika objekt.
Kommentar
Vissa spårningar som inte är kategoriserade (till exempel "ett meddelande är stängt") har ingen ikon.
Spårningsspårning av aktiviteter
| Icon | beskrivning |
|---|---|
 |
Varningsspårning: En spårning som genereras på varningsnivån |
 |
Felspårning: En spårning som genereras på felnivå. |
 |
Aktivitetsstartspårning: En spårning som markerar början på en aktivitet. Den innehåller namnet på aktiviteten. Som programdesigner eller utvecklare bör du definiera en aktivitet Starta spårning per aktivitets-ID per process eller tråd. Om aktivitets-ID:t sprids över spårningskällor för spårningskorrelation kan du sedan se flera Starter för samma aktivitets-ID (ett per spårningskälla). Startspårningen genereras om ActivityTracing är aktiverat för spårningskällan. |
 |
Spårning av aktivitetsstopp: En spårning som markerar slutet på en aktivitet. . Den innehåller namnet på aktiviteten. Som programdesigner eller utvecklare bör du definiera en aktivitet Stoppa spårning per aktivitets-ID per spårningskälla. Inga spårningar från en viss spårningskälla visas efter aktiviteten Stopp som genereras av spårningskällan, förutom om spårningstidens kornighet inte är tillräckligt liten. När det händer kan två spårningar med samma tid, inklusive ett Stopp, interfolieras när de visas. Om aktivitets-ID:t sprids över spårningskällor för spårningskorrelation kan du se flera stopp för samma aktivitets-ID (ett per spårningskälla). Stoppspårningen genereras om ActivityTracing är aktiverat för spårningskällan. |
 |
Aktivitetsupphängningsspårning: En spårning som markerar den tid då en aktivitet pausas. Inga spårningar genereras i en pausad aktivitet förrän aktiviteten återupptas. En pausad aktivitet anger att ingen bearbetning sker i den aktiviteten i spårningskällans omfång. Pausa/återuppta spårningar är användbara för profilering. Pausspårningen genereras om ActivityTracing är aktiverat för spårningskällan. |
 |
Spårning av aktivitets-CV: En spårning som markerar den tid då en aktivitet återupptas efter att den har pausats. Spårningar kan genereras igen i den aktiviteten. Pausa/återuppta spårningar är användbara för profilering. Meritförteckningsspårningen genereras om ActivityTracing är aktiverat för spårningskällan. |
 |
Överföring: En spårning som genereras när det logiska kontrollflödet överförs från en aktivitet till en annan. Aktiviteten som överföringen kommer från kan fortsätta att utföra arbete parallellt med den aktivitet som överföringen går till. Överföringsspårningen genereras om ActivityTracing är aktiverat för spårningskällan. |
 |
Överför från: En spårning som definierar en överföring från en annan aktivitet till den aktuella aktiviteten. |
 |
Överför till: En spårning som definierar en överföring av det logiska kontrollflödet från den aktuella aktiviteten till en annan aktivitet. |
WCF-spårningar
| Icon | beskrivning |
|---|---|
 |
Spårning av meddelandelogg: En spårning som genereras när ett WCF-meddelande loggas av funktionen för meddelandeloggning när spårningskällan System.ServiceModel.MessageLogging är aktiverad. När du klickar på den här spårningen visas meddelandet. Det finns fyra konfigurerbara loggningspunkter för ett meddelande: ServiceLevelSendRequest, TransportSend, TransportReceive och ServiceLevelReceiveRequest, som också kan anges av attributet i spårningen messageSource av meddelandeloggen. |
 |
Meddelande mottagen spårning: En spårning som genereras när ett WCF-meddelande tas emot, om spårningskällan System.ServiceModel är aktiverad på informations- eller utförlig nivå. Den här spårningen är viktig för att visa meddelandekorrelationspilen i vyn Aktivitetsdiagram. |
 |
Meddelande skickad spårning: En spårning som genereras när ett WCF-meddelande skickas om spårningskällan System.ServiceModel är aktiverad på informations- eller utförlig nivå. Den här spårningen är viktig för att visa meddelandekorrelationspilen i vyn Aktivitetsdiagram. |
Aktiviteter
| Icon | beskrivning |
|---|---|
 |
Aktivitet: Anger att den aktuella aktiviteten är en allmän aktivitet. |
 |
Rotaktivitet: Anger rotaktiviteten i en process. |
WCF-aktiviteter
| Icon | beskrivning |
|---|---|
 |
Miljöaktivitet: En aktivitet som skapar, öppnar eller stänger en WCF-värd eller -klient. Fel som har inträffat under dessa faser visas i den här aktiviteten. |
 |
Lyssningsaktivitet: En aktivitet som loggar spårningar relaterade till en lyssnare. I den här aktiviteten kan vi visa lyssnarinformation och anslutningsbegäranden. |
 |
Ta emot byteaktivitet: En aktivitet som grupperar alla spårningar relaterade till att ta emot inkommande byte på en anslutning mellan två slutpunkter. Denna verksamhet är nödvändig för att korrelera med transportaktiviteter som sprider deras aktivitets-ID, till exempel http.sys. Anslut ionsfel, till exempel avbrutna, visas i den här aktiviteten. |
 |
Processmeddelandeaktivitet: En aktivitet som grupperar spårningar relaterade till att skapa ett WCF-meddelande. Fel på grund av ett felaktigt kuvert eller ett felaktigt meddelande visas i den aktiviteten. I den här aktiviteten kan vi granska meddelandehuvuden för att se om ett aktivitets-ID har spridits från anroparen. Om detta är sant, när vi överför till processåtgärdsaktiviteten (nästa ikon), kan vi även tilldela aktiviteten det spridda aktivitets-ID:t för korrelation mellan anroparens och anroparens spårningar. |
|
Processåtgärdsaktivitet: En aktivitet som grupperar alla spårningar relaterade till en WCF-begäran över två slutpunkter. Om propagateActivity anges till true på båda slutpunkterna i konfigurationen sammanfogas alla spårningar från båda slutpunkterna till en aktivitet för direkt korrelation. Sådan aktivitet kommer att innehålla fel på grund av transport- eller säkerhetsbearbetning, som sträcker sig till användarkodgränsen och tillbaka (om det finns ett svar). |
|
Kör användarkodsaktivitet: En aktivitet som grupperar användarkodspårningar för bearbetning av en begäran. |
Felsökning
Om du inte har behörighet att skriva till registret får du följande felmeddelande "Microsoft Service Trace Viewer har inte registrerats i systemet" när du använder kommandot "svctraceviewer /register" för att registrera verktyget. Om detta inträffar bör du logga in med ett konto som har skrivåtkomst till registret.
Dessutom skriver verktyget Service Trace Viewer vissa inställningar (till exempel anpassade filter och filteralternativ) till filen SvcTraceViewer.exe.settings i sammansättningsmappen. Om du inte har läsbehörighet för filen kan du fortfarande starta verktyget, men du kan inte läsa in inställningarna.
Om du får felmeddelandet "Ett okänt fel inträffade vid bearbetning av en eller flera spårningar" när du öppnade .etl-filen innebär det att formatet för .etl-filen är ogiltigt.
Om du öppnar en spårningslogg som skapats med ett arabiskt operativsystem kanske du märker att tidsfiltret inte fungerar. År 2005 motsvarar till exempel år 1427 i arabisk kalender. Det tidsintervall som stöds av filtret För tjänstspårningsvisning stöder dock inte ett tidigare datum än 1752. Detta kan innebära att du inte kan välja rätt datum i filtret. För att lösa det här problemet kan du skapa ett anpassat filter (Visa/anpassade filter) med ett XPath-uttryck för att inkludera ett visst tidsintervall.