Bagikan melalui

Mengonfigurasi file log untuk gateway data lokal

  • Artikel

Ada tiga kategori log layanan untuk gateway data lokal: informasi, kesalahan, dan jaringan. Kategorisasi ini memberikan pengalaman pemecahan masalah yang memungkinkan Anda fokus pada area tertentu untuk kesalahan atau masalah.

Untuk memeriksa konfigurasi pengelogan Anda, lakukan langkah-langkah berikut:

  1. Buka file konfigurasi gateway Microsoft.PowerBI.EnterpriseGateway.exe.config, yang secara default harus terletak di bawah \Program Files\Gateway data lokal.
  2. Sebelum melanjutkan lebih lanjut, buat salinan file ini untuk berjaga-jaga jika Anda perlu memulihkannya nanti.
  3. Temukan pendengar ApplicationFileTraceListener yang berada di bawah system.diagnostics.

Bagian berikut ini menyediakan detail konfigurasi per jenis retensi, yang bergantung pada versi gateway Anda.

Retensi berbasis usia

Mulai Februari 2023, konsep retensi berbasis usia baru dalam gateway diperkenalkan. Konsep ini adalah jenis retensi default untuk penginstalan gateway baru .

Untuk jenis retensi ini, ada dua aspek utama yang perlu dipertimbangkan (dalam urutan prioritas):

  • Ruang disk maksimum yang akan digunakan oleh log gateway (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log), dengan nilai default 5 GB.
  • Periode retensi dalam hari, dengan nilai default 30 hari.

Dalam logika baru ini, kami memastikan bahwa untuk setiap hari baru file log baru disediakan. Provisi ini memastikan informasi untuk hari tertentu ada dalam file log di mana nama file cocok dengan tanggal entri log. Juga partisi file dalam sehari dilakukan jika ukuran file individual maksimum (default 100 MB) tercapai.

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

Jika Anda ingin mengubah nilai parameter default retensi, Anda harus menyesuaikannya dalam initializeData nilai . Daftar berikut ini menjelaskan setiap parameter:

  • Periode retensi dalam hari (nilai antara 1 dan 365 hari).
  • Ukuran total maksimum dalam MB yang dapat dikonsumsi oleh tiga jenis file log.
  • Ukuran maksimum dalam MB yang dapat dimiliki setiap file log satu per satu. Setiap kali batas tercapai, file baru dibuat dengan nomor berurutan yang ditambahkan.

Catatan

Log gateway menggunakan tanda waktu berbasis UTC, dan rotasi file log harian akan berlangsung pada pukul 00.00 UTC.

Retensi berbasis jumlah file

Ini adalah logika retensi log default dalam gateway untuk versi Desember 2022 dan yang lebih lama. Logika ini memiliki dua konsep utama:

  • Jumlah file yang akan dipertahankan per jenis log (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
  • Ruang disk maksimum yang akan digunakan per jenis log (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

File dipartisi sesuai dengan kriteria yang tercantum sebelumnya, dan oleh karena itu, setiap kali Anda mencapai jumlah maksimum file, biasanya juga berada di atau dekat dengan ruang disk maksimum.

Kutipan berikut dari file konfigurasi gateway Microsoft.PowerBI.EnterpriseGateway.exe.config berisi tiga kategori: GatewayInfo.log, , GatewayErrors.logdan 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>

Secara default, file konfigurasi gateway terletak di direktori \Program Files\Gateway data lokal. Untuk mengatur jumlah file log yang akan dipertahankan, ubah angka pertama dalam nilai file initializeData . Untuk mengonfigurasi ukuran setiap file log, ubah nomor kedua.

Contoh berikut menentukan bahwa 20 file log, jumlah total semua file dalam setiap kategori berukuran tidak lebih dari 50 MB, akan dipertahankan: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

Apakah logika retensi berbasis usia baru akan berlaku secara default ke penginstalan gateway data lokal saya yang sudah ada?

Nomor. Logika retensi ini untuk saat ini diterapkan ke penginstalan gateway yang benar-benar baru. Gateway yang ada saat memutakhirkan ke Februari 2023 atau versi yang lebih baru harus menyimpan logika retensi log mereka saat ini (retensi berbasis jumlah file).

Langkah berikutnya

Untuk informasi tentang cara mengekspor log gateway untuk pemecahan masalah, buka Alat pemecahan masalah.