Share via

Диалоговое окно «Настройка диагностической трассировки и ведения журнала сообщений»

  • Статья

Диалоговое окно Настройка диагностической трассировки и ведения журнала сообщений используется для настройки уровней трассировки WCF и WF, а также для настройки параметров ведения журнала сообщений на уровне сервера, сайта или приложения. В этом диалоговом окне можно настроить функциональность наблюдения System.Diagnostics прежних версий. При настройке System.Diagnostics создается файл svclog, который используется средством SvcTraceViewer. Это обеспечивает дополнительную интеграцию с компонентами устранения неполадок Windows Server AppFabric.

Уровни трассировки WF и WCF задаются в порядке возрастания детализации: Выкл., Критический, Ошибка, Предупреждение, Сведения и Подробно. Чем более детальный параметр выбран, тем больше сведений записывается в журнал трассировки, который может помочь в процессе выявления проблемы. Однако повышение детализации сопровождается соответствующим понижением производительности.

Поля диалогового окна

Трассировка

Поле

Описание

Уровень трассировки WCF

Выберите уровень трассировки для сообщений WCF. При загрузке для этого поля устанавливается уровень «Подробно» (switchValue), если в элементе обнаруживается source name="System.ServiceModel".

Уровень трассировки рабочих процессов

Выберите уровень для трассировки рабочих процессов. При загрузке для этого поля устанавливается уровень «Подробно» (switchValue), если в элементе обнаруживается source name="System.ServiceModel".

Имя файла трассировки

Укажите имя файла журнала трассировки SVCLOG, в котором будут храниться сведения трассировки. Это поле принимает значение атрибута initializeData из общего listenertype System.Diagnostics.XmlWriterTraceListener. При загрузке это значение отключено до тех пор, пока для уровня трассировки рабочих процессов или для уровня трассировки WCF не будет установлено значение, отличное от Выкл.. После выбора для одного из этих уровней трассировки значения, отличного от Выкл., поле Имя файла трассировки становится включенным. Можно нажать кнопку Обзор для вызова стандартного диалогового окна Windows Открыть файл и выбора имени файла журнала трассировки.

Ведение журнала сообщений

Поле

Описание

Включить

Укажите, включено ли ведение журнала сообщений диагностики системы. Этот флажок установлен, если в разделе <system.diagnostics> обнаруживается source с name System.ServiceModel.MessageLogging.

Записывать на транспортном уровне

Принимает значение от logMessagesAtTransportLevel. Указывает, выполняется ли трассировка сообщений на транспортном уровне.

Записывать сообщение целиком

Принимает значение logEntireMessage. Указывает, записываются ли сообщения полностью.

Записывать неправильно сформированные сообщения

Принимает значение от logMalformedMessages. Указывает, записываются ли неправильно сформированные сообщения.

Имя файла

Укажите имя файла журнала SVCLOG, в котором будут храниться сведения журнала сообщений. Это поле принимает значение атрибута initializeData из общего listenertype System.Diagnostics.XmlWriterTraceListener. При загрузке это значение отключено, пока не будет установлен флажок Включить. В этот момент поле Имя файла становится включенным, и можно нажать кнопку Обзор для вызова стандартного диалогового окна Windows Открыть файл и установки имени файла журнала сообщений.

Связанные конфигурации

Поля диалогового окна Настройка диагностической трассировки и ведения журнала сообщений соответствуют приведенным ниже элементам и атрибутам в файле конфигурации.

<system.diagnostics>
  <sources>
    <source name="System.ServiceModel"
            switchValue="Information, ActivityTracing"
            propagateActivity="true">
      <listeners>
        <add name="xml" />
      </listeners>
    </source>
    <source name="System.Activities"
            switchValue="Information, ActivityTracing">
      <listeners>
        <add name="xml" />
      </listeners>
    </source>
    <source name="System.ServiceModel.MessageLogging">
      <listeners>
        <add name="messages"
             type="System.Diagnostics.XmlWriterTraceListener"
             initializeData="c:\logs\messages.svclog" />
      </listeners>
    </source>
  </sources>
  <sharedListeners>
    <add name="xml"
         type="System.Diagnostics.XmlWriterTraceListener"
         initializeData="c:\log\Traces.svclog" />
  </sharedListeners>
</system.diagnostics>
<system.serviceModel>
  <diagnostics>
    <messageLogging 
         logEntireMessage="true" 
         logMalformedMessages="false"
         logMessagesAtServiceLevel="true" 
         logMessagesAtTransportLevel="false"
         maxMessagesToLog="3000"
         maxSizeOfMessageToLog="2000"/>
  </diagnostics>
</system.serviceModel>

Дополнительные сведения об уровнях ведения журнала сообщений и их значениях см. в статье Рекомендуемые параметры трассировки и ведения журнала сообщений.

  2011-12-05