Настройка ведения журнала диагностики в Unified Service Desk

  • Статья

Unified Service Desk и базовые вспомогательные библиотеки обеспечивают несколько уровней ведения журнала диагностики, которые можно использовать для устранения неполадок. Журналы диагностики также используются в производственном развертывании Unified Service Desk для решения конкретных проблем на постоянной основе.

По умолчанию ведение журнала ошибок включено для клиентского приложения Unified Service Desk. Файл журнала UnifiedServiceDesk.log можно найти в следующей папке на клиентском компьютере для записи рабочих ошибок в клиентском приложении: «c:\Users\<Имя_пользователя>\AppData\Roaming\Microsoft\UnifiedServiceDesk\<Версия>. Файл журнала создается при возникновении первой ошибки в клиентском приложении.

Содержание

Настройка ведения журнала диагностики

Источники журнала диагностики

Уровни ведения журнала диагностики

Прослушиватели журнала диагностики

Настройка ведения журнала диагностики

Ведение журнала включается с помощью файла UnifiedServiceDesk.exe.config, который находится в папке установки клиента Unified Service Desk на вашем компьютере. Чтобы настроить тип ведения журнала и расположение файла журнала Unified Service Desk :

  1. Откройте файл UnifiedServiceDesk.exe.config для редактирования. Если клиент Unified Service Desk установлен в расположении по умолчанию, этот файл будет доступен по пути "C:\Program Files\Microsoft Dynamics CRM USD\USD".

  2. Перейдите к разделу <switches> в этом файле:

    <switches>
<!-- 
     Possible values for switches: Off, Error, Warning, Information, Verbose
        Verbose:      includes Error, Warning, Info, Trace levels
        Information:  includes Error, Warning, Info levels
        Warning:      includes Error, Warning levels
        Error:        includes Error level
 -->
    <add name="EventTopicSwitch" value="Error"/>
    <add name="Microsoft.Uii.Common.Logging" value="Error"/>
    <add name="Microsoft.Xrm.Tooling.CrmConnectControl" value="Error"/>
    <add name="Microsoft.Xrm.Tooling.Connector.CrmServiceClient" value="Error"/>
    <add name="Microsoft.Xrm.Tooling.WebResourceUtility" value="Error"/>
    <add name="Microsoft.Crm.UnifiedServiceDesk" value="Error"/>
    <add name="Microsoft.Crm.UnifiedServiceDesk.Dynamics" value="Error"/>
    <add name="Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager" value="Error"/>
    <add name="UnifiedServiceDesk.KPIControl" value="Error"/>
</switches>

  3. В разделе <switches> укажите источник ведения журнала (например, EventTopicSwitch), а затем укажите значение уровня ведения журнала (например, Error). Раздел <switches> определяет уровни ведения журнала для различных источников. По умолчанию ведение журнала включено для всех разделов.

    • Сведения о доступных источниках ведения журнала см. в подразделе Источники журнала диагностики далее в этом разделе.

    • Сведения о значениях, которые можно указать для каждого источника ведения журнала, см. в подразделе Уровни ведения журнала диагностики далее в этом разделе.

  4. Чтобы настроить местоположение файлов журнала, перейдите к разделу <shareListeners> в файле:

    <sharedListeners>
    <add name="fileListener"
        type="Microsoft.Xrm.Tooling.Connector.DynamicsFileLogTraceListener, Microsoft.Xrm.Tooling.Connector"
            BaseFileName="UnifiedServiceDesk"
                Location="LocalUserApplicationDirectory"
        />
    <add name="USDDebugListener" type="Microsoft.Crm.UnifiedServiceDesk.Dynamics.UsdTraceListener, Microsoft.Crm.UnifiedServiceDesk.Dynamics" />
</sharedListeners>

    Раздел <sharelisteners> определяет расположение и тип журналов, создаваемых для Unified Service Desk. По умолчанию fileListener создаст файл с именем UnifiedServiceDesk.log в папке «c:\Users\<Имя_пользователя>\AppData\Roaming\Microsoft\UnifiedServiceDesk\<Версия>, а USDDebugListener будет создавать события во вкладке Вкладка «Выходные данные отладки» размещенного элемента управления «Отладчик».

  5. Если требуется изменить расположение файла UnifiedServiceDesk.log, измените значение параметра Location.

  6. По умолчанию файл и ведение журнала в отладчике включены для всех источников. Чтобы добавить прослушиватель в источник диагностики или удалить его оттуда, найдите требуемый источник в разделе <sources>, а затем измените раздел <listeners> источника, включив в него требуемый прослушиватель.

    Например, чтобы добавить ведение журнала событий для Unified Service Desk, добавьте прослушиватель журнала событий для источника Microsoft.Crm.UnifiedServiceDesk:

    <source name="Microsoft.Crm.UnifiedServiceDesk" switchName="Microsoft.Crm.UnifiedServiceDesk" switchType="System.Diagnostics.SourceSwitch">
    <listeners>
        <add name="fileListener"/>
        <add name="USDDebugListener" />
        <add name="eventLogListener" type="System.Diagnostics.EventLogTraceListener" initializeData="USD"/>
    </listeners>
</source>

    В результате события помимо файла и элемента «Отладчик» будут регистрироваться в журнале событий Windows с тегом «USD». Дополнительные сведения о прослушивателях диагностики см. в подразделе Прослушиватели журнала диагностики далее в этом разделе.

Источники журнала диагностики

В следующей таблице перечислены общие источники журнала для устранения неполадок.

Имя источника Описание

EventTopicSwitch

Источник ведения подробных журналов User Interface Integration (UII) для мониторинга трафика сообщений внутри UII.

Microsoft.Uii.Common.Logging

Источник общего журнала UII для сообщений из UII.

Microsoft.Xrm.Tooling.CrmConnectControl

Источник журнала для процесса входа в CRM. Этот источник будет поставлять общие или подробные диагностические сведения о процедуре входа.

Microsoft.Xrm.Tooling.Connector.CrmServiceClient

Источник журнала для всех взаимодействий на уровне данных в CRM. Этот источник будет сообщать обо всем обмене данными с CRM, исключениях и временных параметрах.

Microsoft.Xrm.Tooling.WebResourceUtility

Источник журнала для запросов данных веб-ресурса через ссылку на интерфейс CRM.

Microsoft.Crm.UnifiedServiceDesk

Источник журнала для базовых функций Unified Service Desk. Этот источник журнала будет сообщать о действиях и событиях, которые являются базовыми для Unified Service Desk.

Microsoft.Crm.UnifiedServiceDesk.Dynamics

Источник журнала для процессора загрузки Unified Service Desk. Этот источник будет сообщать о действиях и событиях, которые являются частью процесса инициализации и запуска UII, а также о Unified Service Desk.

Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager

Источник журнала для действий, которые взаимодействуют с системой UserProfile; является частью системы кэширования. Дополнительные сведения: Настройка кэширования клиента в Unified Service Desk

Каждый из этих источников журнала может включается независимо друг от друга для устранения неполадок, а также изоляции проблем или данных в Unified Service Desk.

Уровни ведения журнала диагностики

Доступно несколько различных уровней ведения журнала. Однако следует помнить, что при повышении уровня ведения журнала растет объем данных, которые создаются и заносятся в журнал.

Уровень журнала Описание

Выкл.

Отключение всех событий из этого источника.

Ошибка

Сообщение только о событиях ошибок.

Предупреждение!

Сообщения об ошибках и предупреждениях.

Сведения

Сообщения об ошибках, предупреждениях, а также информационных событиях.

Подробный

Сообщения об ошибках, предупреждениях, информационных событиях и дополнительных событиях.

ActivityTracing

Сообщения об ошибках, предупреждениях, информационных и дополнительных событиях, а также трассировка действий (имена методов).

Примечание

ActivityTracing доступен не для всех источников.

Все

Сообщения обо всех событиях в системе.

Прослушиватели журнала диагностики

Прослушиватели журнала диагностики используются для направления вывода журнала диагностики в файлы, журнал событий или другие источники. По умолчанию все источники диагностики соединены с прослушивателем по умолчанию (отладчик) и прослушивателем файлов (текст). В Unified Service Desk можно настроить дополнительные прослушиватели для сбора данных диагностики. Дополнительные сведения о прослушивателях по умолчанию .NET см. по следующим ссылкам:

Можно также создать пользовательские прослушиватели для отправки журналов диагностики в указанное вами место. Пользовательские прослушиватели создаются с помощью класса, производного от абстрактного класса TraceListener. Пошаговое руководство по этому процессу можно найти на веб-сайте CodeGuru.com.

См. также

Основные понятия:

Вопросы отладки в Unified Service Desk

Другие ресурсы

Устранение неполадок Unified Service Desk с помощью отладчика и сбора данных диагностики

Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.