Şirket içi veri ağ geçidi için günlük dosyalarını yapılandırma

Şirket içi veri ağ geçidi için üç hizmet günlüğü kategorisi vardır: bilgi, hata ve ağ. Bu kategori, hata veya sorun için belirli bir alana odaklanmanızı sağlayan bir sorun giderme deneyimi sağlar.

Günlük yapılandırmalarınızı denetlemek için aşağıdaki adımları izleyin:

1. Varsayılan olarak \Program Files\Şirket içi veri ağ geçidi altında bulunması gereken Microsoft.PowerBI.EnterpriseGateway.exe.config ağ geçidi yapılandırma dosyasını açın.
2. Devam etmeden önce, daha sonra geri yüklemeniz gerekebilir diye bu dosyanın bir kopyasını oluşturun.
3. altında system.diagnosticsbulunan dinleyiciyi ApplicationFileTraceListener bulun.

Aşağıdaki bölümlerde, ağ geçidi sürümünüze bağlı olarak saklama türü başına yapılandırma ayrıntıları sağlanır.

Yaş tabanlı saklama

Şubat 2023'te bir ağ geçidinde yeni yaş tabanlı saklama kavramı kullanıma sunulmuştur. Bu kavram, yeni ağ geçidi yüklemeleri için varsayılan bekletme türüdür.

Bu bekletme türü için dikkate alınması gereken iki ana yön vardır (öncelik sırasına göre):

• Varsayılan değeri 5 GB olan ağ geçidi günlükleri (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log) tarafından kullanılacak maksimum disk alanı.
• Varsayılan değeri 30 gün olan gün cinsinden bekletme süresi.

Bu yeni mantıkta, her yeni gün için yeni bir günlük dosyasının sağlandığından emin olacağız. Bu sağlama, belirli bir günün bilgilerinin, dosya adının günlük giriş tarihleriyle eşleştiği günlük dosyalarında bulunmasını sağlar. Ayrıca, tek tek dosya boyutu üst sınırına (varsayılan olarak 100 MB) ulaşılırsa, gün içindeki dosya bölümü gerçekleştirilir.

  <system.diagnostics>
    <trace autoflush="true" indentsize="4">
      <listeners>
        <remove name="Default" />
        <add name="ApplicationFileTraceListener" type="Microsoft.PowerBI.DataMovement.Pipeline.Common.Diagnostics.AgeBasedRetentionRotatableFilesManagerTraceListener, Microsoft.PowerBI.DataMovement.Pipeline.Common" initializeData="%LOCALAPPDATA%\Microsoft\On-premises data gateway\,30,5120,100" />
      </listeners>
    </trace>
  </system.diagnostics>

Bekletme varsayılan parametre değerlerini değiştirmek istiyorsanız, bunları değerde initializeData ayarlamanız gerekir. Aşağıdaki listede her parametre açıklanmaktadır:

• Gün cinsinden saklama süresi (1 ile 365 gün arasındaki bir değer).
• Üç günlük dosyası türü tarafından tüketilebilen MB cinsinden maksimum toplam boyut.
• Her günlük dosyasının ayrı ayrı sahip olabileceği MB cinsinden en büyük boyut. Sınıra her ulaşıldığında, ardışık numara eklenmiş yeni bir dosya oluşturulur.

Dekont

Ağ geçidi günlükleri UTC tabanlı zaman damgaları kullanır ve günlük günlük dosyası döndürmesi UTC saat 00:00'da gerçekleşir.

Dosya sayısı tabanlı saklama

Bu, Aralık 2022 ve önceki sürümler için bir ağ geçidi içindeki varsayılan günlük saklama mantığıydı. Bu mantığın iki ana kavramı vardır:

• Günlük türü başına tutulacak dosya sayısı (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
• Günlük türü başına tüketilecek en fazla disk alanı (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

Dosyalar, daha önce listelenen ölçütlere göre bölümlenir ve bu nedenle, en fazla dosya sayısına ulaştığınızda genellikle en fazla disk alanında veya en fazla disk alanına yakın olur.

Microsoft.PowerBI.EnterpriseGateway.exe.config ağ geçidi yapılandırma dosyasından aşağıdaki alıntı üç kategoriyi içerir: GatewayInfo.log, GatewayErrors.logve GatewayNetwork.log.

  <system.diagnostics>
    <trace autoflush="true" indentsize="4">
      <listeners>
        <remove name="Default" />
        <add name="ApplicationFileTraceListener"
             type="Microsoft.PowerBI.DataMovement.Pipeline.Common.Diagnostics.RotatableFilesManagerTraceListener, Microsoft.PowerBI.DataMovement.Pipeline.Common"
             initializeData="%LOCALAPPDATA%\Microsoft\On-premises data gateway\,GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50" />
      </listeners>
    </trace>
  </system.diagnostics>

Varsayılan olarak, ağ geçidi yapılandırma dosyası \Program Files\Şirket içi veri ağ geçidi dizininde bulunur. Tutulacak günlük dosyalarının sayısını ayarlamak için dosyanın initializeData değerindeki ilk sayıyı değiştirin. Her günlük dosyasının boyutunu yapılandırmak için ikinci sayıyı değiştirin.

Aşağıdaki örnek, 20 günlük dosyasının, her kategorideki tüm dosyaların toplamının 50 MB'tan büyük olmadığını belirtir: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

Yeni yaş tabanlı saklama mantığı, mevcut şirket içi veri ağ geçidi yüklememe varsayılan olarak uygulanacak mı?

Hayır. Şimdilik bu bekletme mantığı tamamen yeni ağ geçidi yüklemelerine uygulanır. Şubat 2023 veya sonraki sürümlere yükseltirken mevcut ağ geçitlerinin geçerli günlük saklama mantığını (dosya sayısı tabanlı saklama) tutması gerekir.

Sonraki adımlar

Sorun giderme için ağ geçidi günlüklerini dışarı aktarma hakkında bilgi için Sorun giderme araçları'na gidin.