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
- 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: 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 Customer Engagement 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 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.
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,fileListenerutworzy plik o nazwie UnifiedServiceDesk.log w kataloguc:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version>, aUSDDebugListenerutworzy zdarzenia w Karta Wyniki debugowania formantu hostowanego Debuger.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. 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:
-
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 tworzenie pochodnej klasy z klasy abstrakcyjnej MSDN: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ę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
Zaloguj się w rozwiązaniu Unified Service Desk Administrator.
Wybierz Inspekcja i diagnostyka w Ustawienia zaawansowane.
Wybierz + Nowy, a następnie wybierz DiagnosticsConfiguration.
Wybierz lub wprowadź wartość, taką jak śledzenie, zamknij monitorowanie i lokalizacja katalogu rejestrów diagnostyki. Więcej informacji: Diagnostyka
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