Dela via


Hur du konfigurerar diagnostisk loggning av klient

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:

  1. Ö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.

  2. 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>  
    
    
  3. 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.

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

  5. Om du vill ändra placeringen av filen UnifiedServiceDesk.log ändrar du värdet för parametern Location.

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

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

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

  1. Logga in på Unified Service Desk-administratör.

  2. Välj Granskning och diagnostik under Avancerade inställningar.

  3. Välj + Ny och välj sedan DiagnosticsConfiguration.

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

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