Как можете да конфигурирате диагностично регистриране на клиент

Статия
04/19/2023

Има два начина, по които можете да конфигурирате регистрирането на диагностиката на клиенти на Unified Service Desk:

С помощта на запис за настройки за проверка и диагностика, който се създава и управлява в областта на унифицираното бюро за услуги на Microsoft Dataverse.
Чрез ръчни промени във файла UnifiedServiceDesk.exe.config. След това този файл трябва да бъде разпределен на всеки работен плот, където искате да регистрирате диагностиката на клиента на Unified Service Desk.

Освен това можете да конфигурирате диагностичното регистриране специално за изключения, които могат да възникнат в клиента на Unified Service Desk.

Конфигуриране на регистрационния файл за диагностика на клиенти на унифицирано бюро за услуги

Този раздел описва как ръчно да конфигурирате диагностичното регистриране в Unified Service Desk. Вместо да използвате описаната процедура тук, препоръчваме да използвате функцията за настройки на проверка и диагностика, която осигурява централизирано администриране на диагностика и възможност за свързване на потребителски комуникатор. Повече информация: Конфигуриране на одит и диагностика в Unified Service Desk

Важно

Конфигурираната ръчно диагностика (както е описано тук), няма да работи след като разрешите запис на настройки за проверка и диагностика, който е конфигуриран за диагностика.
Unified Service Desk също така предоставя API, който ви позволява да конфигурирате богато диагностично регистриране за персонализирани хоствани контроли. Повече информация: Конфигуриране на подобрено диагностично регистриране за хоствани контроли по избор

Тази тема описва как да промените характеристиките за регистриране на клиента.

Можете да разрешите регистрирането с файла UnifiedServiceDesk.exe.config , който е наличен в директорията за инсталиране на клиенти на Unified Service Desk на вашия компютър. За да конфигурирате типа на регистриране и местоположението на регистрационния файл на Unified Service Desk:

Отворете файла UnifiedServiceDesk.exe.config за редактиране. Ако сте инсталирали клиента на Unified Service Desk на мястото по подразбиране, този файл обикновено ще бъде достъпен на адрес C:\Program Files\365 Customer Engagement USD\Microsoft Dynamics USD.

Отидете в <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>

В раздела задайте източник на <switches> регистриране (например ) и след това задайте стойност на ниво регистриране (например EventTopicSwitchError). Разделът <switches> контролира нивата на регистриране за различни източници. По подразбиране регистрирането на грешки е разрешено за всички превключватели:
- За информация относно наличните източници на регистриране вижте Налични източници на регистрационни файлове по-нататък в тази тема.
- За информация относно стойностите, които можете да зададете за всеки източник на регистриране, вижте Нива на регистриране по-нататък в тази тема.
За да конфигурирате местоположението, максималния размер на файла и поведението при преобръщане на регистрационните файлове, отидете в <shareListeners> раздела във файла.
```
<sharedListeners>  
   <add name="fileListener"  
      type="Microsoft.Xrm.Tooling.Connector.DynamicsFileLogTraceListener, Microsoft.Xrm.Tooling.Connector"  
    BaseFileName="UnifiedServiceDesk"  
    Location="LocalUserApplicationDirectory" MaxFileSize ="52428800" MaxFileCount="10"/>  
   <add name="USDDebugListener" type="Microsoft.Crm.UnifiedServiceDesk.Dynamics.UsdTraceListener, Microsoft.Crm.UnifiedServiceDesk.Dynamics" />  
   <add name="ADALListener"  
    type="Microsoft.Xrm.Tooling.Connector.DynamicsFileLogTraceListener, Microsoft.Xrm.Tooling.Connector"  
    BaseFileName="ADAL"  
     Location="LocalUserApplicationDirectory" MaxFileSize ="52428800" MaxFileCount="10"/>  
</sharedListeners>  
```
Разделът <sharelisteners> управлява местоположението и типа на регистрационните файлове, които се генерират за Unified Service Desk. По подразбиране fileListener ще създаде файл, наречен UnifiedServiceDesk.log в директория и c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> ще създаде събития в USDDebugListener изходния раздел Debug на хостваната контрола Debugger.
Ако искате да промените местоположението на файла UnifiedServiceDesk.log променете стойността на параметъра Location .
По подразбиране се създава нов регистрационен файл на Unified Service Desk, след като размерът на файла на текущия регистрационен файл надвиши 52,42 МБ. По подразбиране до 10 регистрационни файла се поддържат едновременно, преди най-старият регистрационен файл да бъде изтрит.
- За да промените максималния размер на регистрационния файл на Unified Service Desk, променете стойността в байтове на параметъра MaxFileSize .
- За да промените броя на регистрационните файлове, поддържани преди изтриването на най-стария регистрационен файл, променете стойността на параметъра MaxFileCount . Ако се използва нула (0), регистрирането на преобръщането ще бъде забранено и всички създадени клиентски регистрационни файлове на Unified Service Desk ще бъдат записани.
По подразбиране, регистрирането във файлове и в дебъгер е разрешено за всички източници. Ако искате да добавите или премахнете слушател от диагностичен източник, намерете необходимия източник в <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	Подробен източник за регистриране на потребителския интерфейс (UII) за наблюдение на трафика на съобщения в потребителския интерфейс.
Microsoft.Uii.Common.Logging	Общ UII източник на регистриране за съобщения, докладвани от UII.
Microsoft.Xrm.Tooling.CrmConnectControl	Регистрационен източник за процеса на влизане. Този източник ще докладва обща или подробна информация за диагностиката относно процедурата по влизане.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Регистрационен източник за всички Dataverse взаимодействия на ниво данни. Този източник ще докладва всички взаимодействия с Dataverse, изключения и времена.
Microsoft.Xrm.Tooling.WebResourceUtility	Регистрационен източник на заявки за данни на уеб ресурси чрез връзка с интерфейса на Dataverse.
Microsoft.Crm.UnifiedServiceDesk	Източник на регистрационни файлове за основната функционалност на унифицираното бюро за услуги. Този източник на регистрационни файлове ще докладва действия и събития, които са основни за Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Лог източник за Unified Service Desk обувка каишка и зареждане процесор. Този източник ще докладва действия и събития, които са част от инициализирането и стартирането на UII и Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	Регистрационен източник за дейности, които взаимодействат със системата UserProfile; това е част от системата за кеширане. Повече информация: Конфигуриране на клиентско кеширане за вашето агентско приложение

Можете да превключвате всеки от тези регистрационни източници независимо, за да поддържате отстраняване на неизправности и изолиране на проблеми или информация в Unified Service Desk.

Нива на диагностично регистриране

Има няколко отделни нива на регистриране, които може да използвате. С увеличаване на нивото на регистриране обаче повече данни се генерират и съхраняват в регистрационните файлове.

Ниво на регистриране	Описание
Изкл.	Забранява всички събития от този източник.
Грешка	Изпраща отчет само за събития с грешки.
Предупреждение	Изпраща отчети за грешки и събития с предупреждения.
Информация	Изпраща отчети за грешки, предупреждения и събития с информация.
Многословно	Изпраща отчети за грешки, предупреждения, информация и подробни събития.
ActivityTracing	Изпраща отчети за грешки, предупреждения, информация и подробни събития, както и проследяване на дейност (имена на методи). Забележка: ActivityTracing е наличен само в някои от източниците.
Всички	Изпраща отчет за всички събития, повдигнати от системата.

Комуникатори на диагностичното регистриране

Комуникаторите на диагностичното регистриране се използват за насочване на изходното диагностично регистриране към файлове, регистрационния файл със събития или други източници. По подразбиране всички диагностични източници са свързани както с комуникаторите по подразбиране (дебъгер), така и с файловите (текстови) комуникатори. Можете да конфигурирате допълнителни слушатели на регистрационни файлове за диагностично регистриране за Unified Service Desk. За повече информация за .NET комуникаторите по подразбиране вижте:

MSDN:DefaultTraceListener
MSDN:EventLogTraceListener
MSDN:TextWriterTraceListener

Можете също да създадете персонализирани комуникатори, за да изпращате диагностичните регистрационни файлове до местоположение по ваш избор. Персонализираните слушатели се създават чрез извличане на клас от абстрактния клас MSDN:TraceListener . Можете да намерите кратък преглед на процеса на CodeGuru.com.

Преглед на диагностичния регистрационен файл

По подразбиране регистрирането на диагностиката е разрешено за клиентското приложение Unified Service Desk. На клиентския компютър е наличен регистрационен файл UnifiedServiceDesk-date <>.log за записване на оперативни грешки в клиентското приложение. c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> Регистрационният файл се създава първия път, когато срещнете някакви грешки в клиентското приложение.

Когато възникне грешка в хоствана контрола, информацията, регистрирана в регистрационните файлове, осигурява подробна информация за изключението, като например първоначалната хоствана контрола, причинила изключението, заедно с подробностите за изключението. Обърнете внимание, че не е регистриран целият JavaScript код, причинил изключението. Регистрирани са само неправилният код и описанието на изключението.

Това са примерни подробности за изключение, които са регистрирани.

Microsoft.Crm.UnifiedServiceDesk.Dynamics   Error   2   12/27/2016 11:54:15 AM  Origin:AppdomianUnhandledException, IsFatal:True  
Source: DemoControl  
Target: Void throwExceptionMethod()  
Exception: Exception in custom control  
StackTrace:   at DemoControl.USDControl.throwExceptionMethod()  
   at System.Threading.ExecutionContext.RunInternal(ExecutionContext executionContext, ContextCallback callback, Object state, Boolean preserveSyncCtx)  
   at System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback callback, Object state, Boolean preserveSyncCtx)  
   at System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback callback, Object state)  
   at System.Threading.ThreadHelper.ThreadStart()

Процес за проследяване на Unified Service Desk

Unified Service Desk Monitoring Process (usdmp.exe) е услуга, която непрекъснато следи изправността на Unified Service Desk и прекратява по подразбиране след 5 секунди всички екземпляри на процеса на браузъра, които не отговарят и причиняват липса на реакция на Unified Service Desk. Ако екземпляр на процес на браузър не отговаря, но Unified Service Desk реагира, екземплярът на процеса на браузъра няма да бъде прекратен. За повече информация как да промените продължителността на глобалната опция ProcessTerminationThreshold за прекратяване на процеса на браузъра, вижте Управление на опциите за унифицирано бюро за услуги.

Отчитане на диагностика на грешки

Присъствието на подробно и изчерпателно регистриране и отчитане, което възниква по време на грешка на компонент, приложение или система, може да помогне за идентифицирането на това кога и как е станала грешката. В допълнение към стандартната диагностика регистриране, диагностика на грешки отчитане записи система и информация за състоянието на приложението в случай на изключение в клиента на Unified Service Desk. Повече информация за изключенията можете да намерите в Как Unified Service Desk обработва грешки в приложения и системи.

Папки и файлове, създадени по време на изключение

В случай на изключение, отчитането на диагностиката на грешки създава папка на локалния компютър с име DiagnosticsLogs_дата и час, където датата и часът са във формата година-месец-date_time, например DiagnosticLogs_20170322_173643. В папката DiagnosticsLogs се създават следните папка и файлове.

Файл за диагностика	Описание
UnifiedServiceDesk_дата и час.log	Стандартен регистрационен файл за диагностика, който се създава и добавя, когато се изпълнява клиент на Unified Service Desk. Файлът съдържа информация за регистриране за клиента на Unified Service Desk (UnifiedServiceDesk.exe). Текущите файлове се преместват в папката DiagnosticsLogs в случай на изключение.
UnifiedServiceDeskMonitoring_дата.log	Стандартен регистрационен файл за диагностика, който се създава и добавя, когато се изпълнява клиент на Unified Service Desk. Съдържа информация за регистриране за процеса на наблюдение на Unified Service Desk (usdmp.exe), който е процес, който следи изправността на клиента на Unified Service Desk. Текущите файлове се преместват в папката DiagnosticsLogs в случай на изключение. Повече информация: Унифициран процес на мониторинг на бюрото за обслужване
Eventlogs (папка)	Папката, създадени в случай на фатално или нефатално изключение. Съдържа регистрационните файлове на събитията и системата на Windows и текстови файлове с отчети за грешки.
ExitReport.txt	Изходен регистрационен файл, създаден в случай на фатално или нефатално изключение. Съдържа информация за състоянието на процеса, като например име на машината, версия на унифицираното бюро за услуги, идентификатор на процеса, код за изход и час на излизане.
MachineHealthReport.txt	Изходен регистрационен файл, създаден в случай на фатално или нефатално изключение. Съдържа информация за състоянието на системата, като процесор на компютъра, операционна система, данни за монитора, език и версия на браузъра.
ProcessReport.csv	Изходен регистрационен файл, създаден в случай на фатално или нефатално изключение. Предоставя пълен списък на всички процеси, които са работили в системата по време на изключението.
RegistryLog.txt	Изходен регистрационен файл, създаден в случай на фатално или нефатално изключение. Включва текстово базирано копие на подключовете на системния регистър на Windows за Internet Explorer.
UnifiedServiceDesk_processId_CrashDump_дата и час.dmp	Създава се само в случай на фатално необработено изключение или когато се извика ръчно с помощта на клавишна комбинация за глобални опции на ManualDumpShortcut. Предоставя файл за пълно разтоварване на паметта за UnifiedServiceDesk.exe. Обърнете внимание, че за да видите дъмп файла, имате нужда Visual Studio или друг инструмент за преглед на дъмп файлове на Windows.

Конфигуриране на отчитането на диагностика на грешки

Влизане в Администратор на Unified Service Desk.
Изберете Проверка и диагностика под Разширени настройки.
Изберете + Създай и след това изберете Конфигурация за диагностика.
Изберете или въведете желаните стойности, като проследяване, наблюдение на изхода и местоположението на папката за регистрационни файлове за диагностика. Повече информация: Диагностика
Изберете Запиши и затвори.

Вижте също

Конфигуриране на проверка и диагностика в Unified Service Desk

Поддръжка за отстраняване на грешки в Unified Service Desk за отстраняване на проблеми

Проблеми с отстраняването на грешки в Unified Service Desk