Hogyan konfigurálhatja a kliens diagnosztikai naplózását

Cikk
03/07/2022
8 perc alatt elolvasható

Két módon konfigurálható a Unified Service Desk ügyfél diagnosztikai naplózás:

Audit és diagnosztikai beállítások bejegyzés használatával, amely a Microsoft Dataverse szolgáltatás Unified Service Desk területén hozható létre és kezelhető.
A UnifiedServiceDesk.exe.config fájl manuális módosításával.. Majd ezt a fájlt kell eljuttatni minden asztalra, amelyen Unified Service Desk ügyfél diagnosztikai naplózást szeretne..

Ezenkívül beállíthatja diagnosztikai naplózást a(z) Unified Service Desk-kliens esetében előforduló kivételekhez.

Unified Service Desk kliens diagnosztikai naplózásának beállítása

Ez a szakasz leírja, hogyan konfigurálhatja kézzel a diagnosztikai naplózást a(z) Unified Service Desk szolgáltatásban. Az itt leírt eljárás használata helyett az Audit és diagnosztikai beállítások szolgáltatását ajánljuk, amely lehetővé teszi a diagnosztika központosított felügyeletét és egy egyedi figyelőhöz való csatlakozást. További információ: Naplózás és diagnosztika konfigurálása a Unified Service Desk programban

Fontos

A manuálisan konfigurált diagnosztika (az itt leírtak szerint) nem működik azt követően, hogy engedélyezett egy diagnosztikára konfigurált Audit és diagnosztikai beállítások bejegyzést.
A(z) Unified Service Desk továbbá API-t biztosít, amivel változatos diagnosztikai naplózást végezhet egyedi központi vezérlőkön. További információ: Bővített diagnosztikai naplók konfigurálása egyedi központi vezérlőkhöz

Ez a témakör leírja, hogyan változtathatja meg az ügyfél-naplózás tulajdonságait.

A naplózást a UnifiedServiceDesk.exe.config fájllal engedélyezheti, amely megtalálható az Unified Service Desk kliens telepítési könyvtárában a számítógépen. Konfigurálhatja a naplózás típusát és az Unified Service Desk naplófájl helyét:

Nyissa meg az UnifiedServiceDesk.exe.config fájlt szerkesztésre. Ha az Unified Service Desk klienst az alapértelmezett helyen telepítette, ez a fájl általában a C:\Program Files\Microsoft Dynamics 365 Customer Engagement USD\USD helyen lesz elérhető.

Keresse meg a fájl <switches> szekcióját:

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

A <switches> szakaszban adja meg a naplózási forrást (például EventTopicSwitch), majd adja meg a naplózási szint értéket (például Error). A <switches> szakasz szabályozza a különféle források naplózási szintjeit. Alapértelmezés szerint a hibanaplózás engedélyezve van minden kapcsoló számára.
- A rendelkezésre álló naplózási forrásokkal kapcsolatos tudnivalókért lásd később a Rendelkezésre álló naplózási források fejezetet.
- A naplózási források értékeinek megadásával kapcsolatos tudnivalókért lásd később a Naplózási szintek fejezetet.

A naplófájlok helye, a maximális fájlméret és a váltási viselkedés megadásához keresse meg a fájl <shareListeners> szakaszát.

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

A <sharelisteners> szakasz meghatározza az Unified Service Desk számára létrehozott naplók helyét és típusát. Alapértelmezés szerint a fileListener létrehoz egy UnifiedServiceDesk.log nevű fájlt a c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> könyvtárban, és a USDDebugListener eseményeket hoz létre a Debug-kimenet lapon a hibakereső központi vezérlőben.

Ha meg szeretné változtatni a UnifiedServiceDesk.log fájl helyét, módosítsa a Location paraméter értékét.
Alapértelmezetten egy új Unified Service Desk-napló jön létre, miután az aktuális naplófájl mérete meghaladja az 52,42 MB-ot. Alapértelmezés szerint legfeljebb 10 naplófájl karbantartása történhet egy időben, mielőtt a legrégebbi naplófájlt törli a rendszer.
- A(z) Unified Service Desk-naplófájl maximális méretének módosításához módosítsa a MaxFileSize paraméter bájtban megadott méretét.
- A legrégibb naplófájl törlése előtt karbantartott naplófájlok számának módosításához módosítsa a MaxFileCount paraméter értékét. Ha nulla (0) értéket alkalmaz, akkor a váltási naplózást kikapcsolja a rendszer, és minden Unified Service Desk-kliens naplófájlját elmenti a rendszer.
Alapértelmezés szerint a fájl és a hibakereső naplózás is engedélyezve van az összes forrás számára. Ha hozzá szeretne adni vagy el szeretne távolítani egy figyelőt diagnosztikai forrásból, keresse meg a szükséges forrást a <sources> szakaszban, és módosítsa a forrás <listeners> szakaszát úgy, hogy beilleszti a kívánt figyelőt.

Például az eseménynaplózás hozzáadásához az Unified Service Desk alkalmazáshoz, adja hozzá az eseménynaplózási figyelőt a Microsoft.Crm.UnifiedServiceDesk forráshoz.
```
<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>  
```
Ez jelenteni fogja az eseményeket a fájlnak, a hibakeresőnek és a Windows eseménynaplónak „USD” címkével. A diagnosztikai figyelőkkel kapcsolatos további információkért lásd: Diagnosztikai naplófigyelők az útmutató későbbi részében.

Diagnosztikai naplóforrások

A következő táblázatban találhatóak az általános hibaelhárítási naplóforrások.

Forrás neve	Leírás
EventTopicSwitch	Részletes User Interface Integration (UII) naplózási forrás az UII belső üzenetküldő forgalmának figyelésére.
Microsoft.Uii.Common.Logging	Általános UII naplóforrás az UII által jelentett hibaüzenetekhez.
Microsoft.Xrm.Tooling.CrmConnectControl	Naplóforrás a bejelentkezési folyamathoz: Ez a forrás általános vagy részletes diagnosztikai információkat küld a bejelentkezési eljárásról.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Naplóforrás az összes adatszintű Dataverse interakcióhoz. Ez a forrásból minden interakciót jelent Dataverse rendszerrel kapcsolatban, továbbá a kivételeket és az időzítéseket.
Microsoft.Xrm.Tooling.WebResourceUtility	Naplóforrás a webes erőforrás adatainak kérelmeihez a Dataverse interfész-hivatkozáson keresztül.
Microsoft.Crm.UnifiedServiceDesk	Naplóforrás az Unified Service Desk fő funkcióihoz. Ez a naplóforrás olyan műveletekről és eseményekről fogl jelenteni, amelyek alapvetőek az Unified Service Desk rendszerben.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Naplóforrás a Unified Service Desk rendszerindításához és a processzor betöltéséhez. Ez a forrás fog jelenteni az olyan műveletekről és eseményekről, amelyek részei a UII és a Unified Service Desk indításának és inicializálásának.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	Naplóforrás olyan műveletekhez, amelyek együttműködnek a UserProfile rendszerrel; ez része a gyorsítótárazó rendszernek. További információ: Ügynökalkalmazás ügyfél-gyorsítótárának konfigurálása

Ezen naplóforrások között egymástól függetlenül váltogathat annak érdekében, hogy támogassa a hibaelhárítást és a problémák vagy információk elkülönítésére az Unified Service Desk rendszeren belül.

Diagnosztikai naplózási szintek

Több különálló naplózási szint is használható. Azonban naplózási szint növelésével, egyre több adat kerül generálásra és tárolásra a naplófájlokban.

Naplózási szint	Leírás
Kikapcsolva	Letiltja az ebből a forrásból származó összes eseményt.
Hiba	Csak a hibaeseményeket jelenti.
Figyelmeztetés:	Hibák és figyelmeztetések jelentése.
Információ	Jelzi a hibákat, a figyelmeztetéseket és az információs eseményeket.
Részletes	Jelzi a hibákat, a figyelmeztetéseket, az információkat és részletes eseményeket.
ActivityTracing	Jelenti a hibákat, a figyelmeztetéseket, az információkat, a részletes eseményeket és tevékenységek nyomkövetését (metódus nevek). Megjegyzés: Az ActivityTracing csak néhány forrás esetén érhető el.
Összes	A rendszer által kiváltott minden eseményt jelenti.

Diagnosztikai naplófigyelők

A diagnosztikai naplófigyelők segítségével megcélozhatja a diagnosztikai naplók kimeneti fájljait, az eseménynaplót vagy más forrásokat. Alapértelmezés szerint az összes diagnosztikai forrás hozzá van kötve az alapértelmezett (Debugger), és a fájlfigyelőkhöz (szöveges). Beállíthat további naplófigyelőket az Unified Service Desk rendszeren belüli diagnosztikai naplózáshoz. A .NET alapértelmezett figyelőivel kapcsolatos további információkért lásd:

MSDN:DefaultTraceListener
MDSN:EventLogTraceListener
MSDN:TextWriterTraceListener

Egyéni figyelőket is létrehozhat, ha a diagnosztikai naplókat egy választott helyre szeretné küldeni. Az egyéni figyelők egy osztály származtatásából jönnek létre az MSDN:TraceListener absztrakt osztályból. A folyamat egy forgatókönyve megtalálható a CodeGuru.com oldalon.

A diagnosztikai naplófájl megtekintése

Alapértelmezés szerint a diagnosztikai naplózás engedélyezve van az Unified Service Desk ügyfélalkalmazás számára. Egy naplófájl, a UnifiedServiceDesk-<date>.log, elérhető a c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> mappában a működési hibák rögzítéséhez az ügyfélalkalmazásban. A naplófájl akkor jön létre, amikor először merülnek fel problémák az ügyfélalkalmazásban.

Hiba esetén a központi vezérlő az információt a naplófájlokban naplózza, amelyek részletes információkat tartalmaznak a kivételről, például azt a központi vezérlőt, amely a kivétel oka a kivétel részleteivel együtt. Figyelje meg, hogy a kivételt okozó teljes JavaScript-kódot nem naplózta a rendszer. Csak a hibás kód és a kivétel leírása kerül naplózásra.

Íme egy minta kivétel naplózott részletei.

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

A Unified Service Desk felügyeleti folyamata

A(z) Unified Service Desk felügyeleti folyamat (usdmp.exe) olyan szolgáltatás, amely folyamatosan figyelemmel kíséri a(z) Unified Service Desk állapotát, és alapértelmezés szerint 5 másodperc után bezár minden olyan böngészőfolyamat-példányt, amely nem válaszol, és azt okozza, hogy a(z) Unified Service Desk sem válaszol. Ha egy böngésző folyamatpéldány nem válaszol, de a Unified Service Desk rendben fut, a böngészőfolyamati példány nem lesz leállítva. További információért a ProcessTerminationThreshold globális beállítás hosszának módosításáról böngészőfolyamatok leállításának esetében tekintse meg a következőt: A Unified Service Desk beállításainak kezelése.

Hibadiagnosztikai jelentés

A részletes és átfogó naplózás és jelentéskészítés összetevő, alkalmazás vagy rendszerhiba esetén segíthet meghatározni, hogy hol és hogyan történt a hiba. A szabványos diagnosztikai naplózáson kívül hibadiagnosztikai jelentési bejegyzésrendszer és az alkalmazás állapotának adatai a(z) Unified Service Desk-ügyfélkivétel esetén. További információt a kivételekről itt talál: Hogyan kezeli a Unified Service Desk az alkalmazás- és rendszerhibákat?.

Kivétel során létrejött mappák és fájlok

Kivétel esetében a hibadiagnosztikai jelentés létrehoz a helyi számítógépen egy DiagnosticsLogs_ dátum és időpont nevű mappát, ahol a dátum és az időpont év-hónap-nap_időpont formátumban van megadva, például DiagnosticLogs_20170322_173643. A DiagnosticsLogs mappában az alábbi mappák és fájlok jönnek létre.

Diagnosztikai fájl	Leírás
UnifiedServiceDesk_ dátumésidő.log	Szabványos diagnosztikai naplófájlt hoz létre a rendszer és fűzi hozzá ezekhez, amikor a(z) Unified Service Desk-kliens fut. A fájl a(z) Unified Service Desk-kliens (UnifiedServiceDesk.exe) naplózási adatait tartalmazza. Kivétel esetén az aktuális fájlokat a DiagnosticsLogs mappába helyezi át a rendszer.
UnifiedServiceDeskMonitoring_ dátum.log	Szabványos diagnosztikai naplófájlt hoz létre a rendszer és fűzi hozzá ezekhez, amikor a(z) Unified Service Desk-kliens fut. A(z) Unified Service Desk ellenőrző folyamat (usdmp.exe) naplózási adatait tartalmazza, amelyek egy olyan folyamat, amely a(z) Unified Service Desk-kliens állapotát figyeli. Kivétel esetén az aktuális fájlokat a DiagnosticsLogs mappába helyezi át a rendszer. További információ: A Unified Service Desk felügyeleti folyamata
Eventlogs (mappa)	Végzetes vagy nem végzetes kivétel esetén létrehozott mappa. Tartalmazza a Windows rendszer és az alkalmazás eseménynaplóit és a hibajelentési szövegfájlokat.
ExitReport.txt	Végzetes vagy nem végzetes kivétel esetén létrehozott kilépési napló. A folyamat állapotinformációit tartalmazza, például a számítógép nevét, a(z) Unified Service Desk verziót, a folyamatazonosítót, a kilépési kódot és a kilépés időpontját.
MachineHealthReport.txt	Végzetes vagy nem végzetes kivétel esetén létrehozott kilépési napló. A rendszer állapotadatait tartalmazza, például a számítógép processzorát, az operációs rendszert, a monitor részleteit, a nyelvet és a böngészőverziót.
ProcessReport.csv	Végzetes vagy nem végzetes kivétel esetén létrehozott kilépési napló. A kivétel időpontjában a rendszeren futó folyamatok átfogó listáját adja meg.
RegistryLog.txt	Végzetes vagy nem végzetes kivétel esetén létrehozott kilépési napló. A Windows rendszerleíró alkulcsok szöveges másolatát tartalmazza a(z) Internet Explorer programhoz.
UnifiedServiceDesk_processId_CrashDump_ dátumésidőpont.dmp	Csak nem kezelt végzetes kivétel esetén vagy a ManualDumpShortcut globális beállítás billentyűzetkombinációja segítségével történő kézi indítás során jön létre. Teljes memóriaképet biztosít a UnifiedServiceDesk.exe fájlhoz. Vegye figyelembe, hogy a képfájl megtekintéséhez Visual Studio vagy más Windows-képfájlmegtekintő eszköz szükséges.

Hibadiagnosztikai jelentés konfigurálása

Bejelentkezés a Unified Service Desk rendszergazda szolgáltatásba.
Válassza a Naplózás és diagnosztika elemet a Speciális beállítások területen.
Kattintson az +Új gombra, majd válassza ki a DiagnosticsConfiguration lehetőséget.
Válassza ki vagy írja be a kívánt értékeket, például a nyomon követést, kilépés figyelést és a diagnosztika bejelentkezési mappa helyének értékeit. További információ: Diagnosztika
Válassza a Mentés és bezárás lehetőséget.

Kapcsolódó információk

Naplózás és diagnosztika konfigurálása az egységes ügyfélszolgálatban

Hibakeresési támogatás a Unified Service Desk programban hibakeresésre

Hibakeresési problémák a Unified Service Desk szolgáltatásban

Megjegyzés

Megosztja velünk a dokumentációja nyelvi preferenciáit? Rövid felmérés elvégzése. (ne feledje, hogy ez a felmérés angol nyelvű)

A felmérés elvégzése körülbelül hét percet vesz igénybe. Semmilyen személyes adatot nem gyűjtünk (adatvédelmi nyilatkozat).