Kā varat konfigurēt klienta diagnostikas reģistrēšanu

Raksts
06/26/2024

Unified Service Desk klienta diagnostikas reģistrēšanu var konfigurēt divējādi:

Izmantojot audita un diagnostikas iestatījumu ierakstu, kas ir izveidots un pārvaldīts apgabalā Unified Service Desk Microsoft Dataverse.
Manuāli veicot izmaiņas failā UnifiedServiceDesk.exe.config. Pēc tam šis fails ir jāizplata katrā darbvirsmā, kurā vēlaties veikt Unified Service Desk klienta diagnostikas reģistrēšanu.

Turklāt diagnostikas reģistrēšanu var konfigurēt īpaši izņēmumiem, kas var rasties Unified Service Desk klientā.

Unified Service Desk klienta diagnostikas reģistrēšanas konfigurēšana

Šajā sadaļā ir aprakstīts, kā manuāli konfigurēt diagnostikas reģistrēšanu pakalpojumā Unified Service Desk. Šeit aprakstītās procedūras vietā mēs iesakām izmantot audita un diagnostikas funkciju, kas nodrošina centralizētu diagnostikas administrēšanu, kā arī iespēju pievienot pielāgotu klausītāju. Papildinformācija Auditēšanas un diagnostikas konfigurēšana pakalpojumā Unified Service Desk

Svarīgi

Manuāli konfigurēta diagnostika (kā aprakstīts šeit), vairs nedarbosies, kad iespējosit audita un diagnostikas iestatījumu ierakstu, kas ir konfigurēts diagnostikai.
Unified Service Desk nodrošina arī API, kas ļauj konfigurēt bagātīgu diagnostikas reģistrēšanu pielāgotām viesotām vadīklām. Papildinformācija Uzlabotās diagnostikas reģistrēšanas konfigurēšana pielāgotām viesotām vadīklām

Šajā tēmā ir aprakstīts, kā mainīt klientu reģistrēšanas īpašības.

Varat iespējot reģistrēšanu ar failu UnifiedServiceDesk.exe.config , kas ir pieejams Unified Service Desk klienta instalācijas direktorijā jūsu datorā. Lai konfigurētu reģistrēšanas tipu un Unified Service Desk žurnālfaila atrašanās vietu:

Atveriet UnifiedServiceDesk.exe.config failu rediģēšanai. Ja instalējāt Unified Service Desk klientu noklusējuma atrašanās vietā, šis fails parasti ir pieejams šeit: C:\Program Files\Microsoft Dynamics 365 Customer Engagement USD\USD.

Dodieties uz <switches> faila sadaļu:

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

<switches> Sadaļā norādiet reģistrēšanas avotu (piemēram EventTopicSwitch) un pēc tam norādiet reģistrēšanas līmeņa vērtību (piemēram Error). Sadaļa <switches> kontrolē dažādu avotu reģistrēšanas līmeņus. Pēc noklusējuma kļūdu reģistrēšana ir iespējota visiem slēdžiem:
- Informāciju par pieejamajiem reģistrēšanas avotiem skatiet šīs tēmas sadaļā Pieejamie žurnāla avoti .
- Informāciju par vērtībām, kuras varat norādīt katram reģistrēšanas avotam, skatiet šīs tēmas sadaļā Reģistrēšanas līmeņi .

Lai konfigurētu žurnālfailu atrašanās vietu, maksimālo faila lielumu un apgāšanās darbību, dodieties uz <shareListeners> faila sadaļu.

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

Šī <sharelisteners> sadaļa kontrolē Unified Service Desk ģenerēto žurnālu atrašanās vietu un tipu. Pēc noklusējuma fileListener izveidos failu ar nosaukumu UnifiedServiceDesk.logc:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> direktorijā un USDDebugListener izveidos notikumus atkļūdotāja viesotās vadīklas atkļūdošanas izvades cilnē .

Ja vēlaties mainīt UnifiedServiceDesk.log faila atrašanās vietu , mainiet parametra Location vērtību.
Pēc noklusējuma jauns Unified Service Desk žurnāls tiek izveidots pēc tam, kad pašreizējā žurnālfaila lielums pārsniedz 52,42 MB. Pēc noklusējuma vienlaicīgi tiek glabāts līdz 10 žurnālfailiem pirms vecākā žurnālfaila dzēšanas.
- Lai mainītu maksimālo Unified Service Desk žurnālfaila lielumu, mainiet parametra MaxFileSize vērtību baitos.
- Lai mainītu žurnālu skaitu, kas tiek uzturēti pirms vecākā žurnāla dzēšanas, mainiet parametra MaxFileCount vērtību. Ja tiek izmantota nulle (0), apgāšanās reģistrēšana tiks atspējota un visi izveidotie Unified Service Desk klienta žurnāli tiks saglabāti.
Pēc noklusējuma faila un atkļūdotāja reģistrēšana ir iespējota visiem avotiem. Ja vēlaties pievienot vai noņemt klausītāju no diagnostikas avota, atrodiet vajadzīgo avotu <sources> sadaļā un pēc tam modificējiet <listeners> avota sadaļu, lai iekļautu vajadzīgo klausītāju.

Piemēram, lai pievienotu notikumu reģistrēšanu pakalpojumam Unified Service Desk, avotam Microsoft.Crm.UnifiedServiceDesk pievienojiet notikumu reģistrēšanas klausītāju.
```
<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>  
```
Tagad tas ziņos par notikumiem Windows notikumu žurnālā ar atzīmi "USD", papildus failam un atkļūdotājam. Papildinformāciju par diagnostikas klausītājiem skatiet šīs tēmas sadaļā Diagnostikas žurnāla klausītāji .

Diagnostikas žurnāla avoti

Biežāk izmantotie problēmu novēršanas žurnālu avoti ir uzskaitīti tabulā.

Avota nosaukums	Apraksts
EventTopicSwitch	Detalizēts lietotāja interfeisa integrācijas (UII) reģistrēšanas avots ziņojumapmaiņas trafika uzraudzībai UII.
Microsoft.Uii.Common.Logging	Vispārīgs UII reģistrēšanas avots UII fiksētajiem ziņojumiem.
Microsoft.Xrm.Tooling.CrmConnectControl	Reģistrēšanas avots pierakstīšanās procesam. Šis avots ziņos vispārēju vai detalizētu diagnostikas informāciju par pierakstīšanās procedūru.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Reģistrēšanas avots visām Dataverse datu līmeņa mijiedarbībām. Šis avots ziņos par visu mijiedarbību ar Dataverse, izņēmumiem un fiksētajiem laikiem.
Microsoft.Xrm.Tooling.WebResourceUtility	Reģistrēšanas avots tīmekļa resursu datu pieprasījumiem, kas izmanto Dataverse interfeisa saiti.
Microsoft.Crm.UnifiedServiceDesk	Žurnāla avots pamata Unified Service Desk funkcionalitātei. Šis žurnāla avots ziņos par darbībām un notikumiem, kas ir Unified Service Desk pamatā.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Unified Service Desk sāknēšanas siksnas un ielādes procesora žurnāla avots. Šis avots ziņos par darbībām un notikumiem, kas ir daļa no UII un Unified Service Desk inicializēšanas un startēšanas.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	Reģistrēšanas avots darbībām, kas mijiedarbojas ar UserProfile sistēmu, kas ir daļa no kešdarbes sistēmas. Papildinformācija Klienta kešatmiņas konfigurēšana aģenta lietojumprogrammai

Katru no šiem žurnāla avotiem varat pārslēgt neatkarīgi, lai atbalstītu problēmu novēršanu un problēmu vai informācijas izolēšanu pakalpojumā Unified Service Desk.

Diagnostikas reģistrācijas līmeņi

Lietošanai pieejami vairāki atšķirīgi reģistrēšanas līmeņi. Taču, palielinot reģistrēšanas līmeni, tiek ģenerēts un žurnālfailos uzkrāts lielāks datu apjoms.

Reģistrēšanas līmenis	Apraksts
Izslēgts	Atspējo visus notikumus no šī avota.
Kļūda	Ziņo tikai par kļūdu notikumiem.
Brīdinājums	Ziņo par kļūdu un brīdinājumu notikumiem.
Informācija	Ziņo ar kļūdu, brīdinājumu un informācijas notikumiem.
Izvērsti	Ziņo par kļūdu, brīdinājumu, informācijas un izvērstiem notikumiem.
ActivityTracing	Ziņo par kļūdu, brīdinājumu, informācijas, izvērstiem notikumiem un aktivitātes izsekošanu (metožu nosaukumiem). Piezīme: ActivityTracing ir pieejams tikai dažos avotos.
Visas	Ziņo par visiem sistēmas izraisītajiem notikumiem.

Diagnostikas žurnāla klausītāji

Diagnostikas žurnāla klausītāji tiek izmantoti, lai novirzītu diagnostikas reģistrētās informācijas izvadi failiem, notikumu žurnāliem vai citiem avotiem. Pēc noklusējuma visi diagnostikas avoti ir sasaistīti gan ar noklusējuma (atkļūdotājs), gan failu (teksta) klausītājiem. Varat konfigurēt papildu žurnāla klausītājus diagnostikas reģistrēšanai pakalpojumā Unified Service Desk. Papildinformāciju par .NET noklusējuma klausītājiem skatiet resursos:

MSDN:DefaultTraceListener
MSDN:EventLogTraceListener
MSDN:TextWriterTraceListener

Varat arī izveidot pielāgotus klausītājus, kas nosūtīs diagnostikas žurnālus uz jūsu izvēlētu vietu. Pielāgoti klausītāji tiek izveidoti, iegūstot klasi no MSDN:TraceListener abstraktās klases. Šī procesa aprakstu varat atrast resursā CodeGuru.com.

Diagnostiskas žurnālfaila skatīšana

Pēc noklusējuma diagnostikas reģistrēšana ir iespējota Unified Service Desk klienta lietojumprogrammā. Žurnālfails UnifiedServiceDesk-date <>.log ir pieejams c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> klienta datorā, lai reģistrētu darbības kļūdas klienta lietojumprogrammā. Žurnālfails tiek izveidots, kad klienta lietojumprogrammā pirmo reizi rodas jebkādas kļūdas.

Ja rodas viesotās vadīklas kļūda, žurnālfailā reģistrētā informācija nodrošina detalizētu informāciju par izņēmumu, piemēram, sākotnējo viesoto vadīklu, kas izraisīja izņēmumu, kā arī informāciju par izņēmumu. Ņemiet vērā, ka viss JavaScript kods, kas radīja izņēmumu, nav reģistrēts. Reģistrēts tiek tikai bojātais kods kopā ar izņēmuma aprakstu.

Tālāk ir sniegts reģistrētas detalizētas informācijas par izņēmumu paraugs.

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

Programmas Unified Service Desk pārraudzības process

Unified Service Desk uzraudzības process (usdmp.exe) ir pakalpojums, kas nepārtraukti uzrauga Unified Service Desk stāvokli un pēc noklusējuma pēc 5 sekundēm pārtrauc visas pārlūkprogrammas procesa gadījumus, kas nereaģē un izraisa Unified Service Desk nereaģēšanu. Ja pārlūkprogrammas procesa instance nereaģē, bet Unified Service Desk reaģē, pārlūkprogrammas procesa gadījums netiks pārtraukts. Papildinformāciju par to, kā mainīt pārlūkprogrammas procesa pārtraukšanas globālās opcijas ProcessTerminationThreshold ilgumu, skatiet sadaļā Unified Service Desk opciju pārvaldība.

Kļūdu diagnostikas atskaišu veidošana

Detalizēta un aptveroša reģistrēšana un atskaišu veidošana, kas tiek veikta komponenta, programmas vai sistēmas kļūmes gadījumā, var palīdzēt noteikt, kad un kā radās kļūda. Papildus standarta diagnostikas reģistrēšanai kļūdu diagnostikas ziņošanas sistēma reģistrē informāciju par lietojumprogrammas stāvokli izņēmuma gadījumā Unified Service Desk klientā. Plašāku informāciju par izņēmumiem var atrast sadaļā Kā Unified Service Desk apstrādā lietojumprogrammu un sistēmas kļūdas.

Izņēmuma laikā izveidotās mapes un faili

Izņēmuma gadījumā kļūdu diagnostikas ziņojumi lokālajā datorā izveido mapi ar nosaukumu DiagnosticsLogs_datums un laiks, kur datums un laiks ir formā gads-mēnesis-datums_laiks., piemēram, DiagnosticLogs_20170322_173643. Mapē DiagnosticsLogs tiek izveidota šāda mape un faili.

Diagnostikas fails	Apraksts
UnifiedServiceDesk_dateandtime.log	Standarta diagnostikas žurnāls, kas tiek izveidots un pievienots, kad darbojas Unified Service Desk klients. Fails satur Unified Service Desk klienta (UnifiedServiceDesk.exe) reģistrēšanas informāciju. Pašreizējie faili tiek pārvietoti uz mapi DiagnosticsLogs izņēmuma gadījumā.
UnifiedServiceDeskMonitoring_date.log	Standarta diagnostikas žurnāls, kas tiek izveidots un pievienots, kad darbojas Unified Service Desk klients. Satur reģistrēšanas informāciju Unified Service Desk uzraudzības procesam (usdmp.exe), kas ir process, kas uzrauga Unified Service Desk klienta stāvokli. Pašreizējie faili tiek pārvietoti uz mapi DiagnosticsLogs izņēmuma gadījumā. Papildinformācija Unified Service Desk pārraudzības process
Eventlogs (mape)	Mape, kas izveidota fatāla vai nefatāla izņēmuma gadījumā. Ietver Windows sistēmas un programmu notikumu žurnālus un kļūdu atskaišu veidošanas teksta failus.
ExitReport.txt	Iziešanas žurnāls, kas izveidots fatāla vai nefatāla izņēmuma gadījumā. Ietver procesa stāvokļa informāciju, piemēram, iekārtas nosaukumu, Unified Service Desk versiju, procesa ID, izejas kodu un izejas laiku.
MachineHealthReport.txt	Iziešanas žurnāls, kas izveidots fatāla vai nefatāla izņēmuma gadījumā. Ietver sistēmas statusa informāciju, piemēram, datora procesoru, operētājsistēmu, monitora informāciju, valodu un pārlūkprogrammas versiju.
ProcessReport.csv	Iziešanas žurnāls, kas izveidots fatāla vai nefatāla izņēmuma gadījumā. Sniedz pilnīgu visu tādu procesu sarakstu, kuri darbojās attiecīgajā sistēmā izņēmuma brīdī.
RegistryLog.txt	Iziešanas žurnāls, kas izveidots fatāla vai nefatāla izņēmuma gadījumā. Ietver Windows reģistra apakšatslēgu teksta kopijas, kas paredzētas Internet Explorer.
UnifiedServiceDesk_processId_CrashDump_dateandtime.dmp	Tiek izveidots tikai neapstrādāta fatāla izņēmuma gadījumā vai ja tiek izsaukts manuāli, izmantojot globālās opcijas ManualDumpShortcut tastatūras kombināciju. Nodrošina pilnīgu atmiņas izmetes failu UnifiedServiceDesk.exe. Ņemiet vērā, ka, lai skatītu izdrukas failu, ir nepieciešams Visual Studio vai cits Windows izdrukas failu skatīšanas rīks.

Kļūdu diagnostikas atskaišu veidošanas konfigurēšana

Pierakstieties Unified Service Desk programmā Administrator.
Sadaļā Papildu iestatījumi atlasiet Auditēšana un diagnostika.
Atlasiet + Jauns un pēc tam atlasiet DiagnosticsConfiguration.
Atlasiet vai ievadiet vēlamās vērtības, piemēram, izsekošana, iziešanas pārraudzība un diagnostikas žurnālu mapes atrašanās vieta. Papildinformācija Diagnostika
Atlasiet Saglabāt un amp; Aizvērt.

Skatiet arī:

Konfigurējiet auditēšanu un diagnostiku pakalpojumā Unified Service Desk

Atkļūdošanas atbalsts pakalpojumā Unified Service Desk, lai novērstu problēmas

Atkļūdošanas problēmas pakalpojumā Unified Service Desk

Kopīgot, izmantojot