<diagnostics>

  • 项目

diagnostics 元素定义管理员可以用来进行运行时检查和控制的设置。

configuration
  system.serviceModel
    <诊断>

语法

<system.serviceModel>
  <diagnostics etwProviderId="String"
               performanceCounters="Off/ServiceOnly/All/Default"
               wmiProviderEnabled="Boolean">
    <endToEndTracing activityTracing="Boolean"
                     messageFlowTracing="Boolean"
                     propagateActivity="Boolean" />
    <messageLogging logEntireMessage="Boolean"
                    logMalformedMessages="Boolean"
                    logMessagesAtServiceLevel="Boolean"
                    logMessagesAtTransportLevel="Boolean"
                    maxMessagesToLog="Integer"
                    maxSizeOfMessageToLog="Integer">
      <filters>
        <clear />
      </filters>
    </messageLogging>
  </diagnostics>
</system.serviceModel>

特性和元素

下列各节描述了特性、子元素和父元素。

特性

属性 说明
etwProviderId 一个字符串，指定将事件写入到 ETW 会话的事件跟踪提供程序的标识符。
performanceCounters 指定是否启用程序集的性能计数器。 有效值为

- Off：禁用性能计数器。
- ServiceOnly：仅启用与此服务相关的性能计数器。
- All：可以在运行时查看性能计数器。
- Default：创建一个性能计数器实例 _WCF_Admin。 此实例用于启用基础结构所使用的 SQM 数据的集合。 此实例的计数器值均未进行更新，因此将保持为零。 这是在 WCF 没有配置的情况下的默认值。
wmiProviderEnabled 一个布尔值，指定是否启用程序集的 WMI 提供程序。 用户要获得在运行时访问 Windows Communication Foundation (WCF) 的检查和控制功能的权限，需要使用 WMI 提供程序。 默认值为 false。

子元素

元素 说明
<endToEndTracing> 一个配置元素，用于启用和禁用服务应用程序运行过程中端对端跟踪的不同方面。
<messageLogging> 描述 WCF 消息日志记录的设置。

父元素

元素 说明
serviceModel 所有 WCF 配置元素的根元素。

备注

diagnostics 节定义了位于程序集中的所有服务的诊断设置。 无法在服务级别定义单独的诊断设置，除非程序集中只有一个服务。 将根据本节的需求来设置属性。

示例

<diagnostics wmiProviderEnabled="false"
             performanceCounters="all">
  <messageLogging logEntireMessage="true"
                  logMalformedMessages="true"
                  logMessagesAtServiceLevel="true"
                  logMessagesAtTransportLevel="true"
                  maxMessagesToLog="42"
                  maxSizeOfMessageToLog="42">
    <filters>
      <clear />
    </filters>
  </messageLogging>
</diagnostics>

请参阅