設定內部部署資料閘道的記錄檔

  • 發行項

內部部署資料閘道的服務記錄有三種類別：資訊、錯誤和網路。 此分類提供疑難排解體驗，可讓您專注于錯誤或問題的特定區域。

若要檢查記錄組態，請執行下列步驟：

  1. 開啟閘道組態檔 Microsoft.PowerBI.EnterpriseGateway.exe.config，預設應該位於 \Program Files\On-premises 資料閘道底下。
  2. 在繼續進行之前，請先複製此檔案，以防稍後需要還原它。
  3. 找出位於 底下的 system.diagnostics 接聽程式 ApplicationFileTraceListener 。

下列各節提供每個保留類型的組態詳細資料，視您的閘道版本而定。

以年齡為基礎的保留期

從 2023 年 2 月開始，閘道內的新存留期概念已推出。 這個概念是新 閘道安裝的預設保留類型 。

針對此保留類型，有兩個主要層面需要考慮（優先順序如下）：

  • 閘道記錄所耗用的最大磁碟空間（GatewayInfo*.log、GatewayError*.log、GatewayNetwork*.log），預設值為 5 GB。
  • 保留期間以天為單位，預設值為 30 天。

在這個新的邏輯中，我們會確保針對每一天布建新的記錄檔。 此布建可確保指定日期的資訊會出現在檔案名符合記錄專案日期的記錄檔中。 如果達到個別檔案大小上限（預設值為 100 MB），則會執行當天內的檔案分割區。

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

如果您想要變更保留預設參數值，您應該在 值中 initializeData 調整它們。 下列清單描述每個參數：

  • 保留期間以天為單位（值介於 1 到 365 天之間）。
  • 以 MB 為單位的大小上限，這三種記錄檔類型可以取用。
  • 每個記錄檔可以個別擁有的大小上限，以 MB 為單位。 每次達到限制時，都會建立新的檔案，並附加序號。

注意

閘道記錄會使用以 UTC 為基礎的時間戳記，而每日記錄檔輪替將在 00：00 UTC 進行。

檔案計數型保留

這是 2022 年 12 月和更早版本閘道內的預設記錄保留邏輯。 此邏輯有兩個主要概念：

  • 每個記錄類型保留的檔案數目（GatewayInfo*.log、GatewayError*.log、GatewayNetwork*.log）。
  • 每個記錄類型所耗用的磁碟空間上限（GatewayInfo*.log、GatewayError*.log、GatewayNetwork*.log）。

檔案會根據先前列出的準則進行分割，因此，每當達到檔案數目上限時，通常也會位於或接近最大磁碟空間。

下列來自閘道組態檔 Microsoft.PowerBI.EnterpriseGateway.exe.config 的摘錄包含三個類別： GatewayInfo.log 、 GatewayErrors.log 和 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>

根據預設，閘道組態檔位於 \Program Files\On-premises 資料閘道的目錄中。 若要設定要保留的記錄檔數目，請變更檔案 initializeData 值中的第一個數位。 若要設定每個記錄檔的大小，請變更第二個數字。

下列範例指定將保留 20 個記錄檔，每個類別中所有檔案的總和不超過 50 MB 大小： GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

根據預設，以新存留期為基礎的保留邏輯是否會套用至現有的內部部署資料閘道安裝？

否。 此保留邏輯現在會套用至全新的閘道安裝。 升級至 2023 年 2 月或更新版本的現有閘道應保留其目前的記錄保留邏輯（以檔案計數為基礎的保留期）。

下一步

如需如何匯出閘道記錄以進行疑難排解的資訊，請移至 疑難排解工具 。