İstemci tanılama günlüğünü nasıl yapılandırabilirsiniz?

Makale
06/27/2024

Unified Service Desk istemci günlüğü yapılandırmanın iki yolu vardır:

Microsoft Dataverse platformunun Unified Service Desk alanında oluşturulan ve yönetilen bir Denetim ve Tanılama Ayarları raporu kullanılarak.
UnifiedServiceDesk.exe.config dosyasında elle değişiklik yaparak. Bu dosya daha sonra tanı amaçlı Unified Service Desk istemci günlüğü tutulmasını istediğiniz her masaüstüne dağıtılmalıdır.

Ayrıca, özellikle Unified Service Desk istemcisinde oluşabilecek özel durumlar için tanılama günlük kaydını yapılandırabilirsiniz.

Unified Service Desk istemcisi tanılama günlüğünü yapılandırma

Bu bölümde, Unified Service Desk'te tanılama günlüğünün elle yapılandırılması anlatılmaktadır. Burada açıklanan yordamı kullanmak yerine, merkezî tanılama yönetimi sağlayan ve özel bir dinleyiciye bağlanılabilmesine imkan veren Denetim & Tanılama Ayarları özelliğini kullanmanızı öneririz. Daha fazla bilgi: Unified Service Desk'te denetlemeyi ve tanılamayı yapılandırma

Önemli

Elle yapılandırılmış tanılama (burada açıklandığı gibi), tanılama için yapılandırılmış bir Denetim ve Tanılama Ayarları kaydı etkinleştirildikten sonra çalışmaz.
Unified Service Desk ayrıca, özel barındırılan denetimlerin zengin tanılama günlüğünü yapılandırmanıza olanak sağlayan bir API sağlar. Daha fazla bilgi: Özel barındırılan denetimler için gelişmiş tanılama günlüğü yapılandırma

Bu konuda, istemci günlüğü özelliklerinin nasıl değiştirileceği açıklanmaktadır.

Günlük kaydını, bilgisayarınızdaki Unified Service Desk istemci yükleme dizini içinde bulunan UnifiedServiceDesk.exe.config dosyası ile etkinleştirebilirsiniz. Günlüğe kaydetme türünü ve Unified Service Desk günlük dosyasının yerini yapılandırmak için:

Düzenleme için UnifiedServiceDesk.exe.config dosyasını açın. Unified Service Desk istemcisini varsayılan konuma yüklediyseniz, bu dosya genellikle C:\Program Files\Microsoft Dynamics 365 Customer Engagement USD\USD dizininde bulunur.

Dosyadaki <switches> bölümüne gidin:

<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> bölümünde, bir günlük kaynağı belirtin (EventTopicSwitch gibi) ve sonra bir günlük düzeyi değeri belirtin (Error gibi). <switches> bölümü çeşitli kaynaklar için günlüğe kaydetme düzeyini denetler. Varsayılan olarak, tüm anahtarlar için hata günlüğü etkin durumdadır.
- Kullanılabilir günlük kaydetme kaynakları hakkında daha fazla bilgi için bu konuda daha sonra Kullanılabilir Günlük Kaynakları öğesine gidin.
- Her günlük kaydetme kaynağı için belirtebileceğiniz değerler hakkında daha fazla bilgi için bu konuda daha sonra Günlük Düzeyleri öğesine gidin.

Günlük dosyalarının konumunu, maksimum dosya boyutunu ve devretme davranışını yapılandırmak için, dosyada <shareListeners> bölümüne gidin.

<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> bölümü Unified Service Desk için oluşturulan günlüklerin yerini ve türünü denetler. Varsayılan olarak fileListener, c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> dizininde UnifiedServiceDesk.log adlı bir dosya oluşturur ve USDDebugListener, Hata Ayıklayıcı barındırılan denetimin Hata Ayıklama çıkışı sekmesinde olaylar oluşturur.

UnifiedServiceDesk.log dosyasının yerini değiştirmek istiyorsanız, Location parametresinin değerini değiştirin.
Varsayılan olarak, geçerli günlük dosyasının boyutu 52,42 MB'yi aştığında yeni bir Unified Service Desk günlüğü oluşturulur. En eski tarihli günlük dosyası silinmeden önce varsayılan olarak aynı anda en fazla 10 günlük dosyası tutulur.
- Maksimum Unified Service Desk günlük dosyası boyutunu değiştirmek için, MaxFileSize parametresinin bayt cinsinden değerini değiştirin.
- En eski günlük silinmeden önce saklanacak günlüklerin sayısını değiştirmek için MaxFileCount parametresinin değerini değiştirin. Sıfır (0) kullanılırsa, devretme günlüğü devre dışı bırakılır ve oluşturulan tüm Unified Service Desk istemci günlükleri kaydedilir.
Varsayılan olarak, dosya ve hata ayıklama günlük kaydetme tüm kaynaklar için etkin durumdadır. Tanı amaçlı bir kaynağa bir dinleyici eklemek veya kaynaktan kaldırmak isterseniz, <sources> bölümünde gerekli kaynağın yerini belirleyin ve daha sonra istediğiniz dinleyici dahil etmek için kaynağın <listeners> bölümünü değiştirin.

Örneğin, Unified Service Desk'e olay günlüğü eklemek için olay günlüğü dinleyicisini Microsoft.Crm.UnifiedServiceDesk kaynağına ekleyin.
```
<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>  
```
Bu şimdi olayları, dosyanın ve Hata Ayıklayıcının yanı sıra, Windows olay günlüğüne "USD" etiketiyle bildirir. Tanı amaçlı dinleyiciler hakkında daha fazla bilgi için bu konuda daha sonra Tanılama Günlüğü Dinleyicileri öğesinde gidin.

Tanı amaçlı günlük kaynakları

Genel sorun giderme günlük kaynakları aşağıdaki tabloda listelenmiştir.

Kaynak Adı	Tanım
EventTopicSwitch	UII içindeki ileti trafiğini izlemek için ayrıntılı User Interface Integration (UII) günlük kaydı kaynağı.
Microsoft.Uii.Common.Logging	UII tarafından rapor edilen iletiler için Genel UII Günlük kaynağı.
Microsoft.Xrm.Tooling.CrmConnectControl	Oturum açma işlemi için günlük kaynağı. Bu kaynak oturum açma yordamı hakkında genel veya ayrıntılı tanı bilgileri bildirir.
Microsoft.Xrm.Tooling.Connector.CrmServiceClient	Tüm Dataverse veri düzeyi etkileşimler için günlük kaynağı. Bu kaynak Dataverse ile olan tüm etkileşimleri, özel durumları ve zamanlamaları bildirir.
Microsoft.Xrm.Tooling.WebResourceUtility	Dataverse arabirimi bağlantısı aracılığıyla Web Kaynak verisi istekleri için günlük kaynağı.
Microsoft.Crm.UnifiedServiceDesk	Temel Unified Service Desk işlevselliği için günlük kaynağı. Bu günlük kaynağı, Unified Service Desk için temel olan eylemleri ve olayları bildirir.
Microsoft.Crm.UnifiedServiceDesk.Dynamics	Unified Service Desk önyükleme ve yükleme işlemcisi için günlük kaynağı. Bu kaynak, Unified Service Desk ve UII tanımlama ve başlatmanın parçası olan eylemleri ve olayları bildirir.
Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager	UserProfile sistemi ile etkileşimde olan eylemler için günlük kaynak; bu önbelleğe alma sisteminin bir parçasıdır. Daha fazla bilgi: Yapılandırma istemci aracıları uygulamanız için önbelleğe alma

Sorun gidermeyi ve sorunların veya Unified Service Desk'teki bilginin yalıtımını desteklemek için, birbirinden bağımsız olarak bu günlük kaynaklarının her birini değiştirebilirsiniz.

Tanı amaçlı günlük düzeyleri

Kullanıma açık birkaç farklı günlük düzeyi var. Ancak, günlük düzeyini artırdıkça, daha fazla veri oluşturulur ve günlük dosyalarında depolanır.

Günlük Düzeyi	Açıklama
Kapalı	Bu kaynaktan gelen tüm olayları devre dışı bırakır.
Hata	Yalnızca hata olaylarını bildirir.
Uyarı	Hata ve uyarı olaylarını bildirir.
Bilgi	Hata, uyarı ve bilgi olaylarını bildirir.
Ayrıntılı	Hata, uyarı, bilgi ve ayrıntı olaylarını bildirir.
ActivityTracing	Hataları, uyarıları, bilgi ve ayrıntılı olayları ve etkinlik izlemeyi (yöntem adları) bildirir. Not: ActivityTracing yalnızca bazı kaynaklarda kullanılabilir.
Tümü	Sistem tarafından oluşturulan tüm olayları bildirir.

Tanı amaçlı günlük dinleyicileri

Tanı amaçlı günlük dinleyicileri, tanı amaçlı günlüğün çıkışını; dosyalara, olay günlüğü'ne veya diğer kaynaklara hedeflemek için kullanılır. Varsayılan olarak, tüm tanı kaynakları varsayılan (Hata Ayıklayıcı) ve dosya (Metin) dinleyicileri için ayarlanmıştır. Tanı amaçlı günlüğe yönelik ek günlük dinleyicileri Unified Service Desk için yapılandırabilirsiniz. .NET varsayılan dinleyicileri hakkında daha fazla bilgi için şu adrese gidin:

MSDN:DefaultTraceListener
MSDN:EventLogTraceListener
MSDN:TextWriterTraceListener

İstediğiniz bir konuma tanı amaçlı günlük kayıtları göndermek için özel dinleyiciler de oluşturabilirsiniz. Özel dinleyiciler, MSDN:TraceListener soyut sınıfından bir sınıf türeterek oluşturulur. İşlem hakkında bir adım adım yönergeyi CodeGuru.com adresinde bulabilirsiniz.

Tanılama günlük dosyasını görüntüleme

Varsayılan olarak, tanılama günlüğü Unified Service Desk istemci uygulaması için etkin durumdadır. Bir günlük dosyası olan UnifiedServiceDesk-<tarih>.log, istemci uygulamada işlem hatalarını kaydetmek için istemci bilgisayarda c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> konumunda bulunur. Günlük dosyası, istemci uygulamasında herhangi bir hatayla ilk defa karşılaştığınızda oluşturulur.

Barındırılan denetimde bir hata ortaya çıktığında, günlük dosyalarına kaydedilen bilgiler özel durumla ilgili olarak özel duruma neden olan ana barındırılan denetim ile özel durum ayrıntıları gibi ayrıntılı bilgiler sağlar. Özel duruma neden tüm JavaScript kodunun günlüğe kaydedilmediğini unutmayın. Yalnızca hatalı kod ile özel durum açıklaması kaydedilir.

Günlüğe kaydedilen örnek bir özel durum ayrıntısını aşağıda bulabilirsiniz.

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 İzleme İşlemi

Unified Service Desk İzleme İşlemi (usdmp.exe), Unified Service Desk çalışma durumunu sürekli olarak izleyen ve yanıt vermeyen ve Unified Service Desk'in yanıt veremez duruma gelmesine neden olan her türlü tarayıcı işlemi örneğini varsayılan olarak 5 saniye sonunda sonlandıran bir hizmettir. Bir tarayıcı işlem örneği yanıt vermiyorsa ancak Unified Service Desk yanıt veriyorsa tarayıcı örneği sonlandırılmaz. Tarayıcı işlemini sonlandırma için ProcessTerminationThreshold genel seçeneğinin süresini değiştirme hakkında bilgi edinmek için bkz. Unified Service Desk Seçenekleri Yönet.

Hata tanılamalarını raporlama

Bir bileşen, uygulama veya sistem arızası sırasında gerçekleşen ayrıntılı ve kapsamlı bir günlük ve raporlama bulunması, hatanın ne zaman ve nasıl meydana geldiğinin tanımlanmasına yardımcı olabilir. Standart tanılama günlüğüne ek olarak, hata tanılama raporu Unified Service Desk istemcisindeki bir özel durum olayında sistemin ve uygulamanın durum bilgisini de kaydeder. Özel durumlar hakkında daha fazla bilgiyi Unified Service Desk uygulama ve sistem hatalarını nasıl ele alır bölümünde bulabilirsiniz.

Bir özel durum sırasında oluşturulan klasörler ve dosyalar

Bir özel durum olayında, hata tanılama raporu yerel bilgisayarda DiagnosticsLogs_tarih ve saat adlı bir klasör oluşturur; burada tarih ve saat yıl-ay-gün biçiminde girilir (örn. DiagnosticLogs_20170322_173643) DiagnosticsLogs klasöründe aşağıdaki klasör ve dosyalar oluşturulur.

Tanılama dosyası	Açıklama
UnifiedServiceDesk_dateandtime.log	Unified Service Desk istemcisi çalışırken oluşturulan ve eklenen standart tanılama günlüğü. Unified Service Desk istemcisine ilişkin günlük bilgilerini içerir (UnifiedServiceDesk.exe). Geçerli dosyalar, özel durum olayı olduğunda DiagnosticsLogs klasörüne taşınır.
UnifiedServiceDeskMonitoring_tarih.log	Unified Service Desk istemcisi çalışırken oluşturulan ve eklenen standart tanılama günlüğü. Unified Service Desk istemcisinin sağlık durumunu izleyen bir işlem olan Unified Service Desk izleme işlemi (usdmp.exe) için günlük bilgilerini içerir. Geçerli dosyalar, özel durum olayı olduğunda DiagnosticsLogs klasörüne taşınır. Daha fazla bilgi: Unified Service Desk İzleme İşlemi
Eventlogs (klasör)	Önemli veya önemli olmayan özel durum durumunda oluşturulan klasör. Windows sistemi ve uygulama olay günlüklerini ve hata raporlama metin dosyalarını içerir.
ExitReport.txt	Önemli veya önemli olmayan özel durum durumunda oluşturulan çıkış günlüğü. Makine adı, Unified Service Desk sürümü, işlem kimliği, çıkış kodu ve çıkış saati gibi işlem durumu bilgilerini içerir.
MachineHealthReport.txt	Önemli veya önemli olmayan özel durum durumunda oluşturulan çıkış günlüğü. Bilgisayar işlemcisi, işletim sistemi, monitör ile ilgili ayrıntılar, dil ve tarayıcı sürümü gibi sistem durumu bilgilerini içerir.
ProcessReport.csv	Önemli veya önemli olmayan özel durum durumunda oluşturulan çıkış günlüğü. Sistemde özel durumun oluştuğu sırada çalışmakta tüm işlemlerin kapsamlı bir listesini sağlar.
RegistryLog.txt	Önemli veya önemli olmayan özel durum durumunda oluşturulan çıkış günlüğü. Internet Explorer için Windows Kayıt Defteri alt anahtarlarının metin tabanlı bir kopyasını içerir.
UnifiedServiceDesk_processId_CrashDump_dateandtime.dmp	Yalnızca işlenmeyen önemli bir özel durum durumunda veya ManualDumpShortcut genel seçeneği tuş bileşimi kullanılarak el ile başlatıldığında oluşturulur. UnifiedServiceDesk.exe için tam bellek dökümü dosyası sağlar. Döküm dosyasını görüntülemek için Visual Studio veya diğer Windows döküm dosyası görüntüleme aracının gerekli olduğunu unutmayın.

Hata tanılama raporunu yapılandırma

Unified Service Desk Yöneticisinde oturum açın.
Gelişmiş Ayarlar altında, Denetim ve Tanılama'yı seçin.
+ Yeni'yi seçtikten sonra DiagnosticsConfiguration öğesini seçin.
İzleme, çıkış izleme ve tanılama gibi istediğiniz değerleri girin veya seçin klasörünün konumunu kaydeder. Daha fazla bilgi: Tanılama
Kaydet ve Kapat'ı seçin.

Ayrıca bkz.

Unified Service Desk'te denetlemeyi ve tanılamayı yapılandırma

Unified Service Desk içinde sorunları gidermek için hata ayıklama desteği

Unified Service Desk sorunlarını giderme

Aracılığıyla paylaş