定义严重性级别

级别用于对事件进行分组,通常指示事件的严重性或详细程度。 若要定义级别,请使用 level 元素。 Winmeta.xml 文件定义以下常用的严重性级别:

  • win:Critical
  • win:Error
  • win:Warning
  • win:Informational
  • win:Verbose

使用者使用级别来查询包含特定级别值的事件。 ETW 跟踪会话还可以使用级别来限制写入事件跟踪日志文件的事件;级别值等于或小于指定级别值的事件将写入日志文件。 例如,如果会话为 win:Warning 指定了级别值,则日志文件将包含 warning、error 和 critical 事件。

以下示例演示如何定义级别。 必须指定级别的名称和属性。 value 属性的值必须在 16 到 255 的范围内。 符号消息属性是可选的。

<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)">

                . . .

                <levels>
                    <level name="NotValid"
                           value="16"
                           symbol="LEVEL_SAMPLEPROVIDER_NOTVALID"
                           message="$(string.Level.NotValid)"/>
                    <level name="Valid"
                           value="17"
                           symbol="LEVEL_SAMPLEPROVIDER_VALID"
                           message="$(string.Level.Valid)"/>
                </levels>

                . . .

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

    <localization>
        <resources culture="en-US">
            <stringTable>
                <string id="Provider.Name" value="Sample Provider"/>
                <string id="Level.Valid" value="Valid"/>
                <string id="Level.NotValid" value="Not Valid"/>
            </stringTable>
        </resources>
    </localization>

</instrumentationManifest>