Kako lahko konfigurirate diagnostično pisanje dnevnika odjemalca

Članek
06/27/2024

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

Z uporabo Audit & Zapis diagnostičnih nastavitev, ki je ustvarjen in upravljan v območju Unified Service Desk Microsoft Dataverse.
z ročnim vnašanjem sprememb v datoteko UnifiedServiceDesk.exe.config. To datoteko je treba nato razdeliti na vsako namizje, kjer želite beleženje diagnostike odjemalca Unified Service Desk.

Poleg tega lahko konfigurirate diagnostično beleženje posebej za izjeme, ki se lahko pojavijo v odjemalcu Unified Service Desk.

Konfigurirajte diagnostično beleženje odjemalca Unified Service Desk

V tem razdelku je opisano, kako ročno konfigurirati diagnostično beleženje 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: Konfigurirajte nadzor in diagnostiko v 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 bogatega diagnostičnega beleženja za kontrolnike, ki gostujejo po meri. Več informacij: Konfigurirajte izboljšano diagnostično beleženje za kontrolnike, ki gostujejo po meri

Ta tema opisuje, kako spremeniti lastnosti odjemalskega pisanja dnevnika.

Beleženje lahko omogočite z datoteko UnifiedServiceDesk.exe.config , ki je na voljo v namestitvenem imeniku odjemalca Unified Service Desk v vašem računalniku. Če želite konfigurirati vrsto beleženja in lokacijo dnevniške datoteke Unified Service Desk:

Odprite datoteko UnifiedServiceDesk.exe.config za urejanje. Če ste odjemalca Unified Service Desk namestili na privzeto lokacijo, bo ta datoteka običajno na voljo na C:\Program Files\Microsoft Dynamics 365 Customer Engagement USD\USD.

Pojdite na razdelek <switches> 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>

V razdelku <switches> podajte vir beleženja (kot je EventTopicSwitch) in nato podajte vrednost ravni beleženja (kot je Error). Razdelek <switches> nadzira ravni beleženja za različne vire. Pisanje dnevnika napak je privzeto omogočeno za vsa stikala:
- Za informacije o razpoložljivih virih beleženja glejte Razpoložljivi viri dnevnika kasneje v tem tema.
- Za informacije o vrednostih, ki jih lahko določite za vsak vir beleženja, glejte Ravni beleženja kasneje v tem tema.

Če želite konfigurirati lokacijo, največjo velikost datoteke in obnašanje dnevniških datotek pri prevračanju, pojdite na razdelek <shareListeners> 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> nadzira lokacijo in vrsto dnevnikov, ki so ustvarjeni za Unified Service Desk. Privzeto fileListener bo ustvaril datoteko z imenom UnifiedServiceDesk.log v c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> imeniku in USDDebugListener bo ustvaril dogodke na izhodnem zavihku Debug kontrole, ki ga gosti Debugger.

Če želite spremeniti lokacijo datoteke UnifiedServiceDesk.log , spremenite vrednost parametra Location .
Ko velikost trenutne datoteke dnevnika preseže 52,42 MB, se privzeto ustvari nov dnevnik Unified Service Desk. Privzeto se hkrati vzdržuje do 10 dnevniških datotek, preden je najstarejša dnevniška datoteka izbrisana.
- Če želite spremeniti največjo velikost datoteke dnevnika Unified Service Desk, spremenite vrednost v bajtih parametra MaxFileSize .
- Če želite spremeniti število dnevnikov, ki se vzdržujejo, preden se izbriše najstarejši dnevnik, spremenite vrednost parametra MaxFileCount . Če se uporabi nič (0), bo beleženje preklapljanja onemogočeno in vsi ustvarjeni dnevniki odjemalca Unified Service Desk bodo shranjeni.
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 zahtevani vir v razdelku <sources> in nato spremenite <listeners> razdelek vira, da vključite poslušalca, ki ga želite.

Na primer, če želite dodati beleženje dogodkov za Unified Service Desk, dodajte poslušalca beleženja dogodkov v Microsoft.Crm.UnifiedServiceDesk vir.
```
<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 Windows z oznako "USD", poleg datoteke in razhroščevalnika. Za več informacij o diagnostičnih poslušalcih glejte Poslušalniki diagnostičnih dnevnikov kasneje v tem tema.

Viri diagnostičnih dnevnikov

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

Ime vira	Description
EventTopicSwitch	Vir beleženja podrobne integracije uporabniškega vmesnika (UII) za spremljanje prometa sporočil znotraj UII.
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 osnovno funkcionalnost Unified Service Desk. Ta vir dnevnika bo poročal o dejanjih in dogodkih, ki so bistveni za Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Vir dnevnika za zagonski trak in procesor za nalaganje Unified Service Desk. Ta vir bo poročal o dejanjih in dogodkih, ki so del inicializacije in zagona UII in 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: Konfigurirajte predpomnjenje odjemalca za vašo agentsko aplikacijo

Vsak od teh virov dnevnika lahko preklopite neodvisno, da podprete odpravljanje težav in izolacijo težav ali informacij znotraj 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 samo 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). Konfigurirate lahko dodatne poslušalce dnevnikov za diagnostično beleženje 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. Prisluškovalci po meri so ustvarjeni z izpeljavo razreda iz abstraktnega razreda MSDN:TraceListener . Predstavitev postopka najdete na CodeGuru.com.

Ogled diagnostične dnevniške datoteke

Diagnostično beleženje je privzeto omogočeno za odjemalsko aplikacijo Unified Service Desk. Dnevniška datoteka, UnifiedServiceDesk-<date>.log, je na voljo na c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> na odjemalski računalnik za beleženje operativnih napak v odjemalski aplikaciji. 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

Unified Service Desk Monitoring Process (usdmp.exe) je storitev, ki nenehno spremlja stanje Unified Service Desk in po 5 sekundah privzeto prekine vse primerke procesa brskalnika, ki se ne odzivajo in povzročijo, da se Unified Service Desk ne odziva. Če se primerek procesa brskalnika ne odziva, vendar je Unified Service Desk odziven, se primerek procesa brskalnika ne bo prekinil. Za več informacij o tem, kako spremeniti trajanje globalne možnosti ProcessTerminationThreshold za prekinitev 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 diagnostičnega beleženja poročanje o diagnostiki napak beleži podatke o sistemu in stanju aplikacije v primeru izjeme v odjemalcu Unified Service Desk. Več informacij o izjemah lahko najdete v Kako Unified Service Desk obravnava napake aplikacij in sistema.

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 čas, kjer sta datum in čas v obliki leto-mesec-datum_čas, kot je DiagnosticLogs_20170322_173643. Znotraj mape DiagnosticsLogs se ustvarijo naslednje mape in datoteke.

Diagnostična datoteka	Opis
UnifiedServiceDesk_datum in čas.log	Standardni diagnostični dnevnik, ki se ustvari in doda, ko se izvaja odjemalec Unified Service Desk. Datoteka vsebuje podatke o beleženju za odjemalca Unified Service Desk (UnifiedServiceDesk.exe). V primeru izjeme so trenutne datoteke premaknjene v mapo DiagnosticsLogs.
UnifiedServiceDeskMonitoring_datum.log	Standardni diagnostični dnevnik, ki se ustvari in doda, ko se izvaja odjemalec Unified Service Desk. Vsebuje podatke o beleženju za proces spremljanja Unified Service Desk (usdmp.exe), ki je proces, ki nadzira zdravje odjemalca Unified Service Desk. V primeru izjeme so trenutne datoteke premaknjene v mapo DiagnosticsLogs. Več informacij: Unified Service Desk Monitoring Process
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 stroja, različica Unified Service Desk, ID procesa, izhodna koda 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 podključev registra Windows za Internet Explorer.
UnifiedServiceDesk_processId_CrashDump_datum in čas.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. Upoštevajte, da za ogled datoteke izpisa potrebujete Visual Studio ali drugo orodje za ogled datoteke izpisa sistema Windows.

Konfiguriranje poročanja o diagnostiki napak

Vpis v aplikacijo Unified Service Desk Administrator.
Izberite Revizija in diagnostika pod Napredne nastavitve.
Izberite + Novo in nato izberite DiagnosticsConfiguration.
Izberite ali vnesite vrednosti, ki jih želite, kot so sledenje, spremljanje izhoda in lokacija mape dnevnikov diagnostike. Več informacij: Diagnostika
Izberite Shrani & Zapri.

Glejte tudi

Konfigurirajte nadzor in diagnostiko v Unified Service Desk

Podpora za odpravljanje napak v Unified Service Desk za odpravljanje težav

Težave z odpravljanjem napak v Unified Service Desk

Deli z drugimi prek