Udostępnij za pośrednictwem


Sposób konfigurowania rejestrowania diagnostycznego klienta

Istnieją dwa sposoby konfigurowania rejestrowania diagnostycznego klienta Unified Service Desk:

  • Za pomocą rekordu Ustawienia inspekcji i diagnostyki, który jest tworzony i zarządzany w obszarze Unified Service Desk platformy Microsoft Dataverse.

  • Dzięki ręcznemu wprowadzaniu zmian w pliku UnifiedServiceDesk.exe.config. Ten plik musi następnie zostać przekazany na każdy komputer stacjonarny, na którym chcesz przeprowadzić rejestrowanie diagnostyczne klienta Unified Service Desk.

    Ponadto można skonfigurować rejestrowanie diagnostyczne specjalnie na potrzeby wyjątków, które mogą wystąpić w kliencie Unified Service Desk.

Konfiguracja logowania diagnostycznego klienta Unified Service Desk

W tej sekcji opisano, jak ręcznie skonfigurować rejestrowanie diagnostyczne w Unified Service Desk. Zamiast procedury opisanej poniżej, firma Microsoft zaleca korzystać z funkcji Ustawienia inspekcji i diagnostyki, która zapewnia scentralizowane administrowanie diagnostyką oraz możliwość podłączenia odbiornika niestandardowego. More information: Konfiguruj inspekcję i diagnostykę w rozwiązaniu Unified Service Desk

Ważne

W tym temacie opisano, jak można zmienić właściwości rejestrowania klienta.

Rejestrowanie można włączyć przy użyciu pliku UnifiedServiceDesk.exe.config, który jest dostępny w katalogu instalacyjnym klienta Unified Service Desk na komputerze użytkownika. Aby skonfigurować typ rejestrowania i lokalizację pliku dziennika Unified Service Desk:

  1. Otwórz plik UnifiedServiceDesk.exe.config do edycji. Jeśli zainstalowano klienta Unified Service Desk w lokalizacji domyślnej, ten plik zazwyczaj będzie dostępny w C:\Program Files\Microsoft Dynamics 365 Customer Engagement USD\USD.

  2. Przejdź do sekcji <switches> w pliku:

    <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. W sekcji <switches> określ źródło rejestrowania (np. EventTopicSwitch), a następnie określ wartość poziomu rejestrowania (np. Error). Sekcja <switches> kontroluje poziomy rejestrowania dla różnych źródeł. Domyślnie, rejestrowanie błędów jest włączone dla wszystkich przełączników:

    • Aby zapoznać się z informacjami o dostępnych źródłach rejestrowania zobacz Dostępne źródła dziennika w dalszej części tego tematu.

    • Aby uzyskać informacje o wartościach, które można określić dla każdego źródła rejestrowania, zobacz Poziomy rejestrowania w dalszej części tego tematu.

  4. Aby skonfigurować lokalizację, maksymalną wielkość pliki i zachowanie najazdów plików dziennika, przejdź do sekcji <shareListeners> w pliku.

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

    Sekcja <sharelisteners> kontroluje lokalizację i typ dzienników, które są generowane dla Unified Service Desk.. Domyślnie, fileListener utworzy plik o nazwie UnifiedServiceDesk.log w katalogu c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version>, a USDDebugListener utworzy zdarzenia w Karta Wyniki debugowania formantu hostowanego Debuger.

  5. Jeśli chcesz zmienić lokalizację pliku UnifiedServiceDesk.log, zmień wartość parametru Location.

  6. Domyślnie nowy dziennik Unified Service Desk jest tworzony po tam, jak rozmiar bieżącego pliku dziennika przekroczy 52.42 MB. Domyślnie maksymalnie 10 plików dziennika jest obsługiwanych w tym samym czasie, zanim najstarszy plik dziennika zostanie usunięty.

    • Aby zmienić maksymalny rozmiar piliku dziennika Unified Service Desk, zmień podawaną w bajtach wartość parametru MaxFileSize.

    • Aby zmienić liczbę dzienników utrzymywanych przed usunięciem najstarszego dziennika, zmień wartość parametru MaxFileCount. Jeśli wartość to zero (0) rejestrowanie najazdu zostanie wyłączone i wszystkie utworzone dzienniki klienta Unified Service Desk zostaną zapisane.

  7. Domyślnie plik i rejestrowanie debugera są włączone dla wszystkich źródeł. Jeśli chcesz dodać lub usunąć odbiornik ze źródła diagnostycznego, zlokalizuj wymagane źródło w sekcji <sources>, a następnie zmodyfikuj sekcję <listeners> źródła, aby dołączyć wybrany odbiornik.

    Na przykład, aby dodać rejestrowanie zdarzeń dla Unified Service Desk, dodaj odbiornik rejestrowania zdarzeń do źródła Microsoft.Crm.UnifiedServiceDesk.

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

    Zdarzenia będą od teraz również raportowane do dziennika zdarzeń Windows z tagiem „USD", oprócz pliku i Debugera. Aby uzyskać więcej informacji o odbiornikach diagnostycznych, zobacz Odbiorniki dziennika diagnostycznego w dalszej części tego tematu.

Źródła dziennika diagnostycznego

Typowe źródła dziennika rozwiązywania problemów są wymienione w poniższej tabeli.

Nazwa źródłowa opis
EventTopicSwitch Szczegółowe źródło rejestrowania User Interface Integration (UII) do potrzeb monitorowania ruchu wiadomości wewnątrz UII.
Microsoft.Uii.Common.Logging Ogólne źródło dziennika UII dla wiadomości zgłaszanych przez UII.
Microsoft.Xrm.Tooling.CrmConnectControl Źródło dziennika dla procesu logowania. To źródło zgłaszać będzie ogólne lub szczegółowe informacje diagnostyczne dotyczące procedury logowania.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient Źródło dziennika dla wszystkich interakcji Dataverse na poziomie danych. To źródło zgłosi wszystkie interakcje z Dataverse, wyjątki i chronometraż.
Microsoft.Xrm.Tooling.WebResourceUtility Źródło dziennika dla żądań dla danych zasobu sieci Web za pośrednictwem łącza interfejsu Dataverse.
Microsoft.Crm.UnifiedServiceDesk Źródło dziennika dla podstawowej funkcji programu Unified Service Desk. To źródło dziennika zgłaszać będzie akcje i zdarzenia będące podstawą Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.Dynamics Źródło dziennika dla bootstrapu Unified Service Desk i procesora ładowania. To źródło zgłaszać będzie akcje i zdarzenia, które są częścią inicjowania i uruchamiania UII i Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager Źródło dziennika dla akcji, które współdziałają z systemem UserProfile; część systemu pamięci podręcznej. Więcej informacji: Konfigurowanie buforowania klienta dla aplikacji agenta

Istnieje możliwość przełączania każdego z tych źródeł dziennika, co jest pomocne podczas rozwiązywania problemów i izolowania problemów lub informacji wewnątrz Unified Service Desk.

Poziomy rejestrowania diagnostycznego

Istnieje kilka poziomów rejestrowania diagnostycznego. Jednakże wraz ze zwiększaniem poziomu rejestrowania, rośnie ilość danych generowanych i przechowywanych w plikach dziennika.

Poziom dziennika Opis
Wyłącz Wyłącza wszystkie zdarzenia z tego źródła.
Błąd Raportuje tylko zdarzenia błędów.
Ostrzeżenie Raportuje zdarzenia błędów i ostrzeżeń.
Informacja Raportuje zdarzenia błędów, ostrzeżeń i informacji.
Pełne informacje Raportuje zdarzenia błędów, ostrzeżeń, informacji oraz pełne informacje.
ActivityTracing Raportuje zdarzenia błędów, ostrzeżeń, informacji, pełne zdarzenia oraz śledzenie aktywności (nazwy metod). Uwaga: ActivityTracing jest dostępne tylko w przypadku niektórych źródeł.
A-Z Raportuje wszystkie zdarzenia wygenerowane przez system.

Odbiorniki dziennika diagnostycznego

Odbiorniki dziennika diagnostycznego są używane do kierowania wyników rejestrowania diagnostycznego do plików, dziennika zdarzeń lub innych źródeł. Domyślnie wszystkie źródła diagnostyczne są kierowane zarówno do odbiornika domyślnego (Debuger), jak i do pliku (tekst). Można konfigurować dodatkowe odbiorniki dziennika dla rejestrowania diagnostycznego dla Unified Service Desk. Aby uzyskać więcej informacji dotyczących domyślnych odbiorników .NET, zobacz:

Przeglądanie pliku dziennika diagnostycznego

Domyślnie, rejestrowanie diagnostyczne jest włączone dla aplikacji klienta Unified Service Desk. Plik dziennika, UnifiedServiceDesk-<date>.log, jest dostępny w c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> na komputerze klienckim w celu zarejestrowania błędów operacyjnych w aplikacji klienta. Plik dziennika jest tworzony podczas pierwszego wystąpienia jakichkolwiek błędów w aplikacji klienta.

Po wystąpieniu błędu w formancie hostowanym, informacje zarejestrowane w plikach dzienników zawierają szczegółowe informacje o wyjątku, takie jak źródłowy formant hostowany, który spowodował wyjątek, wraz z szczegółami dotyczącymi wyjątku. Należy zauważyć, że cały kod JavaScript, który spowodował wyjątek, nie jest rejestrowany. Rejestrowany jest tylko nieprawidłowy kod wraz z opisem wyjątku.

Oto przykładowe szczegóły wyjątku, który został zarejestrowany.

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 monitorowania rozwiązania Unified Service Desk

Proces monitorowania Unified Service Desk (usdmp.exe) to usługa, która umożliwia ciągłe monitorowanie kondycji Unified Service Desk, a kończy, domyślnie po 5 sekundach, wszystkie wystąpienia procesu przeglądarki, które nie odpowiadają i powodują, że Unified Service Desk przestaje odpowiadać. Jeśli wystąpienie procesu przeglądarki nie odpowiada, ale Unified Service Desk nadal jest responsywne, wystąpienie procesu przeglądarki nie zostanie zakończone. Aby uzyskać więcej informacji na temat zmieniania czasu trwania opcji globalnej ProcessTerminationThreshold dla zakończenia procesu przeglądarki, zobacz Zarządzanie opcjami dla rozwiązania Unified Service Desk.

Raportowanie błędów diagnostyki

Dzięki szczegółowemu i kompleksowemu rejestrowaniu i raportowaniu występujących podczas błędu składnika, aplikacji lub systemu, możliwe jest identyfikowanie czasu i sposobu wystąpienia błędu. Oprócz standardowego rejestrowania diagnostyki, raportowania błędów diagnostyki zapisuje informacje o stanie systemu i aplikacji w przypadku wyjątku w kliencie Unified Service Desk. Więcej informacji na temat wyjątków można znaleźć w Jak rozwiązanie Unified Service Desk obsługuje błędy aplikacji i systemu.

Foldery i pliki utworzone podczas wyjątku

W przypadku wyjątku raportowanie błędów diagnostyki tworzy folder na komputerze lokalnym o nazwie DiagnosticsLogs_data i godzina, w którym data i godzina są widoczne w formie rok-miesiąc-dzień_godzina, np DiagnosticLogs_20170322_173643. W folderze DiagnosticsLogs tworzone są następujące foldery i pliki.

Plik Diagnostyka Opis
UnifiedServiceDesk_dateandtime.log Standardowy dziennik diagnostyki, który jest tworzony i dołączany, gdy uruchomiony jest klient Unified Service Desk. Plik zawiera informacje dotyczące logowania dla klienta Unified Service Desk (UnifiedServiceDesk.exe). Bieżące pliki są przenoszone do folderu DiagnosticsLogs w przypadku wyjątku.
UnifiedServiceDeskMonitoring_date.log Standardowy dziennik diagnostyki, który jest tworzony i dołączany, gdy uruchomiony jest klient Unified Service Desk. Zawiera informacje dotyczące logowania dla procesu monitorowania Unified Service Desk (usdmp.exe), który jest procesem, który monitoruje kondycję klienta Unified Service Desk. Bieżące pliki są przenoszone do folderu DiagnosticsLogs w przypadku wyjątku. Wiecej informacji: Proces monitorowania rozwiązania Unified Service Desk
Eventlogs (folder) Folder utworzony w przypadku wystąpienia wyjątku krytycznego lub niekrytycznego. Zawiera system Windows i dzienniki zdarzeń aplikacji oraz pliki tekstowe raportowania błędów.
ExitReport.txt Dziennik zakończenia utworzony w przypadku wystąpienia wyjątku krytycznego lub niekrytycznego. Zawiera informacje o stanie procesu, takie jak nazwa komputera, wersja Unified Service Desk, identyfikator procesu, kod zakończenia i godzina zakończenia.
MachineHealthReport.txt Dziennik zakończenia utworzony w przypadku wystąpienia wyjątku krytycznego lub niekrytycznego. Zawiera informacje o stanie systemu, takie jak procesor komputera, system operacyjny, informacje dotyczące monitora, język i wersja przeglądarki.
ProcessReport.csv Dziennik zakończenia utworzony w przypadku wystąpienia wyjątku krytycznego lub niekrytycznego. Zapewnia pełną listę wszystkich procesów uruchomionych w systemie w chwili wystąpienia wyjątku.
RegistryLog.txt Dziennik zakończenia utworzony w przypadku wystąpienia wyjątku krytycznego lub niekrytycznego. Zawiera tekstową kopię podkluczy rejestru systemu Windows dla Internet Explorer.
UnifiedServiceDesk_processId_CrashDump_dateandtime.dmp Tworzony tylko w przypadku wystąpienia nieobsługiwanego wyjątku krytycznego lub przy wywołaniu ręcznym przy użyciu kombinacji klawiszy opcji globalnej ManualDumpShortcut. Zapewnia plik zrzutu całej pamięci UnifiedServiceDesk.exe. Należy pamiętać, że aby wyświetlić plik zrzut, należy posiadać Visual Studio lub inne narzędzie systemu Windows służące do wyświetlania pliku zrzutu.

Konfigurowanie funkcji raportowania błędów diagnostyki

  1. Zaloguj się w rozwiązaniu Unified Service Desk Administrator.

  2. Wybierz Inspekcja i diagnostyka w Ustawienia zaawansowane.

  3. Wybierz + Nowy, a następnie wybierz DiagnosticsConfiguration.

  4. Wybierz lub wprowadź wartość, taką jak śledzenie, zamknij monitorowanie i lokalizacja katalogu rejestrów diagnostyki. Więcej informacji: Diagnostyka

  5. Zaznacz Zapisz i zamknij.

Zobacz też

Konfiguruj inspekcję i diagnostykę w rozwiązaniu Unified Service Desk

Debugowanie pomocy technicznej w rozwiązaniu Unified Service Desk w celu rozwiązywania problemów

Debugowanie problemów w rozwiązaniu Unified Service Desk