Jak lze konfigurovat protokolování diagnostiky klienta

2025-05-21

Existují dva způsoby, jak nakonfigurovat protokolování diagnostiky klienta Unified Service Desk:

Pomocí záznamu Nastavení auditu a diagnostiky, který je vytvořen a spravován v oblasti Unified Service Desk Microsoft Dataverse.
Ručním provedením změn v souboru UnifiedServiceDesk.exe.config. Tento soubor pak musí být distribuován na každou plochu, na které chcete protokolovat diagnostiku klienta Unified Service Desk.

Kromě toho můžete nakonfigurovat protokolování diagnostiky speciálně pro výjimky, které se mohou vyskytnout v klientovi Unified Service Desk.

Konfigurace protokolování diagnostiky klienta Unified Service Desk

Tato část popisuje, jak ručně nakonfigurovat protokolování diagnostiky v řešení Unified Service Desk. Namísto použití zde popsaného postupu doporučujeme použít funkci Nastavení auditu a diagnostiky, která poskytuje centralizovanou správu diagnostiky a možnost připojit vlastní posluchač. Další informace: Konfigurace auditování a diagnostiky v řešení Unified Service Desk

Důležité

Ručně nakonfigurovaná diagnostika (jak je popsáno zde) již nebude fungovat poté, co povolíte záznam nastavení auditu a diagnostiky, který je nakonfigurován pro diagnostiku.
Unified Service Desk také poskytuje rozhraní API, které umožňuje konfigurovat bohaté protokolování diagnostiky pro vlastní hostované ovládací prvky. Další informace: Konfigurace protokolování rozšířené diagnostiky pro vlastní hostované ovládací prvky

Toto téma popisuje, jak změnit charakteristiky protokolování klienta.

Můžete povolit protokolování pomocí souboru UnifiedServiceDesk.exe.config , který je k dispozici v instalačním adresáři klienta řešení Unified Service Desk ve vašem počítači. Konfigurace typu protokolování a umístění souboru protokolu řešení Unified Service Desk:

Otevřete soubor UnifiedServiceDesk.exe.config pro úpravy. Pokud jste nainstalovali klienta Unified Service Desk do výchozího umístění, bude tento soubor obvykle k dispozici na adrese C:\Program Files\Microsoft Dynamics 365 Customer Engagement USD\USD.

Přejděte do <switches> části v souboru:

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

V této <switches> části zadejte zdroj protokolování (například EventTopicSwitch) a poté zadejte hodnotu úrovně protokolování (například Error). Část <switches> řídí úroveň protokolování pro různé zdroje. Ve výchozím nastavení je protokolování chyb povoleno pro všechny přepínače:
- Informace o dostupných zdrojích protokolování naleznete v části Dostupné zdroje protokolů dále v tomto tématu.
- Informace o hodnotách, které můžete zadat pro každý zdroj protokolování, naleznete v části Úrovně protokolování dále v tomto tématu.

Chcete-li nakonfigurovat umístění, maximální velikost souboru a chování souborů protokolu při rotaci, přejděte do sekce <shareListeners> v souboru.

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

Tato <sharelisteners> část řídí umístění a typ protokolů, které jsou generovány pro řešení Unified Service Desk. Ve výchozím nastavení fileListener vytvoří soubor s názvem UnifiedServiceDesk.log v adresáři c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> a USDDebugListener vytvoří události na kartě Ladit výstup hostovaného ovládacího prvku Ladicí program.

Pokud chcete změnit umístění souboru UnifiedServiceDesk.log , změňte hodnotu parametru Location .
Ve výchozím nastavení se vytvoří nový protokol Unified Service Desk poté, co velikost aktuálního protokolového souboru překročí 52,42 MB. Ve výchozím nastavení se před odstraněním nejstaršího souboru protokolu uchovává až 10 souborů protokolu najednou.
- Chcete-li změnit maximální velikost souboru protokolu řešení Unified Service Desk, změňte hodnotu parametru MaxFileSize v bajtech.
- Chcete-li změnit počet protokolů uchovávaných před odstraněním nejstaršího protokolu, změňte hodnotu parametru MaxFileCount . Pokud je použita nula (0), bude protokolování rolloveru zakázáno a všechny vytvořené protokoly klienta Unified Service Desk budou uloženy.
Ve výchozím nastavení je protokolování souboru a ladění povoleno pro všechny zdroje. Pokud chcete přidat nebo odebrat naslouchací proces ze zdroje diagnostiky, vyhledejte požadovaný zdroj v oddílu <sources> a poté upravte <listeners> oddíl zdroje tak, aby zahrnoval požadovaný naslouchací proces.

Chcete-li například přidat protokolování událostí pro řešení Unified Service Desk, přidejte posluchač protokolování událostí ke zdroji 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>  
```
Nyní bude hlásit události do protokolu událostí Windows se značkou „USD“, kromě souboru a ladicího programu. Další informace o naslouchacích procesech diagnostiky najdete v části Naslouchací procesy diagnostických protokolů dále v tomto tématu.

Zdroje diagnostických protokolů

Běžné zdroje protokolů pro řešení potíží jsou uvedeny v následující tabulce.

Název zdroje	Popis
EventTopicSwitch	Podrobný zdroj protokolování User Interface Integration (UII) pro sledování přenosu zpráv uvnitř UII.
Microsoft.Uii.Common.Logging	Obecný zdroj protokolu UII pro zprávy vykazované UII.
Microsoft.Xrm.Tooling.CrmConnectControl	Zdroj protokolu pro proces přihlášení. Tento zdroj bude hlásit obecné nebo podrobné diagnostické informace o postupu přihlášení.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Zdroj logu pro všechny interakce na úrovni dat Dataverse. Tento zdroj bude hlásit všechny interakce s Dataverse, výjimky a časování.
Microsoft.Xrm.Tooling.WebResourceUtility	Zdroj protokolu pro žádosti o data webového zdroje prostřednictvím odkazu rozhraní Dataverse.
Microsoft.Crm.UnifiedServiceDesk	Zdroj protokolu pro základní funkce řešení Unified Service Desk. Tento zdroj protokolu bude hlásit akce a události, které jsou jádrem řešení Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Zdroj protokolu pro samozaváděcí a načítací procesor Unified Service Desk. Tento zdroj bude hlásit akce a události, které jsou součástí inicializace a spuštění UII a Unified Service Desk.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	Zdroj protokolů pro akce, které komunikují se systémem UserProfile; To je součástí systému ukládání do mezipaměti. Další informace: Konfigurace ukládání klientů do mezipaměti pro aplikaci agenta

Každý z těchto zdrojů protokolu můžete přepínat nezávisle na podpoře řešení potíží a izolace problémů nebo informací v rámci řešení Unified Service Desk.

Úrovně diagnostického protokolování

Pro použití je k dispozici několik různých úrovní protokolování. Se zvyšováním úrovně protokolování se však generuje a ukládá do souborů protokolu více dat.

Úroveň záznamu	Popis
Vypnuto	Zakáže všechny události z tohoto zdroje.
Chyba	Hlásí pouze chybové události.
Výstraha	Hlásí chyby a varovné události.
Informace	Hlásí chyby, varování a informační události.
Zdlouhavý	Hlásí chyby, varování, informace a podrobné události.
ActivityTracing	Hlásí chyby, upozornění, informační a podrobné události a trasování aktivity (názvy metod). Poznámka: ActivityTracing je k dispozici pouze u některých zdrojů.
Všechno	Hlásí všechny události vyvolané systémem.

Posluchači diagnostických logů

Posluchači diagnostických logů se používají k nasměrování výstupu diagnostického logu na soubory, událostní log nebo jiné zdroje. Standardně jsou všechny diagnostické zdroje propojeny s výchozími (ladicí program) a souborovými (text) naslouchacími procesy. Můžete nakonfigurovat další posluchače protokolů pro protokolování diagnostiky pro řešení Unified Service Desk. Další informace o výchozích naslouchacích procesech .NET naleznete v tématu:

MSDN:DefaultTraceListener
MSDN:EventLogTraceListener
MSDN:TextWriterTraceListener

Můžete také vytvořit vlastní posluchače, které budou odesílat diagnostické protokoly do vámi vybraného umístění. Vlastní naslouchací procesy se vytváří odvozením od třídy z abstraktní třídy MSDN:TraceListener. Návod na celý proces naleznete na CodeGuru.com.

Zobrazení souboru diagnostického protokolu

Ve výchozím nastavení je protokolování diagnostiky povoleno pro klientskou aplikaci Unified Service Desk. Soubor protokolu UnifiedServiceDesk-date<>.log je k dispozici na c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> klientském počítači pro záznam provozních chyb v klientské aplikaci. Soubor protokolu se vytvoří při prvním výskytu chyb v klientské aplikaci.

Pokud dojde k chybě v hostovaném ovládacím prvku, informace zaznamenané v souborech protokolu poskytují podrobné informace o výjimce, jako je původní hostovaný ovládací prvek, který výjimku způsobil, spolu s podrobnostmi o výjimce. Všimněte si, že není zaznamenán celý kód JavaScriptu, který výjimku způsobil. Zaznamenává se pouze chybný kód spolu s popisem výjimky.

Zde je ukázkový detail výjimky, který je zaznamenán.

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

Sjednocený proces monitorování Service Desk

Proces monitorování řešení Unified Service Desk (usdmp.exe) je služba, která nepřetržitě monitoruje stav řešení Unified Service Desk a ve výchozím nastavení po 5 sekundách ukončí všechny instance procesu prohlížeče, které nereagují a způsobují, že řešení Unified Service Desk přestane reagovat. Pokud instance procesu prohlížeče nereaguje, ale řešení Unified Service Desk reaguje, instance procesu prohlížeče nebude ukončena. Další informace o tom, jak změnit dobu trvání globální možnosti ProcessTerminationThreshold pro ukončení procesu prohlížeče, naleznete v tématu Správa možností pro řešení Unified Service Desk.

Hlášení diagnostiky chyb

Podrobné a komplexní protokolování a hlášení, ke kterému dochází během chyby komponenty, aplikace nebo systému, může pomoci identifikovat, kdy a jak k chybě došlo. Kromě standardního protokolování diagnostiky zaznamenává hlášení diagnostiky chyb informace o stavu systému a aplikace v případě výjimky v klientovi Unified Service Desk. Další informace o výjimkách naleznete v tématu Jak řešení Unified Service Desk zpracovává chyby aplikací a systému.

Složky a soubory vytvořené během výjimky

V případě výjimky vytvoří funkce Zasílání zpráv o diagnostice chyb v místním počítači složku s názvem DiagnosticsLogs_Datum a čas, kde datum a čas jsou ve formátu rok-měsíc-date_time, například DiagnosticLogs_20170322_173643. Ve složce DiagnosticsLogs se vytvoří následující složka a soubory.

Diagnostický soubor	Popis
UnifiedServiceDesk_datum a čas.log	Standardní diagnostický protokol, který je vytvořen a připojen, když je spuštěn klient Unified Service Desk. Soubor obsahuje informace o protokolování pro klienta řešení Unified Service Desk (UnifiedServiceDesk.exe). Aktuální soubory jsou v případě výjimky přesunuty do složky DiagnosticsLogs.
UnifiedServiceDeskMonitoring_datum.log	Standardní diagnostický protokol, který je vytvořen a připojen, když je spuštěn klient Unified Service Desk. Obsahuje informace o protokolování pro proces monitorování řešení Unified Service Desk (usdmp.exe), což je proces, který monitoruje stav klienta řešení Unified Service Desk. Aktuální soubory jsou v případě výjimky přesunuty do složky DiagnosticsLogs. Další informace: Proces monitorování řešení Unified Service Desk
Eventlogs (složka)	Složka vytvořená v případě závažné nebo nezávažné výjimky. Obsahuje protokoly událostí systému Windows a aplikací a textové soubory hlášení o chybách.
ExitReport.txt	Ukončovací protokol vytvořený v případě závažné nebo nezávažné výjimky. Obsahuje informace o stavu procesu, jako je název počítače, verze řešení Unified Service Desk, ID procesu, ukončovací kód a čas ukončení.
MachineHealthReport.txt	Ukončovací protokol vytvořený v případě závažné nebo nezávažné výjimky. Obsahuje informace o stavu systému, jako je procesor počítače, operační systém, podrobnosti o monitoru, jazyk a verze prohlížeče.
ProcessReport.csv	Ukončovací protokol vytvořený v případě závažné nebo nezávažné výjimky. Poskytuje úplný seznam všech procesů, které byly v systému spuštěny v době výjimky.
RegistryLog.txt	Ukončovací protokol vytvořený v případě závažné nebo nezávažné výjimky. Obsahuje textovou kopii podklíčů registru systému Windows pro aplikaci Internet Explorer.
UnifiedServiceDesk_processId_CrashDump_datumačasdmp	Vytvořeno pouze v případě neošetřené závažné výjimky nebo při ručním vyvolání pomocí kombinace kláves globální možnosti ManualDumpShortcut. Poskytuje soubor s úplným výpisem stavu paměti pro UnifiedServiceDesk.exe. Všimněte si, že k zobrazení souboru s výpisem potřebujete Visual Studio nebo jiný nástroj pro prohlížení souborů s výpisem systému Windows.

Konfigurace hlášení diagnostiky chyb

Přihlaste se k nástroji Unified Service Desk Administrator.
Vyberte možnost Auditování a diagnostika v části Pokročilá nastavení.
Vyberte + Nový a pak vyberte DiagnosticsConfiguration.
Vyberte nebo zadejte požadované hodnoty, například sledování, monitorování ukončení a umístění adresáře s protokoly diagnostiky. Další informace: Diagnostika
Zvolte Uložit a zavřít.

Viz také

Konfigurace auditování a diagnostiky v řešení Unified Service Desk

Podpora ladění v Unified Service Desk pro řešení problémů

Odstraňování problémů v aplikaci Unified Service Desk