Konfigurera diagnostisk loggning av klient i Unified Service Desk

Artikel
05/15/2017

Publicerat: november 2016

Gäller för: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

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 Dynamics 365.
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.

I det här ämnet

Konfigurera diagnostisk loggning av Unified Service Desk-klient

Diagnostikloggkällor

Diagnostikloggningsnivåer

Diagnostiklogglyssnare

Visa den diagnostiska loggfilen

Unified Service Desk övervakningsprocess

Feldiagnostikrapportering

Konfigurera diagnostisk loggning av Unified Service Desk-klient

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: MSDN: Konfigurera utökad diagnostisk loggning för anpassade värdbaserade kontroller

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: MSDN: 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\Microsoft Dynamics 365 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 Diagnostikloggkällor senare i det här avsnittet.
- Information om vilka värden som du kan ange för varje loggningskälla finns i Diagnostikloggningsnivå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 c:\Users\<UserName>\AppData\Roaming\Microsoft\UnifiedServiceDesk\<Version>-katalogen och USDDebugListener kommer att skapa händelser i MSDN: 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 avsnittet.

Diagnostikloggkällor

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

Källnamn	Beskrivning
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 till Dynamics 365. Den här källan rapporterar allmän eller detaljerad diagnostikinformation om inloggningsproceduren.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Loggkälla för alla Dynamics 365-interaktioner på datanivå. Den här källan kommer att rapportera alla interaktioner med Dynamics 365, undantag och tider.
Microsoft.Xrm.Tooling.WebResourceUtility	Loggkälla för webbresursdata via Dynamics 365-gränssnittslänken.
Microsoft.Crm.UnifiedServiceDesk	Loggkälla för kärnfunktionerna i Unified Service Desk. 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 klientcachelagring i Unified Service Desk

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.

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

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 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-<datum>.log finns på c:\Users\<användarnamn>\AppData\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> på klientdatorn för att registrera driftsfel 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.

Obs!
Felhanteringen och loggningen som beskrivs här infördes först i Unified Service Desk 2.2.1.

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

Unified Service DeskÖvervakningsprocessen (usdmp.exe) ä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.

Obs!
De funktioner för feldiagnostikrapportering som beskrivs här infördes först i Unified Service Desk 2.2.2.

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.Mer information:Configure client diagnostic logging in Unified Service Desk
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 Microsoft Visual Studioeller något annat verktyg för visning av Windows-dumpfil.

Konfigurationsfeldiagnostikrapportering

I webbprogrammet gå till Inställningar > Unified Service Desk > Alternativ.
Klicka på Ny och välj sedan DiagnosticsConfiguration.
Ange ett eller flera värden som visas i följande tabell med semikolon (;).Mer information:Alternativvärden för feldiagnostikrapportering

Till exempel den här konfigurationen ändrar katalogen med loggfiler, minskar den maximala storleken för diagnostikloggfilen till 2 GB och ändrar kortkommandot för att starta en kraschdump på begäran till CRTL+ALT+D.
Klicka på Spara och stäng.

Alternativvärden för feldiagnostikrapportering

Inställningarna av feldiagnostikrapportering konfigureras med hjälp av globala alternativ för DiagnosticsConfiguration. Tillgängliga DiagnosticsConfiguration-värden beskrivs här.

Värdenamn	Värdetyp	Beskrivning
EnableExitMonitoring	sant/falskt	Standardvärdet är sant och både diagnostikloggar och avslutningsloggar samlas in vid ett undantag. Om det är inställt på falskt kommer både diagnostikloggar och avslutningsloggar inte samlas in under ett undantag för Unified Service Desk-klienten.
EnableCrashMonitoring	sant/falskt	Standardvärdet är sant och dumpfiler samlas in under ett allvarligt undantag av Unified Service Desk-klienten. Om värdet är inställt på falskt kommer dumpfiler inte att samlas in under ett Unified Service Desk-undantag för klienten. Om EnableCrashMonitoring har värdet falskt och EnableExitMonitoring har angetts till sant kommer både diagnostikloggar och avslutningsloggar samlas in, men inte dumpfiler.
LogsDirectory	sträng	Anger den fullständiga sökvägen till den mapp där diagnostikfilerna för undantag hålls. Om sökvägen är ogiltig eller inte tillgänglig, använder Unified Service Desk standardmappen. Som standard är mappen %APPDATA%\Roaming\Microsoft\Microsoft Dynamics® 365 Unified Service Desk\<version>\Diagnostics\.
MaxDiagnosticLogsSize	heltal	Anger den maximala storleken för mappen i megabyte där diagnostikfiler sparas. Standardstorleken är 5 GB (5000 MB). När MaxDiagnosticLogsSize överskrids tas de äldsta loggfilmapparna bort tills MaxDiagnosticLogsSize inte längre överskrids. Lägg märke till att den senaste mappen inte tas bort även om den överskrider MaxDiagnosticLogsSize.
ManualDumpShortcut	sträng	Anger kortkommandot för att anropa manuell skapande av den här filen. Standardtangentkombinationen är CTRL+ALT+a. Använd formuläret för att ändra standardvärdet key1+key2+key3.

Se även

Konfigurera granskning och diagnostik i Unified Service Desk
Felsök Unified Service Desk
MSDN: Felsök problem i Unified Service Desk

Unified Service Desk 2.0

Dela via

Konfigurera diagnostisk loggning av klient i Unified Service Desk

I det här ämnet

Konfigurera diagnostisk loggning av Unified Service Desk-klient

Diagnostikloggkällor

Diagnostikloggningsnivåer

Diagnostiklogglyssnare

Visa den diagnostiska loggfilen

Unified Service Desk övervakningsprocess

Feldiagnostikrapportering

Mappar och filer som skapas under ett undantag

Konfigurationsfeldiagnostikrapportering

Alternativvärden för feldiagnostikrapportering

Se även

Ytterligare resurser