Vizualizace událostí EventSource v podobě značek
Vizualizátor souběžnosti může zobrazit události EventSource jako značky, přičemž lze řídit, jak jsou značky zobrazeny.Chcete-li zobrazit značky EventSource, zaregistrujte identifikátor GUID poskytovatele ETW použitím dialogového okna Upřesnit nastavení.Vizualizátor souběžnosti obsahuje výchozí konvence pro reprezentaci událostí EventSource jako Značky příznaků, Značky rozpětí a Značky zpráv.Přidáním vlastních polí do událostí EventSource lze přizpůsobit jejich zobrazení.Další informace o značkách naleznete v tématu Značky Vizualizéru souběžnosti.Další informace o událostech EventSource naleznete v tématu System.Diagnostics.Tracing.
Výchozí vizualizace událostí EventSource
Ve výchozím nastavení používá Vizualizátor souběžnosti pro reprezentaci událostí EventSource následující konvence.
Typ značky
Události, které mají Opcode win:Start nebo win:Stop jsou zpracovány jako začátek nebo konec rozpětí. Vnořené nebo překrývající se rozsahy nelze zobrazit.Páry událostí, které začínají v jednom vlákně a končí v jiném, nelze zobrazit.
Událost, jejíž Opcode není win:Start ani win:Stop, je zpracována jako příznak značky, není-li její úroveň (pole EVENT_RECORD.EVENT_HEADER.EVENT_DESCRIPTOR) nastavena na hodnotu win:Verbose nebo vyšší.
Ve všech ostatních případech je událost zpracována jako zpráva.
Důležitost
Následující tabulka definuje způsob mapování úrovně událostí na důležitost značky.
Úroveň ETW |
Důležitost Vizualizátoru souběžnosti |
|---|---|
win:LogAlways |
Normálně |
win:Critical |
Kritická |
win:Error |
Kritická |
win:Warning |
Vysoký |
win:Informational |
Normálně |
win:Verbose |
Nízký |
Větší než win:verbose |
Nízký |
Název řady
Název úkolu události použitý pro název řady.Pokud nebyl pro událost definován žádný úkol, je název řady prázdný.
Kategorie
Je-li úroveň nastavena na win:Critical nebo win:Error, je kategorie nastavena na hodnotu Alert (-1).V ostatních případech je kategorie nastavena na výchozí hodnotu (0).
Text
Byla-li pro událost definována formátovaná textová zpráva typu printf, je zobrazená jako popis značky.Jinak je popisem název události a hodnota každého pole datové části.
Přizpůsobení vizualizace událostí EventSource
Jak je popsáno v následujícím oddílu, lze zobrazení událostí EventSource přizpůsobit přidáním patřičných polí do události.
Typ značky
Použitím pole cvType typu byte lze řídit typ značky, která je použita pro reprezentaci události.Zde jsou hodnoty, které jsou pro pole cvType k dispozici:
Hodnota cvType |
Výsledný typ značky |
|---|---|
0 |
Message |
1 |
Span Start |
2 |
Span End |
3 |
Flag |
Všechny ostatní hodnoty |
Message |
Důležitost
Pole cvImportance typu byte lze použít k řízení nastavení důležitosti události EventSource.Doporučujeme však řídit zobrazenou důležitost události použitím její úrovně.
Hodnota cvImportance |
Důležitost Vizualizátoru souběžnosti |
|---|---|
0 |
Normálně |
1 |
Kritická |
2 |
Vysoký |
3 |
Vysoký |
4 |
Normálně |
5 |
Nízký |
Všechny ostatní hodnoty |
Nízký |
Název řady
Použitím pole události cvSeries typu string lze řídit název řady, který Vizualizátor souběžnosti předá události EventSource.
Kategorie
Použitím pole cvCategory typu byte lze řídit kategorii, kterou Vizualizátor souběžnosti předá události EventSource.
Text
Použitím pole cvTextW typu řetězec lze řídit popis, který Vizualizátor souběžnosti předá události EventSource.
SpanID
Použitím pole cvSpanId typu int lze porovnávat páry událostí.Hodnota každého páru událostí start/stop představujících rozsah musí být jedinečné.Pro souběžný kód toto obvykle vyžaduje použití synchronizačních primitiv, například Exchange, tak, aby byl klíč (hodnota použitá pro pole CvSpanID) byl správný.
[!POZNÁMKA]
Použití pole SpanID pro vnořené rozsahy, umožnění jejich částečného překrývání ve stejném vlákně nebo umožnění počátku v jednom vlákně a konce v jiném není podporováno.