Prohlížeč trasování služeb (SvcTraceViewer.exe)
Nástroj Windows Communication Foundation (WCF) Service Trace Viewer pomáhá analyzovat diagnostické trasování generované WCF. Prohlížeč trasování služeb poskytuje způsob, jak snadno sloučit, zobrazit a filtrovat zprávy trasování v protokolu, abyste mohli diagnostikovat, opravit a ověřit problémy se službou WCF.
Konfigurace trasování
Diagnostické trasování poskytuje informace, které ukazují, co se děje v rámci operace vaší aplikace. Jak už název napovídá, můžete sledovat operace z jejich zdroje do cíle i přes přechodné body.
Trasování můžete nakonfigurovat pomocí konfiguračního souboru aplikace – web.config pro aplikace hostované na webu nebo Appname.config pro aplikace v místním prostředí. Následuje příklad:
<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>
V tomto příkladu je zadán název a typ naslouchacího procesu trasování. Naslouchací proces má název sdt a jako typ se přidá standardní naslouchací proces trasování rozhraní .NET Framework (System.Diagnostics.XmlWriterTraceListener). Atribut initializeData slouží k nastavení názvu souboru protokolu pro tento naslouchací proces být SdrConfigExample.e2e. Pro soubor protokolu můžete nahradit plně kvalifikovanou cestu pro jednoduchý název souboru.
Příklad vytvoří soubor v kořenovém adresáři s názvem SdrConfigExample.e2e. Když použijete Prohlížeč trasování k otevření souboru, jak je popsáno v části Otevírání a prohlížení trasovacích souborů WCF, můžete zobrazit všechny odeslané zprávy.
Úroveň trasování se řídí switchValue nastavením. Dostupné úrovně trasování jsou popsány v následující tabulce.
| Úroveň trasování | Popis |
|---|---|
| Kritické | – Protokoly neúspěšných a rychlých položek protokolu událostí a trasování informací o korelaci. Tady je několik příkladů, kdy můžete použít kritickou úroveň: - Vaše doména AppDomain se zpomalila kvůli neošetřené výjimce. – Aplikace se nespustí. – Zpráva, která způsobila selhání, pochází z procesu MyApp.exe. |
| Chyba | – Zaznamená všechny výjimky. Úroveň Chyba můžete použít v následujících situacích: – Kód se chybově ukončil kvůli neplatné výjimce přetypování. – Výjimka , že se nepodařilo vytvořit koncový bod, způsobuje selhání vaší aplikace při spuštění. |
| Upozorňující | - Existuje podmínka, která může následně vést k chybě nebo kritickému selhání. Tuto úroveň můžete použít v následujících situacích: – Aplikace přijímá více požadavků, než umožňuje nastavení omezování. – Přijímající fronta má 98 % nakonfigurované kapacity. |
| Informační | - Zprávy užitečné pro monitorování a diagnostiku stavu systému, měření výkonu nebo profilace jsou generovány. Tyto informace můžete využít k plánování kapacity a správě výkonu. Tuto úroveň můžete použít v následujících situacích: – Po dosažení domény AppDomain došlo k chybě a byla deserializována. – Při vytváření vazby HTTP došlo k chybě. |
| Podrobnosti | – Trasování na úrovni ladění pro uživatelský kód i údržbu. Nastavte tuto úroveň v těchto případech: - Nejste si jistí, která metoda v kódu byla volána, když došlo k chybě. – Máte nakonfigurovaný nesprávný koncový bod a služba se nepodařilo spustit, protože položka v úložišti rezervací je uzamčená. |
| ActivityTracing | Události toku mezi aktivitami zpracování a komponentami. Tato úroveň umožňuje správcům a vývojářům korelovat aplikace ve stejné doméně aplikace. - Trasování pro hranice aktivit: spuštění/zastavení. - Trasování pro přenosy. |
Můžete použít add Chcete-li určit název a typ naslouchací proces trasování, kterou chcete použít. V příkladu konfigurace je naslouchací proces pojmenován sdt a standardní naslouchací proces trasování rozhraní .NET Framework (System.Diagnostics.XmlWriterTraceListener) se přidá jako typ. Slouží initializeData k nastavení názvu souboru protokolu pro tento naslouchací proces. Kromě toho můžete nahradit plně kvalifikovanou cestu jednoduchým názvem souboru.
Počínaje rozhraním .NET Framework 4.8 se ovládací prvky ComboBox v některých motivech s vysokým kontrastem zobrazují ve správné barvě. Tuto změnu můžete zakázat odebráním následujícího nastavení ze souboru svcTraceViewer.exe.config :
<AppContextSwitchOverrides value="Switch.UseLegacyAccessibilityFeatures=false;Switch.UseLegacyAccessibilityFeatures.2=false" />
Použití nástroje Service Trace Viewer
Otevírání a zobrazení trasovacích souborů WCF
Prohlížeč trasování služby podporuje tři typy souborů:
Trasovací soubor WCF (.svcLog)
Soubor trasování událostí (.etl)
Crimson Tracing File
Prohlížeč trasování služeb umožňuje otevřít libovolný podporovaný trasovací soubor, přidat a integrovat další trasovací soubory nebo současně otevřít a sloučit skupinu trasovacích souborů.
Otevření trasovacího souboru
- Spusťte Prohlížeč trasování služby pomocí příkazového okna pro přechod do umístění instalace WCF (C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin) a zadejte
SvcTraceViewer.exe.
Poznámka:
Nástroj Prohlížeč trasování služby může přidružit dva typy souborů: .svclog a .stvproj. K registraci a zrušení registrace přípon souborů můžete v příkazovém řádku použít dva parametry.
/register: zaregistrujte přidružení přípon souborů ".svclog" a ".stvproj" s SvcTraceViewer.exe
/unregister: zrušení registrace přidružení přípon souborů ".svclog" a ".stvproj" s SvcTraceViewer.exe
Po spuštění prohlížeče trasování služby klepněte na tlačítko Soubor a přejděte na příkaz Otevřít. Přejděte do umístění, kam se ukládají trasovací soubory.
Poklikejte na trasovací soubor, který chcete otevřít.
Poznámka:
Stiskněte klávesu SHIFT a kliknutím na více trasovacích souborů je vyberte a otevřete současně. Prohlížeč trasování služby sloučí obsah všech souborů a zobrazí jedno zobrazení. Můžete například otevřít trasovací soubory klienta i služby. To je užitečné, když jste povolili protokolování zpráv a šíření aktivit v konfiguraci. Tímto způsobem můžete prozkoumat výměnu zpráv mezi klientem a službou. Do prohlížeče můžete také přetáhnout více souborů nebo použít kartu Projekt . Další podrobnosti najdete v části Správa projektu.
Chcete-li přidat další trasovací soubory do otevřené kolekce, klepněte na tlačítko Soubor a přejděte na příkaz Přidat. V okně, které se otevře, přejděte do umístění trasovacích souborů a poklikejte na soubor, který chcete přidat.
Upozornění
Nedoporučuje se načíst soubor protokolu trasování větší než 200 MB. Pokud se pokusíte načíst soubor větší než tento limit, může proces načítání trvat dlouhou dobu v závislosti na vašem prostředku počítače. Nástroj Service Trace Viewer nemusí dlouho reagovat nebo může vyčerpat paměť vašeho počítače. Doporučujeme nakonfigurovat částečné načítání, abyste se tomu vyhnuli. Další informace o tom, jak to provést, najdete v části Načítání velkých trasovacích souborů.
Trasování událostí a crimson tracing
Nativní formát prohlížeče je formát trasování aktivit, který WCF generuje. Trasování generované v jiném formátu je nutné před zobrazením prohlížeče převést. Prohlížeč kromě formátu trasování aktivit v současné době podporuje trasování událostí a karmsonové trasování.
Když otevřete soubor, který neobsahuje trasování aktivit, prohlížeč se pokusí soubor převést. Je nutné zadat název a umístění souboru, který bude obsahovat převedená data trasování. Po převodu dat prohlížeč zobrazí obsah nového souboru.
Poznámka:
Převod vyžaduje místo na disku k uložení převedených dat trasování. Před zahájením převodu se ujistěte, že máte k dispozici dostatek místa na disku pro uložení dat. V opačném případě převod selže.
Správa projektů
Prohlížeč podporuje projekty, které usnadňují prohlížení více trasovacích souborů. Pokud máte například trasovací soubor klienta a soubor trasování služby, můžete je přidat do projektu. Při každém otevření projektu se pak všechny trasovací soubory v projektu načtou současně.
Projekty můžete spravovat dvěma způsoby:
V nabídce Soubor můžete otevřít, uložit a zavřít projekty.
Na kartě Projekt můžete do projektu přidat soubory.
Zobrazení trasování WCF
WCF generuje trasování pomocí formátu trasování aktivit. V modelu trasování aktivit se jednotlivé trasování seskupují do aktivit podle jejich účelu. Logický tok řízení se přenáší mezi aktivitami. Například během životnosti aplikace se zobrazí mnoho aktivit odesílání zpráv a zmizí. Další informace o zobrazení trasování a aktivit a uživatelském rozhraní prohlížeče trasování služeb najdete v tématu Použití prohlížeče trasování služby pro zobrazení korelovaných trasování a řešení potíží.
Přepnutí na různá zobrazení
Prohlížeč trasování služby poskytuje následující různá zobrazení. Zobrazují se jako karty v levém podokně prohlížeče a dají se také zobrazit z nabídky Zobrazení .
Zobrazení aktivity
Zobrazení projektu
Zobrazení zpráv
Zobrazení grafu
Zobrazení aktivity
Po otevření trasovacích souborů můžete zobrazit trasování seskupené do aktivit a zobrazit je v zobrazení Aktivita v levém podokně.
Zobrazení aktivity zobrazuje názvy aktivit, počet trasování v aktivitě, dobu trvání, počáteční a koncový čas.
Kliknutím na některou z uvedených aktivit se trasování v této aktivitě zobrazí v podokně trasování vpravo. Pak můžete vybrat trasování a zobrazit jeho podrobnosti.
Více aktivit můžete vybrat stisknutím klávesy Ctrl nebo Shift a kliknutím na požadované aktivity. V podokně trasování se zobrazí všechna trasování vybraných aktivit.
Poklikáním na aktivitu ji můžete zobrazit v zobrazení grafu . Alternativním způsobem je vybrat aktivitu a přepnout do zobrazení grafu .
Poznámka:
Aktivita 000000000000 je zvláštní aktivita, kterou nelze zobrazit v zobrazení grafu. Vzhledem k tomu, že jsou s ní spojené všechny ostatní aktivity, má zobrazení této aktivity závažný dopad na výkon.
Seznam aktivit můžete seřadit kliknutím na název sloupce. Aktivity, které obsahují trasování upozornění, mají žluté pozadí a ty, které obsahují trasování chyb, mají červenou.
Existují různé typy aktivit a každý typ odpovídá ikoně na levé straně každé aktivity. Význam najdete v části Principy ikon trasování.
Zobrazení projektu
Toto zobrazení umožňuje spravovat trasovací soubory v aktuálním projektu. Další podrobnosti najdete v části Správa projektu.
Zobrazení zpráv
Toto zobrazení umožňuje zobrazit všechna trasování protokolu zpráv, včetně akcí, data a času, procesu, aktivity a od/do, a přejít na podrobnosti o přidruženém trasování protokolu zpráv. Trasování protokolu zpráv můžete seskupit podle hranic aktivit, procesu nebo vlákna nebo odesílání a přijímání pro snadnější navigaci v toku zpráv.
Zobrazení grafu
Toto zobrazení zobrazí data trasování pro danou aktivitu ve formuláři grafu. Formulář grafu umožňuje zobrazit krokové provádění událostí a vzájemné vztahy mezi několika aktivitami při přesouvání dat mezi nimi.
Pokud chcete přepnout do zobrazení Graf, vyberte aktivitu v zobrazení Aktivita a klikněte na kartu Aktivita nebo na trasování protokolu zpráv v zobrazení zpráv. Pokud je načteno více trasovacích souborů a aktivita zahrnuje trasování z více než jednoho souboru, zobrazí se v zobrazení grafu všechny relevantní trasování. Poklikáním na aktivity a trasování protokolu zpráv se také zobrazí graf .
V zobrazení Graph představuje každý svislý sloupec aktivitu a každý blok ve sloupci představuje trasování. Aktivity jsou seskupené podle procesu (nebo vlákna). Malé šipky mezi aktivitami představují přenosy. Velké šipky mezi procesy představují výměnu zpráv. Aktivita ve výběru je vždy žlutá.
Výběr trasování v grafu
Klikněte na blok v grafu.
Pomocí kláves nahoru a dolů vyberte jeho sousední trasování.
Prohlédněte si informace o trasování v podokně trasování a podokně podrobností.
Rozbalení nebo sbalení přenosů aktivit
Přenosy aktivit můžete rozšířit, když se aktivita ve výběru přenese na jinou aktivitu. Umožňuje sledovat přenosy.
Chcete-li rozbalit nebo sbalit přenosy aktivit,
Vyhledejte trasování přenosu se znaménkem +na levé straně ikony přenosu.
Klikněte na +nebo stiskněte kombinaci kláves Ctrl a +.
V grafu se zobrazí další aktivita.
Na levé straně ikony přenosu se zobrazí "-". Klikněte na znaménko "-" nebo stiskněte ctrl a "-", přenos aktivity se sbalí.
Poznámka:
Pokud má aktivita více přenosů a vy rozbalíte jeden z přenosů, zobrazí se aktivity, které vedou k nové aktivitě z kořenové aktivity. Tyto nové aktivity se zobrazují ve sbalené podobě. Pokud chcete zobrazit podrobnosti o těchto aktivitách, rozbalte je svisle kliknutím na ikonu rozbalení v záhlaví grafu.
Vertikální rozbalení nebo sbalení aktivit
Prohlížeč skryje nepotřebné podrobnosti v grafu aktivit sbalením aktivit. Ve sbalené aktivitě se nezobrazují jednotlivé trasování. Zobrazí se pouze trasování přenosu. Pokud chcete zobrazit všechna trasování v aktivitě, rozbalte aktivitu svisle kliknutím na symbol rozbalení aktivity v záhlaví grafu.
Chcete-li rozbalit nebo sbalit aktivity svisle,
Kliknutím na ikonu +v záhlaví aktivity rozbalte aktivitu svisle.
Všimněte si, že se v grafu zobrazují všechny trasování.
Kliknutím na ikonu "-" v záhlaví aktivity sbalíte aktivitu svisle.
Všimněte si, že v aktivitě se zobrazují jenom důležité přenosy, protokoly zpráv, upozornění a trasování výjimek.
Možnosti
V zobrazení Grafu můžete vybrat dvě možnosti z nabídky Možnosti .
Zobrazit trasování hranic aktivit, které při zrušení zaškrtnutí ignorují trasování hranic aktivity v grafu.
Zobrazit podrobné trasování bez zprávy, které při zrušení zaškrtnutí ignorují podrobné trasování na úrovni s výjimkou trasování zpráv. Ve většině případů jsou podrobné trasování na úrovni méně důležité pro analýzu. Tato možnost je užitečná, pokud nechcete analyzovat podrobné trasování na úrovni řádků a chcete se zaměřit pouze na důležitější trasování.
Režim rozložení
Prohlížeč má dva režimy rozložení: proces a vlákno. Toto nastavení definuje největší jednotku organizace. Výchozí režim rozložení je Proces, což znamená, že aktivity jsou seskupené podle procesů v grafu.
Seznam spuštění
V tomto rozevíracím seznamu můžete vybrat, který proces nebo vlákno se má v grafu zobrazit. Pokud máte například trasovací soubory dvou klientů (A a B) a jednu službu otevřenou a chcete zobrazit pouze službu a klienta A v grafu, můžete zrušit výběr klienta B ze seznamu.
Zobrazení podrobností trasování
Pokud chcete zobrazit podrobnosti trasování, vyberte trasování v podokně Trasování. Podrobnosti se zobrazí v podokně podrobností.
Podokno trasování
Podokno v pravém horním rohu prohlížeče trasování služby je podokno trasování. Zobrazí seznam všech trasování ve vybrané aktivitě s dalšími informacemi, například úroveň trasování, ID vlákna a název procesu.
Nezpracovaný kód XML trasování můžete zkopírovat do schránky tak, že kliknete pravým tlačítkem myši na trasování a vyberete Kopírovat trasování do schránky.
Podokno podrobností
Dolní levé podokno v Prohlížeči trasování služby je podokno podrobností. Poskytuje tři karty pro zobrazení podrobností trasování.
Formátované zobrazení zobrazuje informace uspořádanějším způsobem. Obsahuje seznam všech známých elementů XML v tabulkách a stromech, což usnadňuje čtení a pochopení informací.
Zobrazení XML zobrazí XML odpovídající vybranému trasování. Podporuje zvýraznění a barvu syntaxe. Když k hledání řetězců použijete funkci Najít , zvýrazní výsledky hledání.
Zobrazení Zpráva zobrazí část zprávy XML v trasování protokolu zpráv. Když vyberete trasování, které není zprávou, je neviditelné.
Filtrování trasování WCF
Pokud chcete usnadnit analýzu trasování, můžete je filtrovat následujícími způsoby:
Panel nástrojů filtru poskytuje přístup k předem definovaným a vlastním filtrům. Můžete ho povolit prostřednictvím nabídky Zobrazení .
Předdefinovaný filtr prohlížeče lze použít k selektivnímu filtrování částí trasování WCF. Ve výchozím nastavení je nastavená tak, aby umožňovala průchod všech trasování infrastruktury. Nastavení tohoto filtru jsou definována v podnabídce Možnosti filtru v nabídce Zobrazení .
Vlastní filtry XPath poskytují uživatelům úplnou kontrolu nad filtrováním. Je možné je definovat v nabídce Vlastní filtr v nabídce Zobrazení .
Zobrazí se pouze trasování, která prochází všemi filtry.
Použití panelu nástrojů filtru
Panel nástrojů filtru se zobrazí v horní části nástroje. Pokud není k dispozici, můžete ho aktivovat v nabídce Zobrazení . Panel má tři komponenty:
Vyhledání: Vyhledá předmět , který se má v operaci filtru hledat. Pokud například chcete najít všechna trasování v kontextu procesu X, nastavte toto pole na X a pole Hledat v poli Název procesu. Toto pole se změní na ovládací prvek selektoru DateTime, když je vybraný filtr založený na čase.
Hledat v: Toto pole definuje typ filtru, který se má použít.
Úroveň: Nastavení úrovně definuje minimální úroveň trasování povolenou filtrem. Pokud je například úroveň nastavena na Hodnotu Chyba a Nahoru, zobrazí se pouze trasování na úrovni Chyba a kritická úroveň. Tento filtr kombinuje kritéria určená vyhledávacím a vyhledávacím polem.
Tlačítko Filtrovat nyní spustí operaci filtru. Některé filtry, zejména pokud se použijí u velké datové sady, trvá dokončení delší dobu. Operaci filtru můžete zrušit stisknutím tlačítka Zastavit , které se zobrazí na stavovém řádku v nabídce Operace .
Tlačítko Vymazat resetuje předdefinované a vlastní filtry, aby bylo možné projít všemi trasováním.
Možnosti filtru
Prohlížeč může automaticky odebrat trasování WCF ze zobrazení. Může selektivně odebrat trasování generované konkrétními oblastmi WCF, například odebrání trasování souvisejících s transakcemi ze zobrazení.
Nastavení tohoto filtru jsou definována v podnabídce Možnosti filtru v nabídce Zobrazení .
Vlastní filtry
Pokud znáte jazyk XPath (XML Path Language), můžete ho použít k vytvoření vlastních filtrů pro vyhledávání trasovacích dat pro libovolný prvek XML, který vás zajímá. Filtry jsou přístupné prostřednictvím panelu nástrojů filtru.
Vlastní filtry můžou obsahovat parametry. Můžete také importovat existující vlastní filtry.
Vytvoření vlastního filtru
Filtry lze vytvořit dvěma způsoby:
Vytvoření vlastního filtru pomocí Průvodce šablonou
Můžete kliknout na existující trasování a vytvořit filtr založený na struktuře trasování. Tento příklad vytvoří vlastní filtr založený na ID vlákna.
V podokně trasování v pravé horní oblasti prohlížeče vyberte trasování, které obsahuje prvek, pro který chcete filtrovat.
Klikněte na tlačítko Vytvořit vlastní filtr umístěné v horní části podokna trasování.
V zobrazeném dialogovém okně zadejte název filtru. V tomto příkladu zadejte
Thread ID. Můžete také zadat popis filtru.Stromové zobrazení vlevo zobrazuje strukturu záznamu trasování, který jste vybrali v kroku 1. Přejděte k prvku, pro který chcete vytvořit podmínku. V tomto příkladu přejděte na THREADID, který se má nacházet v XPathu: /E2ETraceEvent/System/Execution/@ThreadID node. Poklikejte na atribut ThreadID ve stromovém zobrazení. Tím se vytvoří výraz pro atribut napravo od dialogového okna.
Změňte pole parametru pro podmínku ThreadID z none na '{0}'. Tento krok umožňuje, aby se při použití filtru nakonfigurovala hodnota ThreadID. (Viz část Použití filtru) Můžete definovat až čtyři parametry. Podmínky se kombinují pomocí operátoru OR.
Kliknutím na ok vytvořte filtr.
Poznámka:
Po vytvoření filtru pomocí průvodce šablonou je možné ho upravit pouze ručně. Průvodce pro dříve vytvořený filtr není možné aktivovat. Kromě toho se podmínky filtru XPath vytvořeného v průvodci šablonou zkombinují pomocí operátoru OR. Pokud potřebujete operaci AND, můžete po vytvoření upravit výraz filtru.
Ruční vytvoření vlastního filtru
Nabídka Vlastní filtry umožňuje zadat filtry XPath ručně.
V nabídce Zobrazit klikněte na položku nabídky Vlastní filtry .
V zobrazeném dialogovém okně klikněte na Nový.
Minimálně zadejte název filtru a výraz XPath.
Klikněte na OK.
Použití vlastního filtru
Po vytvoření vlastního filtru je přístupný přes panel nástrojů filtru. V poli Hledat na panelu nástrojů filtru vyberte filtr, který chcete použít. V předchozím příkladu vyberte Id vlákna.
Zadejte hodnotu, kterou hledáte, do pole Najít . V našem příkladu zadejte ID vlákna, které chcete vyhledat.
Klikněte na Tlačítko Filtrovat a sledujte výsledek operace.
Pokud filtr používá více parametrů, zadejte je jako oddělovač do pole Najít. Například následující řetězec definuje 3 parametry: '1; Findvalue; text'. Prohlížeč použije pro parametr filtru 1 {0} . "findValue" a "text" se použijí na {1} a {2} v uvedeném pořadí.
Sdílení vlastních filtrů
Vlastní filtry se dají sdílet mezi různými relacemi a různými uživateli. Filtry můžete exportovat do definičního souboru a importovat ho do jiného umístění.
Import vlastního filtru:
V nabídce Zobrazit klikněte na Vlastní filtry.
V dialogovém okně, které se otevře, klikněte na tlačítko Importovat .
Přejděte do souboru vlastního filtru (.stvcf), klikněte na soubor a klikněte na tlačítko Otevřít .
Export vlastního filtru:
V nabídce Zobrazit klikněte na Vlastní filtry.
V dialogovém okně, které se otevře, vyberte filtr, který chcete exportovat.
Klikněte na tlačítko Exportovat .
Zadejte název a umístění vlastního definičního souboru filtru (.stvcf) a klikněte na tlačítko Uložit .
Poznámka:
Tyto vlastní filtry je možné importovat a exportovat pouze z prohlížeče trasování služby. Nelze je číst jinými nástroji.
Hledání dat
Prohlížeč nabízí následující způsoby, jak najít data:
Panel nástrojů Najít poskytuje rychlý přístup k nejběžnějším možnostem hledání.
Dialogové okno Najít poskytuje další možnosti hledání. Je přístupný prostřednictvím nabídky Upravit nebo pomocí krátké klávesy Ctrl+F.
Panel nástrojů Najít se zobrazí v horní části prohlížeče. Pokud není k dispozici, můžete ho aktivovat v nabídce Zobrazení . Panel má dvě komponenty:
Najít co: Umožňuje zadat klíčové slovo hledání.
Oblast hledání: Umožňuje zadat obor vyhledávání. Můžete vybrat, jestli chcete hledat ve všech aktivitách nebo jenom v aktuální aktivitě.
Dialogové okno Najít nabízí dvě další možnosti:
Najít cíl:
Možnost Nezpracovaná data protokolu prohledá klíčové slovo ve všech nezpracovaných datech.
Možnosti "Text XML" a "Atribut XML" prohledávají pouze v elementech XML.
Možnost Protokolovaná zpráva hledá klíčové slovo pouze ve zprávách.
Ignorovat kořenovou aktivitu: Hledání ignoruje trasování v aktivitě "00000000000". To zlepšuje výkon ve velkých trasovacích souborech, když kořenová aktivita obsahuje tisíce trasování, z nichž většina se přenáší.
Navigace v trasování
Vzhledem k tomu, že trasování se zaznamenává krok za krokem během modulu runtime aplikace, může vám procházení trasování pomoci při ladění aplikace. Prohlížeč trasování služby nabízí různé způsoby navigace v trasování.
Krok vpřed nebo dozadu
Pokud každé trasování považujete za řádek kódu v programu, krokování vpřed je velmi podobné kroku v integrovaném vývojovém prostředí (IDE) sady Visual Studio. Rozdíl je v tom, že můžete v trasování také krokovat zpět. Krokování vpřed znamená přechod na další trasování v aktivitě.
Krok vpřed: Použijte nabídku Aktivita nebo stiskněte klávesu F10. V podokně trasování můžete také použít klávesu se šipkou dolů.
Krok zpět: Použijte nabídku Aktivita nebo stiskněte klávesu F9. V podokně trasování můžete také použít klávesu se šipkou nahoru.
Poznámka:
Můžete se tak dostat k aktivitě, ke které dochází v jiném procesu nebo dokonce v jiném počítači, protože zprávy WCF můžou přenášet ID aktivit, které pokrývají počítače.
Sledovat přenos
Trasování přenosu jsou speciální trasování v trasovacím souboru. Aktivita se může přenést na jinou aktivitu trasováním přenosu. Například "Aktivita A" se může přenést do aktivity B. V takovém případě je v aktivitě A trasování přenosu s názvem "Komu: Aktivita" a ikonou přenosu. Toto trasování přenosu je propojením mezi těmito dvěma trasami. V části "Aktivita B" může na konci aktivity existovat také trasování přenosu, které se má přenést zpět do aktivity A. To se podobá volání funkcí v programech: A volá B a pak B vrátí.
"Sledovat přenos" se podobá kroku do ladicího programu. Následuje přenos z A do B. Nemá žádný vliv na jiné trasování.
Přenos můžete sledovat dvěma způsoby: myší nebo pomocí klávesnice:
Podle myši: Poklikejte na trasování přenosu v podokně trasování.
Klávesnice: Vyberte trasování přenosu a v nabídce Aktivita použijte příkaz Sledovat přenos nebo stiskněte klávesu F11.
Poznámka:
V mnoha případech, když aktivita A přenese do aktivity B, aktivita A čeká, dokud aktivita B nepřenese zpět do aktivity A. To znamená, že aktivita A nemá během období aktivního trasování aktivity B žádné trasování. Je však také možné, že aktivita A nečeká a nadále protokoluje trasování. Je také možné, že aktivita B nepřenese zpět do aktivity A. Přenosy aktivit se proto v tomto smyslu stále liší od volání funkcí. Přenosy aktivit můžete lépe pochopit v zobrazení Graphu.
Přejít na další nebo předchozí přenos
Při analýze aktuální aktivity nebo vybraných aktivit při výběru více aktivit můžete chtít rychle najít aktivity, do které se přenese. Možnost Přejít na další přenos umožňuje vyhledat další trasování přenosu v aktivitě. Jakmile najdete trasování přenosu, můžete pomocí příkazu Sledovat přenos přejít k další aktivitě.
Přejít na další přenos: Použijte nabídku Aktivita nebo stiskněte kombinaci kláves Ctrl + F10.
Přejít na předchozí přenos: Použijte nabídku Aktivita nebo stiskněte ctrl + F9.
Navigace v zobrazení grafu
I když navigace v podokně aktivit a podokně trasování je podobná ladění, použití zobrazení Graph nabízí mnohem lepší možnosti navigace. Další informace najdete v části Zobrazení grafu.
Načítání velkých trasovacích souborů
Trasovací soubory můžou být velmi velké. Pokud například zapnete trasování na úrovni Podrobné, výsledný trasovací soubor pro spuštění několika minut může být snadno stovky megabajtů nebo dokonce větší v závislosti na rychlosti a komunikaci sítě.
Když otevřete velmi velký trasovací soubor v Prohlížeči trasování služby, může to mít negativní dopad na výkon systému. Rychlost načítání a doba odezvy po načtení může být pomalá. Skutečná rychlost se od času liší v závislosti na konfiguraci hardwaru. Ve většině počítačů má načtení trasovacího souboru většího než 200M závažný dopad na výkon. U trasovacích souborů větších než 1G může nástroj využívat veškerou dostupnou paměť nebo přestat reagovat po velmi dlouhou dobu.
Aby se zabránilo pomalému načítání a době odezvy při analýze velkých trasovacích souborů, poskytuje Prohlížeč trasování služby funkci s názvem Částečné načítání, která načítá jenom malou část trasování najednou. Můžete mít například trasovací soubor přes 1 GB, který běží na serveru několik dní. Pokud dojde k nějakým chybám a chcete trasování analyzovat, není nutné otevřít celý trasovací soubor. Místo toho můžete trasování načíst během určitého časového období, kdy k chybě mohlo dojít. Vzhledem k tomu, že obor je menší, nástroj Prohlížeč trasování služby může soubor načíst rychleji a pomocí menší sady dat můžete identifikovat chyby.
Povolení částečného načítání
Není nutné ručně povolit částečné načítání. Pokud celková velikost trasovacích souborů, které se pokusíte načíst, překročí 40 MB, prohlížeč trasování služby automaticky zobrazí dialogové okno Částečné načítání, abyste vybrali část, kterou chcete načíst.
Poznámka:
Vzhledem k tomu, že trasování nemusí být rovnoměrně rozložena v časovém rozsahu, nemusí být délka časového období, které zadáte na panelu nástrojů Částečné načítání, úměrná zobrazené velikosti načítání. Skutečná velikost načítání může být menší než odhadovaná velikost v dialogovém okně částečného načítání.
Úprava částečného načítání
Po částečném načtení trasovacího souboru můžete chtít změnit načtenou datovací sadu. Můžete to udělat úpravou panelu nástrojů Částečné načítání v horní části prohlížeče.
Přesuňte panel nástrojů myší nebo zadejte čas zahájení a ukončení.
Klikněte na tlačítko Upravit .
Principy ikon trasování
Následuje seznam ikon, které nástroj Prohlížeč trasování služby používá v zobrazení aktivity , zobrazení grafu a trasování k reprezentaci různých položek.
Poznámka:
Některá trasování, která nejsou zařazena do kategorií (například zpráva je zavřená), nemají žádnou ikonu.
Trasování aktivit
| Ikona | Popis |
|---|---|
 |
Trasování upozornění: Trasování, které se vygeneruje na úrovni upozornění |
 |
Trasování chyby: Trasování, které se vygeneruje na úrovni chyby. |
 |
Trasování zahájení aktivity: Trasování, které označuje začátek aktivity. Obsahuje název aktivity. Jako návrhář aplikací nebo vývojář byste měli definovat jedno trasování spuštění aktivity na ID aktivity na proces nebo vlákno. Pokud se ID aktivity rozšíří mezi zdroje trasování pro korelaci trasování, můžete zobrazit několik spuštění pro stejné ID aktivity (jeden na zdroj trasování). Trasování spuštění se vygeneruje, pokud je pro zdroj trasování povolená funkce ActivityTracing. |
 |
Trasování zastavení aktivity: Trasování, které označuje konec aktivity. . Obsahuje název aktivity. Jako návrhář aplikací nebo vývojář byste měli definovat jednu aktivitu Stop stop na ID aktivity na zdroj trasování. Po zastavení aktivity generované tímto zdrojem trasování se nezobrazují žádné trasování z daného zdroje trasování, s výjimkou případů, kdy doba trasování není dostatečně malá. V takovém případě mohou být při zobrazení prokládání dvě trasování se stejnou dobou, včetně zastavení. Pokud se ID aktivity rozšíří napříč zdroji trasování pro korelaci trasování, můžete zobrazit více zarážek pro stejné ID aktivity (jeden na zdroj trasování). Trasování stop se vygeneruje, pokud je pro zdroj trasování povolená funkce ActivityTracing. |
 |
Sledování pozastavení aktivity: Trasování označující čas pozastavení aktivity. V pozastavené aktivitě se nepropouštějí žádné trasování, dokud se aktivita neobnoví. Pozastavená aktivita označuje, že v této aktivitě v oboru zdroje trasování neprobíhá žádné zpracování. Trasování pozastavení a obnovení je užitečné pro profilaci. Trasování pozastavení se vygeneruje, pokud je pro zdroj trasování povolená funkce ActivityTracing. |
 |
Trasování obnovení aktivity: Trasování označující dobu obnovení aktivity po jejím pozastavení. Trasování může být v této aktivitě znovu generováno. Trasování pozastavení a obnovení je užitečné pro profilaci. Trasování obnovení se vygeneruje, pokud je pro zdroj trasování povolená funkce ActivityTracing. |
 |
Přenos: Trasování, které se vygeneruje při přenosu toku logického řízení z jedné aktivity do jiné. Aktivita, ze které přenos pochází, může pokračovat v provádění práce paralelně s aktivitou, do které přenos přejde. Trasování přenosu se vygeneruje, pokud je pro zdroj trasování povolená funkce ActivityTracing. |
 |
Přenos z: Trasování, které definuje přenos z jiné aktivity do aktuální aktivity. |
 |
Přenést do: Trasování, které definuje přenos logického toku řízení z aktuální aktivity do jiné aktivity. |
Trasování WCF
| Ikona | Popis |
|---|---|
 |
Trasování protokolu zpráv: Trasování, které se vygeneruje, když je zpráva WCF zaznamenána pomocí funkce protokolování zpráv, když System.ServiceModel.MessageLogging je povolen zdroj trasování. Kliknutím na toto trasování se zobrazí zpráva. Pro zprávu existují čtyři konfigurovatelné body protokolování: ServiceLevelSendRequest, TransportSend, TransportReceive a ServiceLevelReceiveRequest, které lze také určit messageSource atributem v trasování protokolu zpráv. |
 |
Trasování přijatou zprávou: Trasování, které se vygeneruje při přijetí zprávy WCF, pokud System.ServiceModel je zdroj trasování povolen na úrovni Informace nebo Podrobné. Toto trasování je nezbytné pro zobrazení šipky korelace zpráv v zobrazení Graf aktivit. |
 |
Trasování odeslané zprávou: Trasování, které se vygeneruje při odeslání zprávy WCF, pokud System.ServiceModel je zdroj trasování povolen na úrovni Informace nebo Podrobné. Toto trasování je nezbytné pro zobrazení šipky korelace zpráv v zobrazení Graf aktivit. |
Aktivity
| Ikona | Popis |
|---|---|
 |
Aktivita: Označuje, že aktuální aktivita je obecná aktivita. |
 |
Kořenová aktivita: Označuje kořenovou aktivitu procesu. |
Aktivity WCF
| Ikona | Popis |
|---|---|
 |
Aktivita prostředí: Aktivita, která vytvoří, otevře nebo zavře hostitele nebo klienta WCF. V této aktivitě se zobrazí chyby, ke kterým došlo během těchto fází. |
 |
Aktivita naslouchání: Aktivita, která protokoluje trasování související s naslouchacím procesem. V této aktivitě můžeme zobrazit informace o naslouchacím procesu a žádosti o připojení. |
 |
Aktivita příjmu bajtů: Aktivita, která seskupuje všechny trasování související s příjmem příchozích bajtů v připojení mezi dvěma koncovými body. Tato aktivita je nezbytná pro korelaci s dopravními aktivitami, které šíří id své aktivity, jako je http.sys. Připojení chyby, jako jsou přerušení, se v této aktivitě zobrazí. |
 |
Aktivita zpracování zprávy: Aktivita, která seskupuje trasování související s vytvořením zprávy WCF. Chyby způsobené chybnou obálkou nebo chybnou zprávou se v dané aktivitě zobrazí. Uvnitř této aktivity můžeme zkontrolovat hlavičky zpráv a zjistit, jestli se ID aktivity rozšířilo z volajícího. Pokud je to pravda, můžeme při přenosu na aktivitu akce procesu (další ikona) přiřadit této aktivitě také ID šířené aktivity pro korelaci mezi volajícím a volanými trasování. |
|
Aktivita akce procesu: Aktivita, která seskupuje všechna trasování související s požadavkem WCF napříč dvěma koncovými body. Pokud propagateActivity je nastavená na true oba koncové body v konfiguraci, všechny trasování z obou koncových bodů se sloučí do jedné aktivity pro přímou korelaci. Taková aktivita bude obsahovat chyby způsobené přenosem nebo zpracováním zabezpečení, které se rozšíří na hranice uživatelského kódu a zpět (pokud existuje odpověď). |
|
Aktivita Spuštění uživatelského kódu: Aktivita, která seskupuje trasování uživatelského kódu pro zpracování požadavku. |
Řešení problému
Pokud nemáte oprávnění k zápisu do registru, zobrazí se následující chybová zpráva Microsoft Service Trace Viewer nebyl zaregistrován do systému při použití příkazu "svctraceviewer /register" k registraci nástroje. Pokud k tomu dojde, měli byste se přihlásit pomocí účtu, který má přístup k zápisu do registru.
Nástroj Prohlížeč trasování služby navíc zapíše některá nastavení (například vlastní filtry a možnosti filtru) do souboru SvcTraceViewer.exe.settings ve složce sestavení. Pokud nemáte oprávnění ke čtení souboru, můžete nástroj přesto spustit, ale nemůžete načíst nastavení.
Pokud se při otevření souboru .etl zobrazí chybová zpráva "Při zpracování jednoho nebo více trasování došlo k neznámé chybě", znamená to, že formát souboru .etl je neplatný.
Pokud otevřete protokol trasování vytvořený pomocí arabského operačního systému, můžete si všimnout, že časový filtr nefunguje. Například rok 2005 odpovídá roku 1427 v arabském kalendáři. Časový rozsah podporovaný filtrem nástroje Prohlížeč trasování služby však nepodporuje datum dřívější než 1752. To může znamenat, že ve filtru nemůžete vybrat správné datum. Chcete-li tento problém vyřešit, můžete vytvořit vlastní filtr (zobrazení nebo vlastní filtry) pomocí výrazu XPath k zahrnutí určitého časového rozsahu.