<diagnóstico>

Artigo
06/08/2023

O elemento diagnostics define configurações que podem ser usadas pelo administrador para inspeção e controle em tempo de execução.

<configuração>
<system.serviceModel>
<diagnóstico>

Syntax

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo	Descrição
etwProviderId	Cadeia de caracteres que especifica o identificador para o provedor de Rastreamento de Eventos, que grava eventos em sessões ETW.
performanceCounters	Especifica se contadores de desempenho para o assembly estão habilitados. Os valores válidos são – Off: os contadores de desempenho estão desabilitados. – ServiceOnly: estão habilitados apenas contadores de desempenho relevantes para esse serviço. – All: contadores de desempenho podem ser exibidos em runtime. – Default: é criada uma instância única de contador de desempenho _WCF_Admin. Esta instância é usada para habilitar a coleta de dados SQM usados pela infraestrutura. Nenhum dos valores de contador para esta instância estão atualizados e, portanto, permanecerão em zero. Este será o valor padrão se não houver nenhuma configuração para o WCF.
wmiProviderEnabled	Valor Booliano que especifica se o provedor WMI para o assembly está habilitado. O provedor WMI é necessário para que o usuário obtenha acesso em tempo de execução aos recursos de inspeção e controle do WCF (Windows Communication Foundation). O padrão é `false`.

Elementos filho

Elemento	Descrição
<endToEndTracing>	Elemento de configuração que permite habilitar e desabilitar diferentes aspectos do rastreamento ponta a ponta durante a execução de um aplicativo de serviço.
<messageLogging>	Descreve as configurações para registro de mensagens em log do WCF.

Elementos pai

Elemento	Descrição
serviceModel	O elemento raiz de todos os elementos de configuração do WCF.

Comentários

A seção diagnostics define as configurações de diagnóstico para todos os serviços localizados em um assembly. Não é possível definir configurações de diagnóstico separadas no nível do serviço, a menos que haja apenas um serviço no assembly. Os atributos são definidos de acordo com os requisitos da seção.

Exemplo

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

Compartilhar via