Mengonfigurasi file log untuk gateway data lokal

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 merupakan tipe retensi standar untuk instalasi 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 setiap hari baru disediakan file log yang baru. Provisi ini memastikan informasi untuk hari tertentu ada dalam file log di mana nama file cocok dengan tanggal entri log. Selain itu, 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 pada nilai initializeData. Daftar berikut ini menjelaskan setiap parameter:

• Periode retensi dalam hari (nilai antara 1 dan 365 hari).
• Ukuran total maksimum dalam MB yang dapat digunakan 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.

Nota

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

Retensi berbasis jumlah file

Gaya 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 disimpan 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. 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.log, dan 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, dipertahankan: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

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

Tidak. Logika retensi ini untuk saat ini diterapkan ke instalasi gerbang yang benar-benar baru. Gateway yang ada saat melakukan pemutakhiran ke versi Februari 2023 atau versi yang lebih baru harus mempertahankan logika retensi log mereka yang sekarang (retensi berbasis jumlah file).

Persetujuan Admin untuk Diagnostik Gateway (Pratinjau)

Persetujuan admin untuk diagnostik gateway adalah fitur yang memungkinkan administrator mengontrol secara eksplisit apakah data diagnostik dari gateway data lokal dikumpulkan dan dikirim ke cloud.

Fitur ini memperkenalkan model berbasis persetujuan untuk memastikan bahwa data yang berpotensi sensitif—seperti log Mashup—hanya dikirimkan setelah persetujuan administratif. Ini juga memungkinkan kemampuan pemantauan dan diagnostik di masa mendatang.

Saat diaktifkan:

• Data diagnostik dapat dikumpulkan dan diproses dengan aman
• Ruang kerja Fabric dikaitkan dengan gateway
• Ruang kerja dicadangkan untuk pengalaman pemantauan dan diagnostik di masa mendatang

Cara kerjanya

Admin gateway mengaktifkan diagnostik di pengaturan gateway dan mengaitkan ruang kerja. Admin penyewa dapat mencabut persetujuan kapan saja, yang menghentikan semua gateway di penyewa dari berpartisipasi dalam diagnostik.

Aliran data diagnostik diberlakukan secara ketat:

• Tidak ada persetujuan → tidak ada transfer data

• Persetujuan dicabut → akses dihentikan

  

  

  

Untuk penerapan segera, memulai ulang gateway data lokal mengakhiri unggahan diagnostik yang sedang berlangsung.

Konten terkait

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