Aktivera WPP-spårning via Windows-händelseloggtjänsten

Windows-händelseloggtjänsten stöder WPP-loggning och avkodning. Det här avsnittet beskriver hur du aktiverar WPP-spårning via Windows-händelseloggtjänsten.

Att aktivera WPP-spårning i det här scenariot kräver inget extra arbete till WPP-providern. Om du vill använda windows-händelseloggtjänsten måste du dock ange ett manifest och en händelseloggprovider. Om du vill aktivera WPP-spårning deklarerar du en felsökningskanal och anger det associerade kontroll-GUID som deklarerats för din WPP-provider.

Till exempel:

<instrumentationManifest
    xmlns="http://schemas.microsoft.com/win/2004/08/events"
    xmlns:win="http://manifests.microsoft.com/win/2004/08/windows/events"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema"  xsi:schemaLocation="http://schemas.microsoft.com/win/2004/08/events eventman.xsd"  
    >
   <instrumentation>
        <events>
            <provider name="Microsoft-Windows-mySampleProvider"
                guid="{61CE3EC9-E5E8-4b96-A451-74631A6E0D5C}"
                >
          <channel
        chid="MS_WINDOWS_GE_DEBUG"
        enabled="false"
        isolation="System"
        message="$(string.Microsoft-Windows-GenerateEvent.channel.CHANNEL_DEBUG.message)"
        name="Microsoft-Windows-GenerateEvent/Debug"
        symbol="CHANNEL_DEBUG"
        type="Debug"
        >
        <publishing>
          <level>2</level>
          <keywords>0xFFFFFFFF</keywords>
          <controlGuid>{d58c126f-b309-11d1-969e-0000f875a5bc}</controlGuid>
        </publishing>
        </channel>
       </provider>
    </events>
   </instrumentation>
</instrumentationManifest>

WPP-spårning är inte avsett att aktiveras hela tiden, så som standard ska aktiveringsattributet i manifestet vara inställt på false. När WPP-spårning behövs ändrar du attributet i manifestet så att enabled="true".

Du kan inte ange eller välja kontrollbitar individuellt. Om du vill aktivera alla WPP-händelser för den här kanalen anger du ett nyckelordsvärde för 0XFFFFFFFF. Internt kan du kontrollera att bitar mappas till nyckelord. Om du vet vilken bit som mappar till ett visst nyckelord kan du välja det nyckelordet för att hämta en specifik uppsättning händelser. I exempelmanifestet är nyckelordsvärdet 0xFFFF eftersom mindre än 16 WPP-kontrollbitar behövs. Om du vill hämta en specifik uppsättning händelser efter installationen kan du ändra nyckelorden med hjälp av kommandoradsverktyget wevtutil.exe. Kommandot är:

wevtutilsl<kanalnamn>/k:<nyckelvärde motsvarande kontrollbit>

Observera att kanalen först måste inaktiveras för att ändra nyckelordsvärdet.

Genom att deklarera en kanal på det här sättet kan både WPP-providern (vars kontroll-GUID anges) och händelseloggprovidern (under vilken den här kanalen deklareras) komma åt felsökningskanalen, så att någon av leverantörerna kan skriva till den här kanalen. WPP-händelser eller normala ETW-händelser kan nu ses i denna kanal via händelsevisaren.

WPP-händelser avkodas inte. Om du vill hämta meddelandesträngar som är associerade med dessa händelser placerar du TMF-filerna i katalogen %windir%\System32\winevt\TraceFormat. Du kan hämta TMF-filerna med hjälp av ett verktyg som Tracepdb.exe, som tar PDB-filen för indata och returnerar TMF-filer.