Kako lahko konfigurirate diagnostično pisanje dnevnika odjemalca

Diagnostično beleženje dnevnika odjemalca Unified Service Desk lahko konfigurirate na dva načina:

• Z zapisom nastavitev nadzora in diagnostike, ki je ustvarjen in upravljan v območju Unified Service Desk na spletnem mestu Microsoft Dataverse.

• z ročnim vnašanjem sprememb v datoteko UnifiedServiceDesk.exe.config. To datoteko morate nato distribuirati na vsako namizje, kjer želite diagnostično beleženje diagnostičnega dnevnika odjemalca Unified Service Desk.

  Poleg tega lahko diagnostično pisanje dnevnika konfigurirate posebej za izjeme, do katerih lahko pride v odjemalcu Unified Service Desk.

Konfiguracija diagnostičnega pisanja dnevnika odjemalca Unified Service Desk

V tem razdelku je opisano, kako ročno konfigurirate diagnostično pisanje dnevnika v Unified Service Desk. Namesto uporabe tukaj opisanega postopka priporočamo uporabo funkcije nastavitve spremljanja sprememb in diagnostike, ki omogoča centralizirano skrbništvo diagnostike in možnost povezave poslušalca po meri. Več informacij: Konfiguracija nadzora in diagnostike v rešitvi Unified Service Desk

Pomembno

• Ko omogočite zapis nastavitev spremljanja sprememb in diagnostike, ki je konfiguriran za diagnostiko, bo ročno konfigurirana diagnostika (kot je opisano tukaj) prenehala delovati.
• Unified Service Desk ponuja tudi API, ki vam omogoča konfiguracijo obogatenega diagnostičnega pisanja dnevnika za gostujoče kontrolnike po meri. Več informacij: Konfiguracija izboljšanega diagnostičnega pisanja dnevnika za gostujoče kontrolnike po meri

Ta tema opisuje, kako spremeniti lastnosti odjemalskega pisanja dnevnika.

Omogočite lahko pisanje dnevnika z datoteko UnifiedServiceDesk.exe.config , ki je na voljo v namestitvenem imeniku odjemalca Unified Service Desk v računalniku. Če želite konfigurirati vrsto pisanja dnevnika in mesto dnevniške datoteke Unified Service Desk:

1. Odprite datoteko UnifiedServiceDesk.exe.config za urejanje. Če ste odjemalca Unified Service Desk namestili na privzeto mesto, bo ta datoteka po navadi na voljo na spletnem mestu C:\Program Files\365 Customer Engagement USD\Microsoft Dynamics USD.

2. Pojdite na <switches> razdelek v datoteki:

   <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. V <switches> razdelku določite vir pisanja dnevnika (na primer) in nato določite vrednost ravni pisanja dnevnika (na primer EventTopicSwitchError). Razdelek <switches> nadzoruje ravni pisanja dnevnika za različne vire. Pisanje dnevnika napak je privzeto omogočeno za vsa stikala:

   • Če želite informacije o razpoložljivih virih pisanja dnevnikov, glejte Razpoložljivi viri dnevnika v nadaljevanju tega tema.

   • Če želite informacije o vrednostih, ki jih lahko določite za posamezen vir pisanja dnevnika, glejte Ravni pisanja dnevnika pozneje v tem tema.

4. Če želite konfigurirati mesto, največjo velikost datoteke in vedenje dnevniških datotek pri prevračanju, pojdite na <shareListeners> razdelek v datoteki.

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

   Razdelek <sharelisteners> nadzoruje mesto in vrsto dnevnikov, ki se ustvarijo za Unified Service Desk. Privzeto fileListener bo v imeniku ustvaril datoteko, imenovano UnifiedServiceDesk.logc:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> in USDDebugListener ustvaril dogodke na izhodnem zavihku za odpravljanje napak v gostujočem kontrolniku Debugger.

5. Če želite spremeniti lokacijo datoteke UnifiedServiceDesk.log spremenite vrednost Location parametra.

6. Privzeto se ustvari nov dnevnik rešitve Unified Service Desk, ko velikost datoteke trenutne dnevniške datoteke preseže 52,42 MB. Privzeto se hkrati vzdržuje do 10 dnevniških datotek, preden je najstarejša dnevniška datoteka izbrisana.

   • Če želite spremeniti največjo velikost dnevniške datoteke Unified Service Desk, spremenite vrednost parametra MaxFileSize v bajtih .

   • Če želite spremeniti število dnevnikov, ki se ohranijo pred izbrisom najstarejšega dnevnika, spremenite vrednost parametra MaxFileCount . Če uporabljate nič (0), bo pisanje dnevnika prevračanja onemogočeno in vsi ustvarjeni dnevniki odjemalca rešitve Unified Service Desk bodo shranjeni.

7. Pisanje dnevnika datoteke in iskalnika napak je privzeto omogočeno za vse vire. Če želite dodati ali odstraniti poslušalca iz diagnostičnega vira, poiščite želeni vir v <sources> razdelku in nato spremenite <listeners> razdelek vira, da bo vključeval želenega poslušalca.

   Če želite na primer dodati beleženje dogodkov za Unified Service Desk, dodajte poslušalca dnevnika dogodkov v dnevnik viru 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>  
   

   To bo zdaj poročalo o dogodkih v dnevnik dogodkov sistema Windows z oznako "USD", poleg datoteke in iskalnika napak. Če želite več informacij o poslušalcih diagnostike, glejte Poslušalci diagnostičnega dnevnika v nadaljevanju tega tema.

Viri diagnostičnih dnevnikov

V naslednji tabeli so navedeni pogosti viri dnevnikov odpravljanja težav.

Ime vira	Description
EventTopicSwitch	Vir dnevnika za podrobno integracijo uporabniškega vmesnika (UII) za spremljanje prometa sporočil znotraj uporabniškega vmesnika.
Microsoft.Uii.Common.Logging	Splošen vir dnevnika programa UII za sporočila, ki jih posreduje UII.
Microsoft.Xrm.Tooling.CrmConnectControl	Vir dnevnika za proces vpisa. Ta vir bo posredoval splošne ali podrobne diagnostične informacije o proceduri vpisa.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Vir dnevnika za vse interakcije na ravni podatkov programa Dataverse. Ta vir bo posredoval vse interakcije s programom Dataverse, izjeme in časovne razporeditve.
Microsoft.Xrm.Tooling.WebResourceUtility	Vir dnevnika za zahteve za podatke spletnega vira prek povezave vmesnika programa Dataverse.
Microsoft.Crm.UnifiedServiceDesk	Vir dnevnika za osnovne funkcije rešitve Unified Service Desk. Ta vir dnevnika bo poročal o dejanjih in dogodkih, ki so osnovna za rešitev rešitve Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Vir dnevnika za zagonski trak in nalagalni procesor Unified Service Desk. Ta vir bo poročal o dejanjih in dogodkih, ki so del inicializacije in zagona uporabniškega vmesnika in rešitve Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	Vir dnevnika za dejanja, ki komunicirajo s sistemom uporabniškega profila. To je del sistema predpomnjenja. Več informacij: Konfiguracija predpomnjenja odjemalca za program posrednika

Vsak od teh virov dnevnika lahko preklapljate neodvisno, da podprete odpravljanje težav in osamitev težav ali informacij v rešitvi Unified Service Desk.

Ravni diagnostičnega pisanja dnevnika

Na voljo je več različnih ravni pisanja dnevnika. S tem, ko povečate raven pisanja dnevnikov, pa se ustvari in v dnevniških datotekah shrani več podatkov.

Raven dnevnika	Opis
Izklopljeno	Onemogoči vse dogodke iz tega vira.
Napaka	Posreduje le dogodke napak.
Opozorilo	Posreduje dogodke napak in opozoril.
Informacije	Posreduje dogodke napak, opozoril in informacij.
Podrobno	Posreduje dogodke napak, opozoril, informacij in podrobnosti.
ActivityTracing	Posreduje dogodke napak, opozoril, informacij in podrobnosti ter sledenje dejavnosti (imena metod). Opomba: ActivityTracing je na voljo le v nekaterih virih.
Vsa	Posreduje vse dogodke, ki jih sproži sistem.

Poslušalci diagnostičnih dnevnikov

Poslušalci diagnostičnih dnevnikov se uporabljajo za ciljno iskanje rezultata diagnostičnih dnevnikov v datotekah, dnevniku dogodkov in drugih virih. Vsi diagnostični viri so privzeto povezani tako s privzetimi poslušalci (iskalnik napak) kot s poslušalci datotek (besedila). Dodatne poslušalce dnevnika lahko konfigurirate za diagnostično pisanje dnevnika za Unified Service Desk. Če želite več informacij o privzetih poslušalcih .NET, glejte:

• MSDN:DefaultTraceListener

• MSDN:EventLogTraceListener

• MSDN:TextWriterTraceListener

  Ustvarite lahko tudi poslušalce po meri za pošiljanje diagnostičnih dnevnikov na lokacijo, ki jo izberete. Poslušalci po meri so ustvarjeni z izpeljavo razreda iz abstraktnega razreda MSDN:TraceListener . Navodila o postopku najdete na CodeGuru.com.

Ogled diagnostične dnevniške datoteke

Dnevnik diagnostike je privzeto omogočen za odjemalski program Unified Service Desk. V odjemalskem računalniku je na voljo dnevniška datoteka UnifiedServiceDesk-date<>.log za beleženje operativnih napak v odjemalski aplikaciji. c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> Dnevniška datoteka se ustvari, ko prvič naletite na napako v odjemalskem programu.

V primeru napake gostujočega kontrolnika se v dnevniške datoteke zabeležijo podrobne informacije o izjemi, na primer informacije o izvornem gostujočem kontrolniku, ki je povzročil izjemo, skupaj s podrobnostmi o izjemi. Upoštevajte, da se ne zabeleži celotna koda JavaScript, ki je povzročila izjemo. Zabeleži se samo koda z napako skupaj z opisom izjeme.

V nadaljevanju je primer zabeleženih podrobnosti izjeme.

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

Proces spremljanja rešitve Unified Service Desk

Proces nadzora rešitve Unified Service Desk (usdmp.exe) je storitev, ki neprekinjeno nadzoruje stanje rešitve Unified Service Desk in po 5 sekundah privzeto prekine vse primerke obdelave brskalnika, ki se ne odzivajo in zaradi katerih se Unified Service Desk preneha odzivati. Če se primerek procesa brskalnika ne odziva, Unified Service Desk pa se odziva, primerek procesa brskalnika ne bo ukinjen. Če želite več informacij o tem, kako spremeniti trajanje globalne možnosti ProcessTerminationThreshold za zaključek procesa brskalnika, glejte Upravljanje možnosti za Unified Service Desk.

Poročanje o diagnostiki napak

Podrobno in celovito pisanje dnevnikov in poročanje, ko pride do napake komponente, programa ali sistema, omogoča lažje ugotavljanje, kdaj in kako se je napaka zgodila. Poleg standardnega beleženja diagnostike, diagnostike napak, zapisov poročanja, informacij o sistemu in stanju programa v primeru izjeme v odjemalcu rešitve Unified Service Desk. Več informacij o izjemah najdete v članku Kako Unified Service Desk obravnava napake programov in sistemov.

Mape in datoteke, ustvarjene med izjemo

V primeru izjeme poročanje o diagnostiki napak ustvari mapo v lokalnem računalniku z imenom DiagnosticsLogs_datum in ura, kjer sta datum in ura v obliki leta-mesec-date_time, na primer DiagnosticLogs_20170322_173643. Znotraj mape DiagnosticsLogs se ustvarijo naslednje mape in datoteke.

Diagnostična datoteka	Opis
UnifiedServiceDesk_datumin ura.log	Standardni dnevnik diagnostike, ki se ustvari in priloži, ko se izvaja odjemalec Unified Service Desk. V datoteki so informacije o pisanju dnevnika za odjemalca Unified Service Desk (UnifiedServiceDesk.exe). V primeru izjeme so trenutne datoteke premaknjene v mapo DiagnosticsLogs.
UnifiedServiceDeskMonitoring_datum.log	Standardni dnevnik diagnostike, ki se ustvari in priloži, ko se izvaja odjemalec Unified Service Desk. Vsebuje podatke o pisanju dnevnika za postopek nadzora rešitve Unified Service Desk (usdmp.exe), ki je proces, ki nadzoruje stanje odjemalca rešitve Unified Service Desk. V primeru izjeme so trenutne datoteke premaknjene v mapo DiagnosticsLogs. Več informacij: Postopek nadzora rešitve Unified Service Desk
Dnevniki dogodkov (mape)	Mape, ustvarjene v primeru resne ali manj resne izjeme. Vsebuje dnevnike dogodkov programa in sistema Windows ter besedilne datoteke s poročilom o napaki.
ExitReport.txt	Izhodni dnevnik, ustvarjene v primeru resne ali manj resne izjeme. Vsebuje informacije o stanju procesa, kot so ime naprave, različica rešitve Unified Service Desk, ID procesa, koda za izhod in čas izhoda.
MachineHealthReport.txt	Izhodni dnevnik, ustvarjene v primeru resne ali manj resne izjeme. Vsebuje informacije o stanju sistema, kot so procesor računalnika, operacijski sistem, podrobnosti zaslona, jezik in različica brskalnika.
ProcessReport.csv	Izhodni dnevnik, ustvarjene v primeru resne ali manj resne izjeme. Vsebuje celovit seznam vseh procesov, ki so se izvajali v sistemu v času izjeme.
RegistryLog.txt	Izhodni dnevnik, ustvarjene v primeru resne ali manj resne izjeme. Vključuje besedilno kopijo registrskih podključev sistema Windows za Internet Explorer.
UnifiedServiceDesk_processId_CrashDump_datumin ura.dmp	Ustvari se le v primeru neobravnavane resne izjeme ali ročnega priklica s kombinacijo tipk splošne možnosti ManualDumpShortcut. Ustvari datoteko za izvoz celotnega pomnilnika za UnifiedServiceDesk.exe. Če si želite ogledati izvozno datoteko, potrebujete Visual Studio drugo orodje za ogled izvoznih datotek sistema Windows.

Konfiguriranje poročanja o diagnostiki napak

1. Vpis v aplikacijo Unified Service Desk Administrator.

2. Izberite Nadzor in diagnostika pod možnostjo Dodatne nastavitve.

3. Izberite + novo in nato izberite DiagnosticsConfiguration.

4. Izberite ali vnesite vrednosti, ki jih želite, kot so sledenje, spremljanje izhoda in lokacija mape dnevnikov diagnostike. Več informacij: Diagnostika

5. Izberite Shrani in zapri.

Glejte tudi

Konfiguracija nadzora in diagnostike v rešitvi Unified Service Desk

Odpravljanje napak v podpori v rešitvi Unified Service Desk za odpravljanje težav

Težave z odpravljanjem napak v rešitvi Unified Service Desk