Konfigurieren von Protokolldateien für das lokale Datengateway

Es gibt drei Kategorien von Dienstprotokollen für ein lokales Datengateway: Informationen, Fehler und Netzwerk. Diese Kategorisierung bietet eine Problembehandlungserfahrung, mit der Sie sich auf den spezifischen Bereich für einen Fehler oder ein Problem konzentrieren können.

Führen Sie die folgenden Schritte aus, um Ihre Protokollierungskonfigurationen zu überprüfen:

1. Öffnen Sie die Gatewaykonfigurationsdatei Microsoft.PowerBI.EnterpriseGateway.exe.config, die sich standardmäßig unter \Programme\Lokales Datengateway befinden soll.
2. Bevor Sie fortfahren, erstellen Sie eine Kopie dieser Datei, falls Sie sie später wiederherstellen müssen.
3. Suchen Sie den Listener ApplicationFileTraceListener, der sich unter system.diagnosticsbefindet.

In den folgenden Abschnitten werden die Konfigurationsdetails pro Aufbewahrungstyp bereitgestellt, die von Ihrer Gatewayversion abhängig sind.

Altersbasierte Aufbewahrung

Ab Februar 2023 wurde das neue altersbasierte Aufbewahrungskonzept innerhalb eines Gateways eingeführt. Dieses Konzept ist der Standardaufbewahrungstyp für neue Gatewayinstallationen.

Für diesen Aufbewahrungstyp müssen zwei Hauptaspekte berücksichtigt werden (in der Reihenfolge der Priorität):

• Maximaler Speicherplatz, der von Gatewayprotokollen genutzt werden soll (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log), mit einem Standardwert von 5 GB.
• Aufbewahrungszeitraum in Tagen mit einem Standardwert von 30 Tagen.

In dieser neuen Logik stellen wir sicher, dass für jeden neuen Tag eine neue Protokolldatei bereitgestellt wird. Diese Bereitstellung stellt sicher, dass die Informationen für einen bestimmten Tag in Protokolldateien vorhanden sind, in denen der Dateiname mit den Protokolleintragsdaten übereinstimmt. Außerdem wird die Dateipartition innerhalb des Tages ausgeführt, wenn die maximale einzelne Dateigröße (Standardwert von 100 MB) erreicht ist.

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

Wenn Sie die Standardwerte für die Aufbewahrung ändern möchten, sollten Sie sie im initializeData Wert anpassen. In der folgenden Liste werden die einzelnen Parameter beschrieben:

• Aufbewahrungszeitraum in Tagen (ein Wert zwischen 1 und 365 Tagen).
• Maximale Gesamtgröße in MB, die von den drei Protokolldateitypen verbraucht werden kann.
• Maximale Größe in MB, über die jede Protokolldatei einzeln verfügen kann. Jedes Mal, wenn das Limit erreicht ist, wird eine neue Datei mit einer fortlaufenden Nummer versehen.

Dateianzahlbasierte Aufbewahrung

Diese Art war die Standard-Protokollhaltungslogik innerhalb eines Gateways für die Versionen Dezember 2022 und früher. Diese Logik hat zwei Hauptkonzepte:

• Anzahl der dateien, die pro Protokolltyp aufbewahrt werden sollen (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
• Maximaler Speicherplatz pro Protokolltyp (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

Die Dateien werden entsprechend mit den zuvor aufgeführten Kriterien partitioniert. Wenn Sie daher immer die maximale Anzahl von Dateien erreichen, liegt sie normalerweise auch bei oder in der Nähe des maximalen Speicherplatzes.

Der folgende Auszug aus der Gatewaykonfigurationsdatei Microsoft.PowerBI.EnterpriseGateway.exe.config enthält die drei Kategorien: GatewayInfo.log, , GatewayErrors.logund 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>

Standardmäßig befindet sich die Gatewaykonfigurationsdatei im Verzeichnis \Programme\Lokales Datengateway. Um die Anzahl der beizubehaltenden Protokolldateien festzulegen, ändern Sie die erste Zahl im Wert der Datei initializeData . Um die Größe der einzelnen Protokolldateien zu konfigurieren, ändern Sie die zweite Zahl.

Im folgenden Beispiel wird angegeben, dass 20 Protokolldateien, die Summe aller Dateien in jeder Kategorie nicht mehr als 50 MB groß sind, beibehalten werden: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

Gilt die neue altersbasierte Aufbewahrungslogik standardmäßig für meine vorhandene lokale Datengatewayinstallation?

Nein. Diese Aufbewahrungslogik wird jetzt auf vollständig neue Gatewayinstallationen angewendet. Vorhandene Gateways beim Upgrade auf Versionen ab Februar 2023 oder höher sollten ihre aktuelle Protokollaufbewahrungslogik beibehalten (auf Dateianzahl basierende Aufbewahrung).

Verwandte Inhalte

Informationen zum Exportieren von Gatewayprotokollen zur Problembehandlung finden Sie unter "Problembehandlungstools".