Trasování událostí pro Windows (ETW)

Ukázka AnalyticTrace ukazuje, jak implementovat trasování typu End-to-End (E2E) pomocí trasování událostí pro Windows (ETW) a ETWTraceListener poskytovaného touto ukázkou. Ukázka je založená na Začínáme a zahrnuje ETW trasování.

Poznámka:

Postup nastavení a pokyny k sestavení pro tuto ukázku najdete na konci tohoto tématu.

Tato ukázka předpokládá, že znáte trasování a protokolování zpráv.

Každý zdroj trasování v System.Diagnostics modelu trasování může mít několik posluchačů trasování, kteří určují, kde a jak se data trasují. Typ posluchače definuje formát, ve kterém se zaznamenávají data trasování. Následující ukázka kódu ukazuje, jak přidat naslouchací proces do konfigurace.

<system.diagnostics>
    <sources>
        <source name="System.ServiceModel"
             switchValue="Verbose,ActivityTracing"
             propagateActivity="true">
            <listeners>
                <add type=
                   "System.Diagnostics.DefaultTraceListener"
                   name="Default">
                   <filter type="" />
                </add>
                <add name="ETW">
                    <filter type="" />
                </add>
            </listeners>
        </source>
    </sources>
    <sharedListeners>
        <add type=
            "Microsoft.ServiceModel.Samples.EtwTraceListener, ETWTraceListener"
            name="ETW" traceOutputOptions="Timestamp">
            <filter type="" />
       </add>
    </sharedListeners>
</system.diagnostics>

Před použitím tohoto posluchače musí být spuštěna ETW relace trasování. Tuto relaci lze spustit pomocí Logman.exe nebo Tracelog.exe. Součástí této ukázky je SetupETW.bat soubor, abyste mohli nastavit relaci trasování pro Windows, spolu s CleanupETW.bat souborem pro zavření relace a dokončení log souboru.

Poznámka:

Postup nastavení a pokyny k sestavení pro tuto ukázku najdete na konci tohoto tématu. Další informace o těchto nástrojích najdete v tématu https://go.microsoft.com/fwlink/?LinkId=56580

Při použití ETWTraceListener se trasování protokolují v binárních souborech .etl. Když je trasování modelu ServiceModel zapnuté, zobrazí se všechna vygenerovaná trasování ve stejném souboru. K zobrazení souborů protokolu .etl a .svclog použijte nástroj prohlížeče trasování služeb (SvcTraceViewer.exe ). Prohlížeč vytvoří ucelený pohled na systém, který umožňuje trasovat zprávu ze zdroje do cíle a bodu spotřeby.

Naslouchací proces ETW trasování podporuje kruhové protokolování. Pokud chcete tuto funkci povolit, přejděte na Start, Spustit a zadejte cmd , abyste spustili konzolu příkazů. V následujícím příkazu nahraďte <logfilename> parametr názvem souboru protokolu.

logman create trace Wcf -o <logfilename> -p "{411a0819-c24b-428c-83e2-26b41091702e}" -f bincirc -max 1000

Přepínače -f a -max jsou volitelné. Určují binární kruhový formát a maximální velikost protokolu, která je 1000 MB. Přepínač -p slouží k určení poskytovatele sledování. V našem příkladu je "{411a0819-c24b-428c-83e2-26b41091702e}" identifikátor GUID pro "Ukázkový poskytovatel ETW XML".

Relaci spustíte zadáním následujícího příkazu.

logman start Wcf

Po dokončení protokolování můžete relaci zastavit pomocí následujícího příkazu.

logman stop Wcf

Tento proces generuje binární cyklické protokoly, které můžete zpracovat pomocí zvoleného nástroje, včetně nástroje Service Trace Viewer (SvcTraceViewer.exe) nebo Tracerpt.

Další informace o alternativním naslouchacím procesu pro provádění cyklického protokolování najdete také v ukázce kruhového trasování.

Jak nastavit, sestavit a spustit ukázku

  1. Ujistěte se, že jste provedli One-Time postup nastavení ukázek Windows Communication Foundation.

  2. Pro sestavení řešení postupujte podle pokynů v Sestavení ukázek Windows Communication Foundation.

    Poznámka:

    Pokud chcete použít příkazy RegisterProvider.bat, SetupETW.bat a CleanupETW.bat, musíte spustit pod účtem místního správce. Pokud používáte systém Windows Vista nebo novější, musíte také spustit příkazový řádek se zvýšenými oprávněními. Uděláte to tak, že kliknete pravým tlačítkem myši na ikonu příkazového řádku a potom kliknete na Spustit jako správce.

  3. Před spuštěním ukázky spusťte RegisterProvider.bat na klientovi a serveru. Tím se nastaví výsledný soubor ETWTracingSampleLog.etl pro generování trasování, které může prohlížeč trasování služby přečíst. Tento soubor najdete ve složce C:\logs. Pokud tato složka neexistuje, je třeba ji vytvořit, jinak se negenerují žádné záznamy o činnosti. Spusťte SetupETW.bat na počítačích klienta a serveru, abyste zahájili relaci trasování událostí pro Windows (ETW). Soubor SetupETW.bat najdete ve složce CS\Client.

  4. Pokud chcete spustit ukázku v konfiguraci s jedním počítačem nebo konfiguraci na více počítačích, postupujte podle pokynů v části Spouštění ukázek Windows Communication Foundation.

  5. Po dokončení ukázky spusťte CleanupETW.bat a dokončete vytvoření souboru ETWTracingSampleLog.etl.

  6. V aplikaci Service Trace Viewer otevřete soubor ETWTracingSampleLog.etl. Zobrazí se výzva k uložení binárního formátovaného souboru jako souboru .svclog.

  7. Otevřete nově vytvořený soubor .svclog v rámci prohlížeče Service Trace Viewer pro zobrazení trasování ETW a ServiceModel.

Viz také

  • Last updated on