Diagnostiikan kirjaamisen määrittäminen

Artikkeli
04/19/2023

Voit määrittää Unified Service Desk -asiakassovelluksen diagnostiikan lokiinkirjaamisen kahdella seuraavalla tavalla:

käyttämällä Seurannan ja diagnostiikan asetukset -tietuetta, jonka luominen ja hallinta tapahtuu Microsoft Dataversen Unified Service Desk -alueella.
muuttamalla UnifiedServiceDesk.exe.config-tiedostoa manuaalisesti. Muuttamisen jälkeen tiedosto on jaettava jokaiselle työpöydälle, jossa haluat käyttää Unified Service Desk -asiakassovelluksen diagnostiikan lokiinkirjaamista.

Lisäksi voit määrittää diagnostiikan lokiinkirjaamisen erityisesti Unified Service Desk -asiakassovelluksen poikkeuksia varten.

Unified Service Desk -asiakassovelluksen diagnostiikan lokiinkirjaamisen määrittäminen

Tässä osassa kuvataan, miten diagnostiikan lokiinkirjaaminen määritetään manuaalisesti Unified Service Deskissä. Tässä kuvatun toimintatavan sijaan suosittelemme Seurannan ja diagnostiikan asetukset -ominaisuuden käyttämistä. Se on keskitetty tapa hallita diagnostiikkaa ja mahdollistaa yhteyden muodostamisen mukautettuun kuuntelutoimintoon. Lisätietoja: Seurannan ja diagnostiikan määrittäminen Unified Service Desk -ratkaisussa

Tärkeä

Manuaalisesti määritetty diagnostiikka (tässä ohjeessa kuvattu), ei enää toimi, kun olet ottanut käyttöön diagnostiikalle määritetyn Seurannan ja diagnostiikan asetukset -tietueen.
Unified Service Desk sisältää myös ohjelmointirajapinnan, jolla voit määrittää monipuolisen mukautettujen isännöityjen ohjausobjektien diagnostiikan kirjauksen. Lisätietoja: Mukautettujen isännöityjen ohjausobjektien laajennetun diagnostiikan kirjauksen määrittäminen

Tässä aiheessa kuvataan, kuinka asiakkaan lokiinkirjaamisen ominaisuuksia voi muuttaa.

Voit ottaa lokiin kirjaamisen käyttöön UnifiedServiceDesk.exe.config-tiedoston avulla. Se löytyy tietokoneen Unified Service Desk -asiakassovelluksen asennushakemistosta. Voit määrittää lokiinkirjaamisen tyypin asetukset ja Unified Service Desk -lokitiedoston sijainnin seuraavasti:

Avaa UnifiedServiceDesk.exe.config-tiedosto muokkaamista varten. Jos Unified Service Desk -asiakassovellus on asennettu oletussijaintiin, tämä tiedoston sijainti on yleensä C:\Program Files\Microsoft Dynamics 365 Customer Engagement USD\USD.

Siirry tiedoston <switches>-osaan:

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

Määritä osassa <switches> lokiinkirjaamisen lähde (esim. EventTopicSwitch) ja määritä sitten lokiinkirjaamisen tason arvo (esim. Error). Osa <switches> ohjaa eri lähteiden lokiinkirjaamisen tasoja. Oletusarvoisesti virhelokit ovat käytössä kaikissa valitsimissa.
- Lisätietoja käytettävissä olevista lokiinkirjaamisen lähteistä on tämän ohjeaiheen kohdassa Käytettävissä olevat lokiinkirjauksen lähteet.
- Lisätietoja kullekin lokiinkirjaamisen lähteelle määritettävistä arvoista on kohdassa Lokiinkirjaustasot.

Voit määrittää lokitiedostojen sijainnin, tiedostojen enimmäiskoon ja siirtotoiminnan siirtymällä tiedoston <shareListeners>-osaan:

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

Osa <sharelisteners> ohjaa Unified Service Deskille luotua sijaintia ja lokien tyyppiä. fileListener luo oletusarvoisesti tiedoston nimeltä UnifiedServiceDesk.log, joka sijaitsee hakemistossa c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version>. USDDebugListener luo tapahtumat virheenkorjausohjelman isännöidyn ohjausobjektin Virheenkorjauksen tuloste -välilehteen.

Jos haluat muuttaa UnifiedServiceDesk.log-tiedoston sijaintia, muuta Location-parametrin arvoa.
Kun nykyisen lokitiedoston koko on yli 52,42 Mt, luodaan oletusarvoisesti uusi Unified Service Desk -loki. Ylläpidettäviä lokitiedostoja voi oletusarvoisesti olla samanaikaisesti 10, jonka jälkeen vanhin lokitiedosto poistetaan.
- Voit muuttaa Unified Service Deskin lokitiedoston enimmäiskokoa muuttamalla MaxFileSize-parametrin arvoa. Arvo ilmaistaan tavuina.
- Voit muuttaa ylläpidettävien lokien määrää ennen kuin vanhin loki poistetaan, kun muutat MaxFileCount-parametrin arvoa. Jos käytössä on arvo nolla (0), siirron lokiinkirjaaminen ei ole käytössä ja kaikki Unified Service Desk -asiakassovelluksen luomat lokit tallennetaan.
Oletusarvoisesti tiedosto ja virheenkorjausohjelman lokiinkirjaaminen on kaikkien lähteiden käytettävissä. Jos haluat lisätä kuuntelijan vianmäärityksen lähteeseen tai poistaa toiminnon sieltä, etsi vaadittava lähde osasta <sources> ja muokkaa sitten lähteen osaa <listeners> niin, että se sisältää haluamasi kuuntelutoiminnon.

Voit esimerkiksi lisätä Unified Service Deskin tapahtuman lokiinkirjaamisen lisäämällä tapahtuman lokiinkirjaamisen kuuntelutoiminnon lähteeseen 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>  
```
Nyt tapahtumat raportoidaan tiedoston ja virheenkorjausohjelman lisäksi Windows -tapahtumalokiin tunnuksella USD. Lisätietoja vianmäärityksen kuuntelijoista on tämän aiheen kohdassa Vianmäärityslokin kuuntelijat.

Vianmäärityslokien lähteet

Seuraavassa taulukossa esitetään vianmäärityksen yleisimmät lokien lähteet.

Lähteen nimi	Description
EventTopicSwitch	Yksityiskohtainen User Interface Integration (UII) -lokiinkirjaamisen lähde UII:n sisäisen viestiliikenteen seuraamista varten.
Microsoft.Uii.Common.Logging	UII:n raportoimien viestien yleinen UII-lokin lähde
Microsoft.Xrm.Tooling.CrmConnectControl	Sisäänkirjauksen lokin lähde. Tämä lähde raportoi sisäänkirjaustoimintosarjan yleiset tai yksityiskohtaiset vianmääritystiedot.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Kaikkien Dataverse:n tietotason yhteydenpitojen lokin lähde. Tämä lähde raportoi kaiken Dataverse:n kanssa tapahtuvan yhteydenpidon, poikkeukset ja ajoitukset.
Microsoft.Xrm.Tooling.WebResourceUtility	Dataversen liittymälinkin kautta tapahtuvien WWW-resurssin tietojen pyyntöjen lokin lähde.
Microsoft.Crm.UnifiedServiceDesk	Unified Service Desk -perustoiminnallisuuden lokin lähde. Tämä lokin lähde raportoi Unified Service Deskin perustoiminnot ja -tapahtumat.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Unified Service Deskin automaattisen käynnistyksen ja latausprosessorin lokin lähde. Tämä lähde raportoi UII:n ja Unified Service Deskin alustuksen osana olevat toiminnot ja tapahtumat.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	Niiden toimintojen lokin lähde, jotka ovat yhteydessä UserProfile-järjestelmään. Se on osa välimuistijärjestelmää. Lisätietoja: Asiakaspalvelijan sovelluksen asiakassovelluksen välimuistiin tallentamisen määrittäminen

Voit vaihtaa näitä lokien lähteitä itsenäisesti ja tukea näin vianmääritystä ja ongelmien eristämistä tai Unified Service Deskin tietoja.

Vianmäärityksen lokiinkirjaamisen tasot

Käytettävissä on useita erilaisia lokiinkirjaamisen tasoja. Kun lokiinkirjaamisen tasoa nostetaan, tietoja luodaan ja tallennetaan lokitiedostoihin enemmän.

Lokin taso	Kuvaus
Ei käytössä	Poistaa kaikki tämän lähteen tapahtumat.
Virhe	Raportoi vain virhetapahtumat.
Varoitus	Raportoi virhe- ja varoitustapahtumat.
Tiedot	Raportoi virhe-, varoitus ja tietotapahtumat.
Yksityiskohtainen	Raportoi virhe-, varoitus-, tieto- ja yksityiskohtaiset tapahtumat.
ActivityTracing	Raportoi virhe-, varoitus-, tieto- ja yksityiskohtaiset tapahtumat sekä aktiviteettien seurannan (tapojen nimet). Huomautus: ActivityTracing on vain joidenkin lähteiden käytettävissä.
Kaikki	Raportoi kaikki järjestelmän käynnistämät tapahtumat.

Vianmäärityslokin kuuntelijat

Vianmäärityslokin kuuntelijoita käytetään vianmäärityslokin tulosten kohdistamisessa tiedostoihin, tapahtumalokiin tai muihin lähteisiin. Oletusarvon mukaan kaikki vianmäärityksen lähteet on kytketty sekä oletuskuuntelijoihin (virheenetsintäohjelma) että tiedoston kuuntelijoihin (teksti). Voit määrittää Unified Service Deskin vianmäärityksen lokiinkirjaamiselle lisää lokin kuuntelijoita. Lisätietoja .NET-oletuskuuntelijoista on seuraavissa kohdissa:

MSDN:DefaultTraceListener
MSDN:EventLogTraceListener
MSDN:TextWriterTraceListener

Voit luoda myös mukautettuja kuuntelutoimintoja ja lähettää vianmäärityslokeja valitsemaasi sijaintiin. Mukautetut kuuntelijat luodaan johtamalla luokka abstraktista luokasta MSDN:TraceListener. Opastus prosessiin löytyy kohdasta CodeGuru.com.

Diagnostiikan lokitiedoston näyttäminen

Oletusarvoisesti diagnostiikan lokiinkirjaaminen on käytössä Unified Service Desk -asiakassovelluksessa. Lokitiedosto UnifiedServiceDesk-<date>.log on käytettävissä sijainnissa c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> asiakaskoneella ja siihen kirjataan asiakassovelluksen toimintovirheet. Lokitiedosto luodaan, kun asiakassovelluksessa ilmenee ensimmäisen kerran ongelmia.

Kun isännöidyssä ohjausobjektissa tapahtuu virhe, lokitiedostoon kirjataan tarkkoja tietoja poikkeuksesta, kuten poikkeuksen aiheuttanut isännöity ohjausobjekti ja poikkeuksen tiedot. Huomaa, että koko poikkeuksen aiheuttanut JavaScript-koodia ei kirjata lokiin. Vain viallinen koodi ja poikkeuksen kuvaus kirjataan lokiin.

Esimerkki lokiin kirjatuista poikkeuksen tiedoista.

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

Unified Service Desk -valvontaprosessi

Unified Service Desk -valvontaprosessi (usdmp.exe) on palvelu, joka valvoo jatkuvasti Unified Service Deskin tilaa ja päättää kaikki selainprosessien esiintymät, jotka eivät vastaa komentoihin 5 sekunnin kuluessa ja estävät myös Unified Service Deskia vastaamasta. Jos selainprosessi ei vastaa, mutta Unified Service Desk vastaa, selainprosessin esiintymää ei lopeteta. Lisätietoja selainprosessin päättämiseen liittyvän yleisen ProcessTerminationThreshold-asetuksen keston muuttamisesta on kohdassa Unified Service Desk -ratkaisun asetusten hallinta.

Virheiden diagnostiikan raportointi

Komponentti-, sovellus- tai järjestelmävirheen aikana tehty yksityiskohtainen ja perusteellinen lokiinkirjaus ja raportointi voi auttaa virheen esiintymisajankohdan ja syyn selvittämisessä. Normaalin diagnostiikan lokiinkirjaamisen lisäksi suoritettava virheiden diagnostiikan raportointi tallentaa järjestelmän ja sovelluksen tilatiedot Unified Service Desk -asiakassovelluksen poikkeuksen aikana. Lisätietoja poikkeuksista on kohdassa Miten Unified Service Desk käsittelee sovellus- ja järjestelmävirheitä.

Poikkeuksen aikana luodut kansiot ja tiedostot

Virheiden diagnostiikan raportointi luo poikkeuksen aikana paikalliselle tietokoneelle kansion nimeltä DiagnosticsLogs_päivämäärä ja aika, jossa päivämäärä ja aika esitetään muodossa vuosi-kuukausi-päivämäärä_aika esimerkiksi näin: DiagnosticLogs_20170322_173643. DiagnosticsLogs-kansioon luodaan seuraavat tiedostot ja kansio.

Diagnostiikkatiedosto	Kuvaus
UnifiedServiceDesk_dateandtime.log	Normaali diagnostiikkaloki, joka luodaan ja lisätään, kun Unified Service Desk -asiakassovellus on käynnissä. Tiedosto sisältää Unified Service Desk -asiakassovelluksen (UnifiedServiceDesk.exe) lokiinkirjaamisen tiedot. Nykyiset tiedostot siirretään DiagnosticsLogs-kansioon poikkeuksen aikana.
UnifiedServiceDeskMonitoring_date.log	Normaali diagnostiikkaloki, joka luodaan ja lisätään, kun Unified Service Desk -asiakassovellus on käynnissä. Sisältää Unified Service Desk -valvontaprosessin (usdmp.exe) lokiinkirjaamisen tiedot. Valvontaprosessi valvoo Unified Service Desk -asiakassovelluksen tilaa. Nykyiset tiedostot siirretään DiagnosticsLogs-kansioon poikkeuksen aikana. Lisätietoja: Unified Service Desk -valvontaprosessi
Eventlogs (kansio)	Kansio, joka luodaan vakavan tai ei-vakavan poikkeuksen aikana. Sisältää Windows-järjestelmän ja -sovellusten tapahtumalokit ja virheraportoinnin tekstitiedostot.
ExitReport.txt	Lopetusloki, joka luodaan vakavan tai ei-vakavan poikkeuksen aikana. Sisältää prosessin tilatiedot, kuten koneen nimen, Unified Service Desk -version, prosessin tunnuksen, lopetuskoodin ja lopetusajan.
MachineHealthReport.txt	Lopetusloki, joka luodaan vakavan tai ei-vakavan poikkeuksen aikana. Sisältää järjestelmän tilatiedot, kuten tietokoneen prosessorin, käyttöjärjestelmän, valvontatiedot, kielen ja selaimen version.
ProcessReport.csv	Lopetusloki, joka luodaan vakavan tai ei-vakavan poikkeuksen aikana. Sisältää kattavan luettelon kaikista prosesseista, jotka olivat käynnissä järjestelmässä poikkeuksen aikana.
RegistryLog.txt	Lopetusloki, joka luodaan vakavan tai ei-vakavan poikkeuksen aikana. Sisältää tekstipohjaisen kopion Windowsin rekisterin aliavaimista Internet Exploreria varten.
UnifiedServiceDesk_processId_CrashDump_dateandtime.dmp	Luodaan vain käsittelemättömän vakavan poikkeuksen aikana tai käynnistettäessä manuaalisesti yleisen ManualDumpShortcut-asetuksen näppäinyhdistelmän avulla. Sisältää UnifiedServiceDesk.exe:n koko muistin kaatumisvedoksen. Ota huomioon, että voit tarkastella kaatumisvedosta vain Visual Studiolla muulla Windowsin kaatumisvedoksen tarkastelutyökalulla.

Virheiden diagnostiikan raportoinnin määrittäminen

Kirjaudu Unified Service Deskin järjestelmänvalvojaan.
Valitse Lisäasetukset-kohdassa Seuranta ja diagnostiikka.
Valitse + Uusi ja valitse sitten DiagnosticsConfiguration.
Valitse tai anna haluamasi arvot, kuten seuranta, poistumisen seuranta ja diagnostiikan lokikansion sijainti. Lisätietoja Diagnostiikka
Valitse Tallenna ja sulje.