Hur du konfigurerar diagnostisk loggning av klient

Artikel
04/19/2023

Det finns två sätt att konfigurera en diagnostisk loggning av en Unified Service Desk-klient:

Med hjälp av en inställningspost för granskning och diagnostik som skapas och hanteras i Unified Service Desk-delen av Microsoft Dataverse.
Genom att göra ändringar manuellt i filen UnifiedServiceDesk.exe.config. Den här filen måste sedan distribueras till alla datorer där du vill ha diagnostisk loggning av Unified Service Desk-klienten.

Du kan också konfigurera diagnostikloggning specifikt för undantag som kan uppstå i Unified Service Desk-klienten.

Konfigurera diagnostisk loggning av klient i Unified Service Desk

Det här avsnittet beskriver hur du manuellt konfigurerar diagnostisk loggning i Unified Service Desk. I stället för att använda proceduren som beskrivs här, rekommenderar vi att du använder funktionen Inställningar för granskning och diagnostik som ger centraliserad administration av diagnostik och möjlighet att ansluta en anpassad lyssnare. Mer information: Konfigurera granskning och diagnostik i Unified Service Desk

Viktigt!

Den manuellt konfigurerade diagnostiken (som beskrivs här) fungerar inte längre när du har aktiverat en inställningspost för granskning och diagnostik som har konfigurerats för diagnostik.
Unified Service Desk tillhandahåller även ett API som gör att du kan konfigurera omfattande diagnostisk loggning för anpassade värdbaserade kontroller. Mer information: Konfigurera utökad diagnostisk loggning för anpassade värdbaserade kontroller

Det här avsnittet beskriver hur du ändrar egenskaperna för loggning av klienten.

Du kan aktivera loggningen med hjälp av filen UnifiedServiceDesk.exe.config, som finns i installationskatalogen för Unified Service Desk-klienten på datorn. Så här konfigurerar du typ av loggning och plats för Unified Service Desk-loggfilen:

Öppna filen UnifiedServiceDesk.exe.config för redigering. Om du har installerat Unified Service Desk-klienten på standardplatsen finns den här filen vanligtvis på C:\Program Files\Microsoft Dynamics 365 Customer Engagement USD\USD.

Gå till avsnittet <switches> i filen:

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

I avsnittet <switches> anger du en loggningskälla (t.ex. EventTopicSwitch) och sedan värdet för loggningsnivån (t.ex. Error). Avsnittet <switches> styr loggningsnivåerna för olika källor. Felloggningsfunktionen aktiveras som standard för alla växlar:
- Mer information om tillgängliga loggningskällor finns i Tillgängliga loggkällor senare i det här ämnet.
- Information om vilka värden som du kan ange för varje loggningskälla finns i loggningsnivåer senare i det här avsnittet.

Om du vill konfigurera plats, maximal filstorlek och förnyelsebettende för loggfilerna, gå till avsnittet <shareListeners> i filen.

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

Avsnittet <sharelisteners> styr plats och typ för de loggar som genereras för Unified Service Desk. Som standard skapar fileListener en fil som heter UnifiedServiceDesk.log i katalogen c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> och USDDebugListener skapar händelser på fliken fliken Felsökningsutdata i den värdbaserade kontrollen Felsökaren.

Om du vill ändra placeringen av filen UnifiedServiceDesk.log ändrar du värdet för parametern Location.
Som standard skapas en ny Unified Service Desk-loggfil när den aktuella loggfilens storlek överskrider 52,42 MB. Som standard hålls upp till 10 loggfiler kvar på samma gång innan den äldsta loggfilen tas bort.
- Så här ändrar du maximal Unified Service Desk-loggfilstorlek genom att ändra värdet, i bytes, av MaxFileSize-parametern.
- Om du vill ändra antalet loggar som behållas innan de äldsta loggfilerna tas bort, ändrar du värdet för MaxFileCount-parametern. Om noll (0) används kommer förnyelseloggning att inaktiveras och alla skapade Unified Service Desk-klientloggar kommer att sparas.
Loggning av fil och felsökningsprogram är som standard aktiverad för alla källor. Om du vill lägga till eller ta bort en lyssnare från en diagnostisk källa letar du upp källan i avsnittet <sources> och ändrar sedan avsnittet <listeners> i källan så att den lyssnare som du vill ta med ingår.

Om du t.ex. vill lägga till händelseloggning för Unified Service Desk lägger du till lyssnaren för händelseloggning till Microsoft.Crm.UnifiedServiceDesk-källan.
```
<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>  
```
Detta kommer nu att rapportera händelser till Windows-händelseloggen med taggen "USD", tillsammans med filen och Felsökaren. Mer information om diagnostiska lyssnare finns i Diagnostiklogglyssnare senare i det här ämnet.

Diagnostikloggkällor

Vanliga källor för felsökningsloggen visas i följande tabell.

Källnamn	Description
EventTopicSwitch	Detaljerad User Interface Integration (UII) loggningskälla för övervakning av meddelandetrafik inom UII.
Microsoft.Uii.Common.Logging	Allmän UII-loggkälla för meddelanden som rapporterats av UII.
Microsoft.Xrm.Tooling.CrmConnectControl	Loggkälla för inloggningsprocessen. Den här källan rapporterar allmän eller detaljerad diagnostikinformation om inloggningsproceduren.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Loggkälla för alla Dataverse-interaktioner på datanivå. Den här källan kommer att rapportera alla interaktioner med Dataverse, undantag och tider.
Microsoft.Xrm.Tooling.WebResourceUtility	Loggkälla för webbresursdata via Dataverse-gränssnittslänken.
Microsoft.Crm.UnifiedServiceDesk	Loggkälla för Unified Service Desk-kärnfunktioner. Denna loggkälla rapporterar åtgärder och händelser som utgör kärnan i Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Loggkälla för startverktyg och inläsningsprocessor för Unified Service Desk. Denna källa rapporterar åtgärder och händelser som ingår i initieringen och starten av UII och Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	Loggkälla för åtgärder som samverkar med UserProfile-system. Detta är en del av cachelagringssystemet. Mer information: Konfigurera klienten cachelagring för Agentprogrammet

Du kan växla alla dessa loggkällorna oberoende av varandra för att ge stöd åt felsökning och isolering av problem eller information inom Unified Service Desk.

Diagnostikloggningsnivåer

Det finns flera olika loggningsnivåer för användning. Men när du ökar loggningsnivån skapas och sparas mer data i loggfilerna.

Loggningsnivå	Beskrivning
Av	Inaktiverar alla händelser från den här källan.
Fel	Rapporterar bara felhändelser.
Varning	Rapporterar fel- och varningshändelser.
Information	Rapporterar fel-, varnings- och informationshändelser.
Utförlig	Rapporterar fel-, varnings- och informationshändelser samt utförliga händelser.
ActivityTracing	Rapporterar fel, varningar, information och utförliga händelser och aktivitetsspårning (metodnamn). Obs! ActivityTracing är tillgänglig endast för några av källorna.
Alla	Rapporterar alla händelser som utlöses av systemet.

Diagnostiklogglyssnare

Diagnostiklogglyssnare används för att rikta diagnostikloggutdata till filer, händelseloggen eller andra källor. Som standard är alla diagnostiska källor kopplade både till standardlyssnare (Felsökare) och fillyssnare (text). Du kan konfigurera ytterligare logglyssnare för diagnostikloggning för Unified Service Desk. Mer information om .NET-standardlyssnare finns i:

MSDN:DefaultTraceListener
MSDN:EventLogTraceListener
MSDN:TextWriterTraceListener

Du kan också skapa anpassade lyssnare för att skicka diagnostikloggar till en plats du väljer själv. Anpassade lyssnare skapas genom att en klass ärvs från den abstrakta klassen MSDN:TraceListener. En genomgång av processen finns på CodeGuru.com.

Visa den diagnostiska loggfilen

Diagnostikloggning aktiveras som standard för Unified Service Desk-klientprogrammet. En loggfil, UnifiedServiceDesk-<date>.log, finns tillgänglig på c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> klientdatorn för registrering av operativa fel i klientprogrammet. Loggfilen skapas första gången du stöter på några fel i klientprogrammet.

När ett fel uppstår i en värdbaserad kontroll, innehåller information som loggas i loggfiler detaljerad information om undantaget, till exempel den värdbaserade källkontrollen som orsakade undantagsfelet och undantagsinformation. Lägg märke till att hela JavaScript-koden som orsakade undantaget inte är loggas. Endast den felaktiga koden och undantagsbeskrivning loggas.

Här är ett exempel på undantagsinformation som loggas.

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

Övervakningsprocessen (usdmp.exe) Unified Service Desk är en tjänst som kontinuerligt övervakar tillståndet för Unified Service Desk och avslutar som standard efter fem sekunder, alla instanser av webbläsarprocessen som inte svarar och gör att Unified Service Desk inte svarar. Om en webbläsarprocessinstans inte svarar, men Unified Service Desk svarar, webbläsarens processinstansen inte avslutas. Mer information om hur du ändrar varaktigheten för ProcessTerminationThreshold globala alternativ för avslutning av webbläsarprocess finns i Hantera alternativ för Unified Service Desk.

Feldiagnostikrapportering

Ha detaljerad och omfattande loggning och rapportering som uppstår under ett komponen-t, program- eller systemfel kan hjälpa till att identifiera när och hur felet inträffade. Förutom vanlig diagnostikloggning finns system för feldiagnostikrapporteringsposter och programlägesinformation om det uppstår ett undantag i Unified Service Desk-klienten. Mer information om undantag finns i Hur Unified Service Desk hanterar program- och systemfel.

Mappar och filer som skapas under ett undantag

Om det uppstår ett undantag skapar feldiagnostikrapportering en mapp på den lokala datorn med namnet DiagnosticsLogs_datum och tid, där datum och tid är i formatet år-månad-datum_tid, till exempel DiagnosticLogs_20170322_173643. Följande mapp och filer skapas i mappen DiagnosticsLogs.

Diagnostikfil	Beskrivning
UnifiedServiceDesk_dateandtime.log	Vanliga diagnostikloggfiler som skapas och läggs till när Unified Service Desk-klienten körs. Filen innehåller loggningsinformation för Unified Service Desk-klienten (UnifiedServiceDesk.exe). Aktuella filer flyttas till mappen DiagnosticsLogs i händelse av ett undantag.
UnifiedServiceDeskMonitoring_date.log	Vanliga diagnostikloggfiler som skapas och läggs till när Unified Service Desk-klienten körs. Innehåller loggningsinformation för Unified Service Desk-övervakningsprocessen (usdmp.exe), som är en process som övervakar tillståndet för Unified Service Desk-klienten. Aktuella filer flyttas till mappen DiagnosticsLogs i händelse av ett undantag. Mer information: Unified Service Desk övervakningsprocess
Händelseloggar (mapp)	Mappen skapas i händelse av ett allvarligt eller mindre allvarligt undantag. Innehåller Windows-system och programhändelselogg och felrapporteringstextfiler.
ExitReport.txt	Slutlogg som skapas i händelse av ett allvarligt eller mindre allvarligt undantag. Innehåller processtillståndsinformation som t.ex datornamn Unified Service Desk-version, process-id, slutkod och tid för avsluta.
MachineHealthReport.txt	Slutlogg som skapas i händelse av ett allvarligt eller mindre allvarligt undantag. Innehåller systemtillståndsinformation som t.ex. datorns processor, operativsystem, övervakningsinformation, språk och webbläsarversion.
ProcessReport.csv	Slutlogg som skapas i händelse av ett allvarligt eller mindre allvarligt undantag. Innehåller en lista över alla processer som utfördes i systemet vid tiden för undantaget.
RegistryLog.txt	Slutlogg som skapas i händelse av ett allvarligt eller mindre allvarligt undantag. Innehåller en textbaserad kopia av Windows-registerundernycklar för Internet Explorer.
UnifiedServiceDesk_processId_CrashDump_dateandtime.dmp	Skapa endast om det uppstår allvarliga undantag eller aktiveras manuellt genom att använda det globala alternativet för tangentbordskombination ManualDumpShortcut. Innehåller en fullständig minnesdump för UnifiedServiceDesk.exe. Lägg märke till om du vill läsa dumpfilen måste du ha Visual Studio eller något annat verktyg för visning av Windows-dumpfil.

Konfigurationsfeldiagnostikrapportering

Logga in på Unified Service Desk-administratör.
Välj Granskning och diagnostik under Avancerade inställningar.
Välj + Ny och välj sedan DiagnosticsConfiguration.
Välj eller ange värden som du vill, till exempel spårning, avsluta övervakning och testerna loggar platsen för mappen. Mer information: -diagnos
Välj Spara och stäng.

Se även

Konfigurera granskning och diagnostik i Unified Service Desk

Felsöka stöd för Unified Service Desk för felsökning av problem

Felsöka problem i Unified Service Desk