Konfiguruj rejestrowanie diagnostyczne klienta w rozwiązaniu Unified Service Desk

Artykuł
05/15/2017

Data opublikowania: listopad 2016

Dotyczy: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

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

W tym temacie

Konfigurowanie rejestrowania diagnostycznego klienta Unified Service Desk

Źródła dziennika diagnostycznego

Poziomy rejestrowania diagnostycznego

Odbiorniki dziennika diagnostycznego

Przeglądanie pliku dziennika diagnostycznego

Proces monitorowania rozwiązania Unified Service Desk

Raportowanie błędów diagnostyki

Konfigurowanie rejestrowania 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.Więcej informacji:Konfiguruj inspekcję i diagnostykę w rozwiązaniu Unified Service Desk

Ważne

Opisana tutaj ręcznie skonfigurowana diagnostyka nie będzie działać po włączeniu rekordu Ustawienia inspekcji i diagnostyki skonfigurowanego do diagnostyki.
Unified Service Desk udostępnia również interfejs API, który umożliwia skonfigurowanie sformatowanego rejestrowania diagnostyczne dla obsługiwanych formantów niestandardowych. Więcej informacji: MSDN: Konfigurowanie ulepszonego rejestrowania diagnostycznego dla obsługiwanych formantów niestandardowych

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:

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 USD\USD.

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>

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 Źródła dziennika diagnostycznego 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 diagnostycznego w dalszej części tego tematu.

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\UnifiedServiceDesk\<Version>, a USDDebugListener utworzy zdarzenia w MSDN: Karta Wyniki debugowania formantu hostowanego Debugera.

Jeśli chcesz zmienić lokalizację pliku UnifiedServiceDesk.log, zmień wartość parametru Location.
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.
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 do Dynamics 365. 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 Dynamics 365 na poziomie danych. To źródło zgłosi wszystkie interakcje z Dynamics 365, wyjątki i chronometraż.
Microsoft.Xrm.Tooling.WebResourceUtility	Źródło dziennika dla żądań dla danych zasobu sieci Web za pośrednictwem łącza interfejsu Dynamics 365.
Microsoft.Crm.UnifiedServiceDesk	Źródło dziennika dla podstawowej funkcjonalności 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:Konfiguruj buforowanie klienta w rozwiązaniu Unified Service Desk

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

Możesz również utworzyć odbiorniki niestandardowe służące do wysyłania dzienników diagnostycznych do wybranej przez Ciebie lokalizacji. Odbiorniki niestandardowe są tworzone przez utworzenie pochodnej klasy z klasy abstrakcyjnej TraceListener. Instruktaż dla tego procesu można znaleźć na CodeGuru.com.

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ępy w c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> na komputerze klienta, i służy do rejestrowania 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.

Uwaga

Funkcje obsługi i rejestrowania błędów zostały wprowadzone po raz pierwszy w Unified Service Desk 2.2.1.

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

Microsoft.Crm.UnifiedServiceDesk.Dynamics	Błąd	2	12/27/2016 11:54:15 AM  Pochodzenie:AppdomianUnhandledException, IsFatal:True Źródło: DemoControl Cel: Void throwExceptionMethod() Wyjątek: Wyjątek w niestandardowym formancie StackTrace:   w DemoControl.USDControl.throwExceptionMethod() w System.Threading.ExecutionContext.RunInternal(ExecutionContext executionContext, ContextCallback callback, Stan obiektu, Boolean preserveSyncCtx) w System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback callback, Stan obiektu, Boolean preserveSyncCtx) w System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback callback, Stan obiektu) w 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.

Uwaga

Opisane tu funkcje raportowania diagnostyki zostały wprowadzone po raz pierwszy w Unified Service Desk 2.2.2.

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.Więcej informacji:Configure client diagnostic logging in Unified Service Desk
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.Więcej 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ć Microsoft Visual Studio lub inne narzędzie systemu Windows służące do wyświetlania pliku zrzutu.

Konfigurowanie funkcji raportowania błędów diagnostyki

W aplikacji sieci Web przejdź do Ustawienia > Unified Service Desk > Opcje.
Kliknij Nowy, a następnie wybierz DiagnosticsConfiguration.
Wprowadź jedną lub kilka wartości, które są określone w poniższej tabeli oddzielone średnikami (;).Więcej informacji:Wartości opcji raportowania błędów diagnostyki

Na przykład ta konfiguracja zmienia katalog plików dziennika, ogranicza maksymalny rozmiar folderu dziennika diagnostyki do 2 GB i zmienia kombinację klawiszy stanowiącą skrót do wywoływania zrzutu awaryjny na żądanie do klawiszy CTRL+ALT+D.
Kliknij przycisk Zapisz i zamknij.

Wartości opcji raportowania błędów diagnostyki

Ustawienia raportowania błędów diagnostyki są konfigurowane przy użyciu opcji globalnej DiagnosticsConfiguration. Dostępne wartości DiagnosticsConfiguration zostały opisane poniżej.

Nazwa wartości	Typ wartości	Opis
EnableExitMonitoring	true / false	Ustawieniem domyślnym jest true i zarówno dzienników diagnostyki i dzienniki zamknięcia są zbierane w przypadku wyjątku. W przypadku ustawienia wartości false, zarówno dzienniki diagnostyki jak i dzienniki zamknięcia nie będą zbierane podczas wystąpienia wyjątku klienta Unified Service Desk.
EnableCrashMonitoring	true / false	Ustawieniem domyślnym jest true i pliki zrzutu są zbierane podczas wystąpienia wyjątku krytycznego klienta Unified Service Desk. W przypadku ustawienia wartości false, pliki zrzutu nie będą zbierane podczas wystąpienia wyjątku klienta Unified Service Desk. Jeśli EnableCrashMonitoring ustawiono na wartość false a EnableExitMonitoring ustawiono na wartość true, zarówno dzienniki diagnostyki jak i dzienniki zamknięcia są zbierane, ale pliki zrzutu nie są.
LogsDirectory	ciąg	Określa pełną ścieżkę do folderu, w którym przechowywane są pliki diagnostyki dla wyjątków. Jeśli ścieżka jest nieprawidłowa lub niedostępna, Unified Service Desk użyje domyślnego folderu. Domyślnie ten folder to %APPDATA%\Roaming\Microsoft\Microsoft Dynamics® 365 Unified Service Desk\<version>\Diagnostics\.
MaxDiagnosticLogsSize	liczba całkowita	Określa maksymalny rozmiar folderu, w megabajtach, w którym przechowywane są pliki diagnostyki. Domyślny rozmiar to 5 GB (5000 MB). Po przekroczeniu MaxDiagnosticLogsSize najstarsze foldery dzienników będą usuwane, dopóki MaxDiagnosticLogsSize nie będzie przekroczony. Należy zauważyć, że nawet w przypadku przekroczenia MaxDiagnosticLogsSize najnowsze folder dziennika nie zostanie usunięty.
ManualDumpShortcut	ciąg	Określa klucz skrótu służący do ręcznego tworzenia pliku zrzutu. Domyślna kombinacja klawiszy to CTRL+ALT+a. Aby zmienić ustawienia domyślne należy użyć klawisz1+klawisz2+klawisz3.

Zobacz też

Konfiguruj inspekcję i diagnostykę w rozwiązaniu Unified Service Desk
Rozwiązywanie problemów w Unified Service Desk
MSDN: Debugowanie problemów w rozwiązaniu Unified Service Desk

Unified Service Desk 2.0

Udostępnij za pośrednictwem

Konfiguruj rejestrowanie diagnostyczne klienta w rozwiązaniu Unified Service Desk

W tym temacie

Konfigurowanie rejestrowania diagnostycznego klienta Unified Service Desk

Źródła dziennika diagnostycznego

Poziomy rejestrowania diagnostycznego

Odbiorniki dziennika diagnostycznego

Przeglądanie pliku dziennika diagnostycznego

Proces monitorowania rozwiązania Unified Service Desk

Raportowanie błędów diagnostyki

Foldery i pliki utworzone podczas wyjątku

Konfigurowanie funkcji raportowania błędów diagnostyki

Wartości opcji raportowania błędów diagnostyki

Zobacz też

Dodatkowe zasoby