Kanalları Tanımlama

Olaylar olay günlüğü kanallarına, olay izleme günlük dosyalarına veya her ikisine de yazılabilir. Kanal temelde olayları toplayan bir havuzdur. Etkinliklerinizin hedef kitlesi Windows Olay Görüntüleyicisi gibi olay tüketicilerini kullanıyorsa, olaylarınızı toplamak veya başka bir sağlayıcının tanımladığı mevcut kanalı içeri aktarmak için yeni kanallar tanımlamanız gerekir.

Kendi kanallarınızı tanımlamak için kanal öğesini kullanın. İçeri aktarılan kanalı tanımlamak için importChannel öğesini kullanın. Tanımladığınız içeri aktarılan kanalların veya kanalların herhangi bir bileşiminde en fazla sekiz kanal belirtebilirsiniz.

Kanalın dört türden biri olması gerekir: Admin, Operational, Analytic ve Debug. Her kanal türü, kanala yazdığınız olayların türünü belirleyen hedef kitleye sahiptir. Her türün açıklaması için ChannelType karmaşık türüne bakın.

Bir olayın yazıldığı kanalı belirtmek için, olay tanımının kanal özniteliğini kanal tanımının chid özniteliğiyle aynı değere ayarlayın. Olaylar aynı anda yalnızca bir kanala yazılabilir, ancak aynı zamanda 7 ETW oturumuna kadar da toplanabilir.

Aşağıdaki örnekte kanalın nasıl içeri aktarılacağını gösterilmektedir. chid ve ad özniteliklerini ayarlamanız gerekir. chid özniteliği kanalı benzersiz olarak tanımlar; kanal listenizdeki her kanal tanımlayıcısı benzersiz olmalıdır. name özniteliğini sağlayıcının kanalı tanımlarken kullandığı adla aynı ada ayarlayın.

<instrumentationManifest
    xmlns="http://schemas.microsoft.com/win/2004/08/events" 
    xmlns:win="http://manifests.microsoft.com/win/2004/08/windows/events"
    xmlns:xs="http://www.w3.org/2001/XMLSchema"
    >

    <instrumentation>
        <events>
            <provider name="Microsoft-Windows-SampleProvider" 
                guid="{1db28f2e-8f80-4027-8c5a-a11f7f10f62d}" 
                symbol="PROVIDER_GUID" 
                resourceFileName="<path to the exe or dll that contains the metadata resources>" 
                messageFileName="<path to the exe or dll that contains the string resources>"
                message="$(string.Provider.Name)">

                <channels>
                    <channel chid="c1"
                             name="Microsoft-Windows-BaseProvider/Admin"
                             symbol="CHANNEL_BASEPROVIDER_ADMIN"
                             type="Admin"/>
                </channels>

                . . .

            </provider>
        </events>
    </instrumentation>

    <localization>
        <resources culture="en-US">
            <stringTable>
                <string id="Provider.Name" value="Microsoft-Windows-SampleProvider"/>
            </stringTable>
        </resources>
    </localization>

</instrumentationManifest>

Winmeta.xml içeri aktarabileceğiniz eski kanalları tanımlasa da, eski kanallardan (örneğin, Uygulama veya Sistem) olayları tüketen eski tüketicileri desteklemediğiniz sürece bunları kullanmamalısınız. Winmeta.xml dosyası Windows SDK'sında bulunur.

Aşağıdaki örnekte kanalın nasıl tanımlanacağı gösterilmektedir. chid, adıve türü özniteliklerini belirlemeniz gerekir. chid özniteliği kanalı benzersiz olarak tanımlar; kanal listenizdeki her kanal tanımlayıcısı benzersiz olmalıdır. chid özniteliğini sağlayıcınızın listelediği kanallar için benzersiz bir değere ayarlayın; kanal tanımlayıcısı, olay tanımlarınızdan birinde veya daha fazlasında başvurulur. Kanalı adlandırma kuralı, sağlayıcı adını ve kanal türünüsağlayıcı adı /channeltype biçiminde kullanmaktır.

<instrumentationManifest
    xmlns="http://schemas.microsoft.com/win/2004/08/events" 
    xmlns:win="http://manifests.microsoft.com/win/2004/08/windows/events"
    xmlns:xs="http://www.w3.org/2001/XMLSchema"
    >

    <instrumentation>
        <events>
            <provider name="Microsoft-Windows-SampleProvider"
                guid="{1db28f2e-8f80-4027-8c5a-a11f7f10f62d}"
                symbol="PROVIDER_GUID"
                resourceFileName="<path to the exe or dll that contains the metadata resources>"
                messageFileName="<path to the exe or dll that contains the string resources>"
                message="$(string.Provider.Name)">

                <channels>
                    <importChannel chid="c1"
                                   name="Microsoft-Windows-BaseProvider/Admin"
                                   symbol="CHANNEL_BASEPROVIDER_ADMIN"
                                   />

                    <channel chid="c2"
                             name="Microsoft-Windows-SampleProvider/Operational"
                             type="Operational"
                             enabled="true"
                             />
                </channels>

                . . .

            </provider>
        </events>
    </instrumentation>

    <localization>
        <resources culture="en-US">
            <stringTable>
                <string id="Provider.Name" value="Microsoft-Windows-SampleProvider"/>
            </stringTable>
        </resources>
    </localization>

</instrumentationManifest>