Клиенттің диагностикалық журналын конфигурациялау жолы

Бірыңғай қызмет көрсету үстелінің клиенттік диагностикалық журнал жүргізуін конфигурациялаудың екі жолы бар:

• Бірыңғай қызмет үстелі аймағында жасалған және басқарылатын Аудит және диагностика параметрлері жазбасын пайдалану арқылы Microsoft Dataverse.

• UnifiedServiceDesk.exe.config файлын қолмен өзгерту әдісі. Содан кейін бұл файл бірыңғай қызмет үстелі клиентінің диагностикалық журнал жүргізуін қалаған әрбір жұмыс үстеліне таратылуы тиіс.

  Сонымен қатар, диагностикалық журнал жүргізуді Бірыңғай қызмет көрсету үстелі клиентінде орын алуы мүмкін ерекшеліктер үшін арнайы конфигурациялауға болады.

Бірыңғай қызмет үстелінің клиенттік диагностикалық журнал жүргізуін теңшеу

Бұл бөлімде Бірыңғай қызмет көрсету үстелінде диагностикалық журнал жүргізуді қолмен конфигурациялау әдісі сипатталады. Осында сипатталған рәсімді қолданыңыз. Сізге диагностиканың жүйе әкімшісі ұсынатын тексеру және диагностикалау параметрлері мен реттелмелі тыңдаушыларға қосылу мүмкіндігін береміз. Қосымша ақпарат: Аудит пен диагностиканы Бірыңғай қызмет үстелінде конфигурациялау

Маңызды

• Қолмен конфигурацияланатын диагностикалар (осында сипатталғандай) диагностика үшін конфигурацияланатын тексеру және диагностикалау параметрі жазбасын іске қосқан соң ары қарай жарамды болмайды.
• Сондай-ақ, Бірыңғай қызмет көрсету үстелі реттелетін басқару элементтері үшін бай диагностикалық журнал жүргізуді конфигурациялауға мүмкіндік беретін API қызметін ұсынады. Қосымша ақпарат: Реттелетін басқару элементтері үшін күшейтілген диагностикалық журнал жүргізуді теңшеу

Бұл тақырыпта клиенттің жүйеге кіру ерекшеліктерін өзгерту әдісі сипатталады.

Компьютеріңіздегі Бірыңғай қызмет көрсету үстелі клиентін орнату каталогында қолжетімді UnifiedServiceDesk.exe.config файлымен журнал жүргізуді қосуға болады. Журнал жүргізу түрін және Бірыңғай қызмет көрсету үстелі журналы файлының орнын конфигурациялау үшін:

1. Өңдеу үшін UnifiedServiceDesk.exe.config файлын ашыңыз . Егер әдепкі орында Бірыңғай қызмет үстелі клиентін орнатсаңыз, бұл файл әдетте C:\Program Files\Microsoft Dynamics 365 Тұтынушыны тарту 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" 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> Бірыңғай қызмет көрсету үстелі үшін жасалған журналдардың орналасуы мен түрі бақыланады. Әдепкі бойынша, каталогта fileListener UnifiedServiceDesk.log деп аталатын файлды жасайды және c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> Debugger орналастырылған басқару элементінің Debug шығыс қойындысында USDDebugListener оқиғалар жасайды.

5. Егер UnifiedServiceDesk.log файлының орнын өзгерткіңіз келсе, параметрдің мәнін Location өзгертіңіз.

6. Әдепкі бойынша, ағымдағы журнал файлының өлшемі 52,42 МБ-тан асқаннан кейін жаңа Бірыңғай қызмет көрсету үстелі журналы жасалады. Әдепкі бойынша, ең ескі журнал файлы жойылмас бұрын бір уақытта ең көп 10 журнал файлы сақталады.

   • Ең көп Бірыңғай қызмет үстелі журналы файлының өлшемін өзгерту үшін, MaxFileSize параметрінің байттағы мәнін өзгертіңіз.

   • Ең ескі журнал жойылғанға дейін сақталған журналдар санын өзгерту үшін MaxFileCount параметрінің мәнін өзгертіңіз. Егер нөл (0) пайдаланылса, рулонды журнал жүргізу ажыратылады және жасалған Бірыңғай қызмет көрсету үстелінің клиенттік журналдары сақталады.

7. Әдепкі бойынша файл мен түзетушіге кіру барлық көздер үшін қосылған. Егер тыңдаушыны диагностикалау көзінен қосқыңыз келсе немесе жойғыңыз келсе, бөлімде <sources> қажетті дереккөзді тауып, қажетті тыңдаушыны қосу үшін дереккөз бөлімін өзгертіңіз <listeners> .

   Мысалы, Бірыңғай қызмет үстелі үшін оқиға журнал жүргізуін қосу үшін оқиға журнал тыңдаушысын дереккөзге 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>  
   

   Бұл енді оқиғалар туралы Файл мен Debugger-ден басқа «USD» тегі бар Windows оқиғалар журналына хабарлайды. Диагностикалық тыңдаушылар туралы қосымша ақпаратты кейінірек осы тақырыпта Диагностикалық журнал тыңдаушылары бөлімінен қараңыз .

Диагностикалық журнал көздері

Жалпы ақаулықтарды жою көздері келесі кестеде тізімделген.

Қайнар көзінің аты	Сипаттама
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	Негізгі Бірыңғай қызмет үстелінің функционалдығына арналған журнал көзі. Бұл журнал көзі Бірыңғай қызмет көрсету үстеліне негізгі болып табылатын әрекеттер мен оқиғалар туралы хабарлайды.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Бірыңғай қызмет үстелінің жүктеу белбеуіне және жүктеу процессорына арналған журнал көзі. Бұл дереккөз UII және Unified Service Desk-ті инициализациялау мен іске қосудың бір бөлігі болып табылатын әрекеттер мен оқиғалар туралы хабарлайды.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	UserProfile жүйесімен әрекеттесетін әрекеттерге арналған журнал көзі; бұл кэштеу жүйесінің бөлігі болып табылады. Қосымша ақпарат: Агент қолданбасы үшін клиент кэшін конфигурациялау

Бірыңғай қызмет үстелі ішіндегі ақаулықтарды жоюды және ақпаратты оқшаулауды қолдау үшін осы журнал көздерінің әрқайсысын өз бетінше қосуға болады.

Диагностикалық жүйеге кіру деңгейі

Пайдалануға болатын бірнеше анық жүйеге кіру деңгейлері бар. Дегенмен, жүйеге кіру деңгейін көтерген кезде журнал файлдарында көбірек деректер жасалып, сақталады.

Журнал деңгейі	Сипаттама
Өшірілген	Осы көзден барлық оқиғалар өшіріледі.
Қате	Тек қате оқиғалар туралы есеп береді.
Ескерту	Қателер мен ескерту оқиғалары туралы есеп береді.
Ақпарат	Қателер, ескертулер мен ақпарат оқиғалары туралы есеп береді.
Көп сөзді	Қателер, ескертулер, ақпарат пен толық оқиғалар туралы есеп береді.
ActivityTracing	Қателер, ескертулер, ақпарат пен толық оқиғалар және әрекетті қадағалау (әдіс атаулары) туралы есеп береді. Ескертпе: Белсенділікті трактату тек кейбір дереккөздерде ғана қолжетімді.
Барлық	Жүйемен қосылған барлық оқиғалар туралы есеп береді.

Диагностикалық журнал тыңдаушылары

Диагностикалық журнал тыңдаушылары диагностикалық журналдың шығыс файлын файлдарға, оқиға журналына немесе басқа көздерге жеткізу үшін пайдаланылады. Әдепкі бойынша барлық диагностикалық көздер әдепкі (түзетуші) және файл (мәтіндік) тыңдаушылармен байланысқан. Бірыңғай қызмет көрсету үстелі үшін диагностикалық журнал жүргізу үшін қосымша журнал тыңдаушыларды конфигурациялауға болады. .NET әдепкі тыңдаушылар туралы қосымша ақпарат алу үшін келесіні көріңіз:

• MSDN:DefaultTraceListener

• MSDN:EventLogTraceLister

• MSDN:TextWriterTraceLister

  Сонымен қатар диагностикалық журналдарды сіз таңдаған орынға жіберу үшін реттелмелі тыңдаушыларды жасауға болады. Реттелетін тыңдаушылар MSDN:TraceListener абстрактілі класынан сынып алу арқылы құрылады. Процестің серуендеуін CodeGuru.com сайтынан табуға болады.

Диагностикалық журнал файлын қарау

Әдепкі бойынша, «Бірыңғай қызмет үстелі» клиенттік бағдарламасы үшін диагностикалық журнал жүргізу іске қосылады. Клиенттік бағдарламадағы жедел қателерді жазу үшін клиенттік компьютерде «<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 бақылау процесі

Бірыңғай қызмет үстелін бақылау процесі (usdmp.exe) — Бірыңғай қызмет үстелінің жұмыс істеуін үздіксіз бақылайтын және әдетте 5 секундтан кейін жауап бермейтін және Бірыңғай қызмет үстелінің жауапсыз болуына себеп болатын кез келген браузер процесінің нұсқаларын тоқтататын қызмет. Егер браузер процесінің нұсқасы жауап бермесе, бірақ Бірыңғай қызмет үстелі жауап берсе, браузер процесінің данасы тоқтатылмайды. Браузер процесін тоқтатуға арналған ProcessTerminationThresshold жаһандық опциясының ұзақтығын өзгерту әдісі туралы қосымша ақпаратты Бірыңғай қызмет үстелі параметрлерін басқару бөлімінен қараңыз.

Қатені диагностикалау есептері

Құрамдас, бағдарлама немесе жүйе қатесінде орын алатын толық және кешенді тіркеудің және есептердің болуы қатенің қашан және қалай орын алғанын анықтауға көмектеседі. Стандартты диагностикалық кесуден басқа, Бірыңғай қызмет көрсету үстелінің клиентінде ерекшелік болған жағдайда қателіктерді диагностикалау туралы есеп беру жүйесі және қосымшаның мемлекеттік ақпараты. Ерекшеліктер туралы қосымша ақпаратты Бірыңғай қызмет үстелі бағдарламамен және жүйелік қателермен жұмыс істеу әдісінен табуға болады.

Ерекшелік кезінде жасалған қалталар мен файлдар

Ерекшелік болған жағдайда қате диагностикасы туралы есеп жергілікті компьютерде DiagnosticsLogs_date және time деп аталатын қалта жасайды, онда күн мен уақыт DiagnosticLogs_20170322_173643 сияқты жыл-ай-date_time түрінде болады. DiagnosticsLogs қалтасында мына қалта мен файлдар жасалады.

Диагностикалау файлы	Сипаттама
UnifiedServiceDesk_.log	Бірыңғай қызмет көрсету үстелі клиенті жұмыс істеп тұрғанда жасалатын және қосымшаланатын стандартты диагностика журналы. Файлда Бірыңғай қызмет көрсету үстелі клиентіне (UnifiedServiceDesk.exe) арналған журнал жүргізу ақпараты бар. Ағымдағы файлдар ерекшелік болған жағдайда DiagnosticsLogs қалтасына жылжытылады.
UnifiedServiceDeskMonitoring_.log	Бірыңғай қызмет көрсету үстелі клиенті жұмыс істеп тұрғанда жасалатын және қосымшаланатын стандартты диагностика журналы. Бірыңғай қызмет көрсету үстелі клиентінің жұмыс қабілеттілігін бақылайтын процесс болып табылатын Бірыңғай қызмет үстелі (usdmp.exe) бақылау процесі үшін журнал жүргізу туралы ақпаратты қамтиды. Ағымдағы файлдар ерекшелік болған жағдайда DiagnosticsLogs қалтасына жылжытылады. Қосымша ақпарат: Бірыңғай қызмет үстелін бақылау процесі
Eventlogs (қалта)	Ауыр немесе ауыр емес ерекшелік жағдайында жасалатын қалта. Windows жүйесі мен бағдарлама оқиғасының журналдарын және қате есептерінің мәтіндік файлдарын қамтиды.
ExitReport.txt	Ауыр немесе ауыр емес ерекшелік жағдайында жасалатын шығу журналы. Машина атауы, Бірыңғай қызмет үстелі нұсқасы, процесс идентификатқышы, шығу коды және шығу уақыты сияқты процесстік мемлекеттік ақпаратты қамтиды.
MachineHealthReport.txt	Ауыр немесе ауыр емес ерекшелік жағдайында жасалатын шығу журналы. Компьютер процессоры, операциялық жүйе, монитор деректері, тіл мен шолғыш нұсқасы сияқты жүйе күйінің мәліметтерін қамтиды.
ProcessReport.csv	Ауыр немесе ауыр емес ерекшелік жағдайында жасалатын шығу журналы. Ерекшелік уақытында жүйеде іске қосылған барлық процестердің кешенді тізімін ұсынады.
RegistryLog.txt	Ауыр немесе ауыр емес ерекшелік жағдайында жасалатын шығу журналы. Windows Registry ішкі субкилерінің мәтінге негізделген көшірмесін қамтиды Internet Explorer.
UnifiedServiceDesk_processId_CrashDump_.dmp	Өңделмеген ауыр ерекшелік жағдайында немесе ManualDumpShortcut глобалдық параметрдің пернелер тіркесімі арқылы қолмен шақырылған кезде ғана жасалады. UnifiedServiceDesk.exe үшін толық жадтың дамп файлын қамтамасыз етеді. Үйінді файлын қарау үшін қажет немесе басқа Windows демпинг файлын көру құралы қажет Visual Studio екенін байқаңыз.

Қатені диагностикалау есептерін реттеу

1. Unified Service Desk әкімші жүйесіне кіріңіз.

2. Қосымша параметрлер бөлімінің астындағы Аудит және диагностика тармағын таңдаңыз.

3. Жаңа+ параметрін таңдап , Диагностикалық конфигурация тармағын таңдаңыз .

4. Бақылау, шығуды бақылау және диагностика журналдары қалтасының орны сияқты қажетті мәндерді таңдаңыз немесе енгізіңіз. Қосымша ақпарат: Diagnostics

5. Сақтау және жабу пәрменін таңдаңыз.

Келесіні де қараңыз:

Аудит пен диагностиканы Бірыңғай қызмет үстелінде конфигурациялау

Ақауларды жою үшін Бірыңғай қызмет үстеліндегі қолдауды жою

Бірыңғай қызмет көрсету үстеліндегі ақауларды ажырату