Mengkonfigurasi logging diagnostik dalam Unified Service Desk

Unified Service Desk dan Perpustakaan dukungan yang mendasarinya menyediakan beberapa lapisan pencatatan diagnostik yang dapat Anda gunakan untuk membantu memecahkan masalah. Anda juga dapat menggunakan log diagnostik dalam penyebaran produksi Unified Service Desk untuk mengatasi isu-isu spesifik secara berkelanjutan.

Secara default, pencatatan log kesalahan diaktifkan untuk aplikasi klien Unified Service Desk. Log file, UnifiedServiceDesk.log, tersedia di lokasi berikut pada komputer klien untuk merekam kesalahan operasional dalam aplikasi klien: c:\Users\< UserName >\AppData\Roaming\Microsoft\UnifiedServiceDesk\<versi>. File log dibuat saat pertama kali Anda mengalami kesalaha apa pun di aplikasi klien.

Dalam Topik ini

Mengkonfigurasi pencatatan diagnostik

Sumber-sumber log diagnostik

Tingkat logging diagnostik

Pendengar log diagnostik

Mengkonfigurasi pencatatan diagnostik

Anda dapat mengaktifkan pencatatan dengan menggunakan file UnifiedServiceDesk.exe.config, yang tersedia di direktori instalasi klien Unified Service Desk di komputer Anda. Untuk mengkonfigurasi jenis pencatatan dan lokasi log file Unified Service Desk:

1. Buka file UnifiedServiceDesk.exe.config untuk mengedit. Jika Anda menginstal klien Unified Service Desk pada lokasi default, file ini biasanya akan tersedia di C:\Program Files\Microsoft Dynamics CRM USD\USD.

2. Navigasikan ke bagian <switches> dalam file:

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

3. Di bagian <switches>, tentukan sumber pencatatan (seperti EventTopicSwitch), dan kemudian tentukan nilai level pencatatan (seperti Error). Bagian <switches> mengontrol tingkat logging untuk berbagai sumber. Secara default, pencatatan log kesalahan diaktifkan untuk semua sakelar:

   • Untuk informasi tentang sumber pencatatan yang tersedia, lihat Sumber-sumber log diagnostik nanti dalam topik ini.

   • Untuk informasi tentang nilai-nilai yang Anda dapat tentukan untuk setiap sumber pencatatan, lihat Tingkat logging diagnostik nanti dalam topik ini.

4. Untuk mengkonfigurasi lokasi file log, navigasikan ke bagian <shareListeners> dalam file:

   <sharedListeners>
       <add name="fileListener"
           type="Microsoft.Xrm.Tooling.Connector.DynamicsFileLogTraceListener, Microsoft.Xrm.Tooling.Connector"
               BaseFileName="UnifiedServiceDesk"
                   Location="LocalUserApplicationDirectory"
           />
       <add name="USDDebugListener" type="Microsoft.Crm.UnifiedServiceDesk.Dynamics.UsdTraceListener, Microsoft.Crm.UnifiedServiceDesk.Dynamics" />
   </sharedListeners>
   

   Bagian <sharelisteners> mengontrol lokasi dan jenis log yang dihasilkan untuk Unified Service Desk. Secara default, fileListener akan menciptakan sebuah file bernama UnifiedServiceDesk.log di direktori c:\Users\<UserName>\AppData\Roaming\Microsoft\UnifiedServiceDesk\<versi>, dan USDDebugListener akan membuat peristiwa di tab Tab Output Debug kontrol di-host Debugger.

5. Jika Anda ingin mengubah lokasi file UnifiedServiceDesk.log, ubah nilai parameter Location.

6. Secara default, file dan pencatatan debugger diaktifkan untuk semua sumber. Jika Anda ingin menambahkan atau menghapus pendengar dari sumber diagnostik, temukan sumber yang diperlukan di bagian <sources>, dan kemudian modifikasi bagian <listeners> dari sumber untuk menyertakan pendengar yang Anda inginkan.

   Misalnya, untuk menambahkan pencatatan peristiwa untuk Unified Service Desk, tambahkan pendengar pencatatan peristiwa sumber ke 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>
   

   Ini sekarang akan melaporkan peristiwa ke log peristiwa Windows dengan tag "USD", selain file dan Debugger. Untuk informasi lebih lanjut tentang pendengar diagnostik, lihat Pendengar log diagnostik nanti dalam topik ini.

Sumber-sumber log diagnostik

Sumber log pemecahan masalah umum tercantum dalam tabel berikut.

Anda dapat beralih masing-masing sumber log secara mandiri untuk mendukung pemecahan masalah dan isolasi masalah atau informasi dalam Unified Service Desk.

Tingkat logging diagnostik

Ada beberapa tingkat logging berbeda yang tersedia untuk digunakan. Namun, ketika Anda meningkatkan tingkat pencatatan, lebih banyak data yang dihasilkan dan disimpan dalam file log.

Log Level	Deskripsi
Tidak aktif	Menonaktifkan semua peristiwa dari sumber ini.
Kesalahan	Melaporkan hanya peristiwa kesalahan.
Peringatan	Melaporkanperistiwa kesalahan dan peringatan.
Informasi	Melaporkan peristiwa kesalahan, peringatan, dan informasi.
Berlebihan	Melaporkan peristiwa kesalahan, peringatan, informasi, dan yang bertele-tele.
ActivityTracing	Melaporkan kesalahan, peristiwa peringatan, informasi, dan peristiwa-peristiwa yang bertele-tele, serta melacak aktivitas (nama metode). Catatan ActivityTracing tersedia hanya di beberapa sumber.
Semua	Melaporkan semua kejadian-kejadian yang dilaporkan oleh sistem.

Pendengar log diagnostik

Pendengar log diagnostik digunakan untuk menargetkan keluaran log diagnostik ke file, log peristiwa, atau sumber lain. Secara default, semua sumber diagnostik ditransfer ke default (Debugger) dan pendengar file (teks). Anda dapat mengkonfigurasi pendengar log tambahan untuk pencatatan diagnostik untuk Unified Service Desk. Untuk informasi lebih lanjut tentang pendengar default .NET, lihat:

• DefaultTraceListener

• EventLogTraceListener

• TextWriterTraceListener

Anda juga dapat membuat pendengar kustom untuk mengirim log diagnostik ke lokasi pilihan Anda. Pendengar kustom dibuat dengan menurunkan kelas dari kelas abstrak TraceListener. Anda dapat menemukan panduan proses pada CodeGuru.com.

Lihat Juga

Konsep

Masalah debug pada Unified Service Desk

Sumber Daya Lainnya

Mengatasi masalah Unified Service Desk menggunakan debugger dan logging diagnostik

Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.