Konfigurieren von Protokolldateien für das lokale Datengateway

Es gibt drei Kategorien von Dienstprotokollen für ein lokales Datengateway: Informationen, Fehler und Netzwerk. Durch diese Kategorisierung können Sie sich bei der Problembehandlung auf einen bestimmten Bereich konzentrieren, in dem ein Fehler oder ein Problem auftritt.

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

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

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 Rangfolge):

• 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 diese im initializeData-Wert anpassen. Die folgende Liste beschreibt jeden Parameter:

• Aufbewahrungszeitraum in Tagen (ein Wert zwischen 1 und 365 Tagen).
• Maximale Gesamtgröße in MB, die von den drei Protokolldateitypen genutzt 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 sequenziellen Zahl erstellt, die angefügt wird.

Hinweis

Gatewayprotokolle verwenden UTC-basierte Zeitstempel, und die tägliche Drehung der Protokolldatei erfolgt um 00:00 UTC.

Dateianzahlbasierte Aufbewahrung

Dies war die Standard-Protokollaufbewahrungslogik 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 und daher immer dann, wenn Sie die maximale Anzahl von Dateien erreichen, liegt sie normalerweise auch bei oder in der Nähe des maximalen Speicherplatzes.

Im folgenden Auszug aus der Gatewaykonfigurationsdatei Microsoft.PowerBI.EnterpriseGateway.exe.config sind die drei Kategorien enthalten: GatewayInfo.log, GatewayErrors.log und 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\On-premises data gateway. Um die Anzahl der aufzubewahrenden Protokolldateien festzulegen, ändern Sie die erste Zahl im initializeData-Wert der Datei. Ändern Sie die zweite Zahl, um die Größe jeder Protokolldatei zu konfigurieren.

Das folgende Beispiel legt fest, dass 20 Protokolldateien aufbewahrt werden, wobei die Gesamtsumme aller Dateien in jeder Kategorie nicht größer als 50 MB sein darf: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

Wird die neue altersbasierte Aufbewahrungslogik standardmäßig auf meine vorhandene lokale Datengatewayinstallation angewendet?

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

Nächste Schritte

Informationen zum Exportieren von Gatewayprotokollen zur Problembehandlung finden Sie unter Tools zur Problembehandlung.