Konfigurieren von Protokolldateien für das lokale Datengateway

Das lokale Datengateway verfügt über drei Kategorien von Dienstprotokollen: Informationen, Fehler und Netzwerk. Diese Kategorisierung ermöglicht eine gezielte Problemlösung, sodass Sie sich auf den spezifischen Bereich eines Fehlers oder Problems 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. Standardmäßig finden Sie diese Datei unter \Program Files\On-premises data gateway.
2. 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 führt das Gateway ein neues altersbasiertes Aufbewahrungskonzept ein. Dieses Konzept ist der Standardaufbewahrungstyp für neue Gatewayinstallationen.

Berücksichtigen Sie für diesen Aufbewahrungstyp zwei Hauptaspekte (in der Reihenfolge ihrer Priorität):

• Maximaler Speicherplatz für Gatewayprotokolle (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log) mit dem Standardwert 5 GB.
• Aufbewahrungszeitraum in Tagen mit einem Standardwert von 30 Tagen.

In dieser neuen Logik stellt das Gateway sicher, dass für jeden neuen Tag eine neue Protokolldatei erstellt 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. Darüber hinaus führt das Gateway die Dateipartitionierung innerhalb des Tages durch, 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, passen Sie den initializeData Wert an. 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 die drei Protokolldateitypen nutzen können.
• Maximale Größe in MB, über die jede Protokolldatei einzeln verfügen kann. Jedes Mal, wenn das Limit erreicht ist, erstellt das Gateway eine neue Datei mit einer sequenziellen Zahl, die angefügt wird.

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 diesen Kriterien partitioniert. Daher erreichen Sie bei Erreichen der maximalen Anzahl von Dateien in der Regel den maximalen Speicherplatz.

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

Das folgende Beispiel gibt an, dass 20 Protokolldateien aufbewahrt werden, und die Summe aller Dateien in jeder Kategorie beträgt nicht mehr als 50 MB Größe: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

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

Nein. Diese Aufbewahrungslogik gilt derzeit nur für neue Gatewayinstallationen. Vorhandene Gateways, die auf die Version vom Februar 2023 oder auf eine neuere Version aktualisiert werden, behalten ihre aktuelle Protokollaufbewahrungslogik (dateianzahlbasierte Aufbewahrung) bei.

Administratorzustimmung für die Gatewaydiagnose (Vorschau)

Die Administratorzustimmung für die Gatewaydiagnose ist ein Feature, mit dem Administratoren explizit steuern können, ob Diagnosedaten von lokalen Datengateways gesammelt und an die Cloud gesendet werden.

Das Gateway-Diagnosefeature führt ein zustimmungsgesteuertes Modell ein, um sicherzustellen, dass potenziell vertrauliche Daten, z. B. Mashup-Protokolle, erst nach der administrativen Genehmigung übertragen werden. Sie ermöglicht auch zukünftige Überwachungs- und Diagnosefunktionen. Derzeit gilt dieses Feature nur für Dataflows Gen2-Artefakte. Weitere Informationen finden Sie unter "Detaillierte Aktualisierungsprotokolle herunterladen".

So funktioniert es

Gatewayadministratoren können die Gatewaydiagnose in den Gatewayeinstellungen aktivieren. Wenn Sie diese Einstellung aktivieren, beginnt das Gateway mit dem Sammeln und Senden von Diagnosedaten an die Cloud.

Mandantenadministratoren bieten eine zusätzliche Governanceebene, indem sie die organisationsweite Zustimmung zur Diagnose steuern. Gatewayadministratoren können die Diagnose standardmäßig aktivieren, ohne dass eine Genehmigung auf Mandantenebene erforderlich ist. Mandantenadministratoren können jedoch jederzeit die Zustimmung widerrufen, um die Erfassung von Diagnosedaten über alle Gateways in der Organisation zu beenden.

Wenn die Zustimmung auf Mandantenebene widerrufen wird, beenden alle Gateways sofort das Senden von Diagnosedaten, und alle laufenden Datenübertragungen werden beendet.

Um die sofortige Durchsetzung zu gewährleisten, beendet das Neustarten des lokalen Datengateways alle laufenden Diagnose-Uploadvorgänge.

Der Dienst speichert die Gatewaydiagnosedaten 24 Stunden in einem vom Dienst verwalteten Azure Data Lake Storage. Nach 24 Stunden stehen die Daten nicht mehr zum Download zur Verfügung.

Uploadverhalten

Wenn Sie die Gateway-Diagnose aktivieren, lädt das Gateway Diagnosedateien in regelmäßigen Intervallen hoch. Uploads sind kein kontinuierliches Streaming und sind nicht in Echtzeit. Das Gateway prüft etwa alle 60 Sekunden, ob hochladbare Diagnosedateien vorhanden sind, sodass es zwischen der Ablaufverfolgungserstellung und der Verfügbarkeit im Microsoft-verwalteten Speicher in der Regel zu einer Verzögerung von etwa 1–2 Minuten kommt.

Jeder Upload ist eine kurzlebige ausgehende HTTPS-Anforderung vom Gatewaycomputer. Nachdem eine Diagnosedatei erfolgreich hochgeladen wurde, löscht das Gateway sofort die lokale Zwischenkopie.

Netzwerkanforderungen

Fügen Sie der Tabelle mit den Netzwerkanforderungen die folgende Zeile hinzu:

Das für den Diagnoseupload verwendete Speicherkonto wird Microsoft verwaltet und kann je nach Region variieren. Da der Kontoname regionsabhängig ist, lassen Sie ausgehenden HTTPS-Datenverkehr zu *.dfs.core.windows.net zu, oder verwenden Sie das Azure Storage Diensttag.

Wenn Ihre Umgebung einen TLS-inspecting-Proxy verwendet, stellen Sie sicher, dass der Proxy die vollständige Anforderungs-URL behält, einschließlich der SAS-Abfragezeichenfolge. Das SAS-Token ist erforderlich, damit das Gateway Diagnosedateien hochlädt.

Aktivieren der Gatewaydiagnose

Sie können die Gatewaydiagnose nur in der Cloud über "Verbindungen und Gateways verwalten" im Power BI-Dienst oder Microsoft Fabric aktivieren. Die lokale Datengatewayanwendung verfügt nicht über eine Einstellung zum Aktivieren dieses Features.

Überprüfen Sie vor dem Aktivieren der Gatewaydiagnose die folgenden Voraussetzungen:

• Das Gateway wird im Standardmodus ausgeführt. Gateways im persönlichen Modus werden nicht unterstützt.
• DIE ETW-Ablaufverfolgung ist auf dem Gateway aktiviert.
• Für Gatewaycluster lädt jedes Clustermitglied die Diagnose unabhängig hoch. Stellen Sie sicher, dass ausgehende Firewall- und Proxyregeln für jeden Gatewayknoten im Cluster konfiguriert sind.

Speicherplatz und Speicherbedarf

Stagingdaten für die Gatewaydiagnose werden im LOCALAPPDATA-Pfad des Gateway-Dienstkontos geschrieben, nicht im Gateway-Installationsverzeichnis. Der Unterordner "MSessions" enthält die lokalen Stagingdateien, die für den Diagnoseupload verwendet werden.

Im beständigen Zustand beträgt die lokale Aufbewahrung in der Regel etwa ein bis zwei Minuten, da Dateien unmittelbar nach dem erfolgreichen Upload gelöscht werden. In Ausfall- oder Wiederholungsszenarien können lokale Stagingdaten bis zu einer Stunde verbleiben.

Dieser Speicherbedarf ist vom dokumentierten lokalen Speicherbudget von 5 GB für Gateway-Protokolle getrennt und kommt zusätzlich dazu hinzu. Planen Sie für den Anfang auf jedem Gatewaycomputer etwa 5 bis 10 GB zusätzlichen freien Speicherplatz als Reserve ein, überwachen Sie dann die tatsächliche Nutzung in Ihrer Umgebung und passen Sie diese bei Bedarf an.

Sicherheitsstatus des Diagnoseuploads

Der Upload von Gateway-Diagnosedaten verwendet über HTTPS ein kurzlebiges, auf ein Verzeichnis beschränktes SAS-Token. Das SAS-Token ist für einen begrenzten Zeitraum gültig, derzeit bis zu neun Stunden und gewährt nur schreiborientierte Berechtigungen wie "Hinzufügen", "Schreiben" und "Erstellen".

Das Gateway kann Diagnosedateien hochladen, aber es kann keine hochgeladenen Diagnosedaten lesen, listen oder aufzählen.

Häufig gestellte Fragen zur Gatewaydiagnose für lokale Datengateways in Fabric

Die Diagnoseeinstellungen für lokale Datengateways dienen zum Erfassen detaillierter Diagnoseprotokolle zur Problembehandlung von Aktualisierungsvorgängen von Fabric Dataflow Gen2. Dieser Abschnitt beantwortet häufig gestellte Fragen dazu, wo hochgeladene Protokolle gespeichert werden, welche Informationen gesammelt werden, wer auf die Protokolle zugreifen kann und ob der Speicherplatz zusätzliche Kosten hat.

Ist zusätzliche Protokollierung für die Gatewaydiagnose erforderlich?

Gatewaydiagnose und zusätzliche Protokollierung sind separate Features. Für den Diagnoseupload ist keine zusätzliche Protokollierung erforderlich.

Die beiden Features schreiben an unterschiedliche Ziele: Die zusätzliche Protokollierung erstellt ausführlichere lokale Protokolle, während Gatewaydiagnosen Diagnosedaten lokal zwischenspeichern und sie nach Zustimmung des Mandanten und Aktivierung auf Gatewayebene in von Microsoft verwalteten Speicher hochladen.

Was ist der Zusammenhang zwischen den Diagnoseeinstellungen für lokale Datengateways und Dataflows?

Die lokalen Diagnoseeinstellungen für Datengateways gelten derzeit nur für Fabric Dataflow Gen2. Wenn eine Dataflow Gen2-Aktualisierung ausgeführt wird:

• Das Gateway sammelt Diagnoseinformationen, die für die Problembehandlung erforderlich sind.
• Das System lädt relevante Mashupprotokolle in Microsoft verwalteten Speicher hoch.
• Die Protokolle sind der Ausführung der Aktualisierung zugeordnet.
• Benutzer können die detaillierten Diagnosedaten im Aktualisierungsverlauf von Dataflow Gen2 herunterladen.

Diese Funktion kann auch zukünftige Diagnoseszenarien unterstützen.

Welche Protokolle werden gesammelt und hochgeladen?

Die Diagnoseeinstellungen für lokale Datengateways laden in erster Linie Mashup Engine-Protokolle hoch, die mit Fabric Dataflow Gen2-Aktualisierungsvorgängen verknüpft sind.

Beispiele für gesammelte Informationen sind:

• Ausführungsdetails der Dataflow Gen2-Aktualisierung.

• Diagnose der Mashup-Engine

• Abfrageverarbeitungs- und Ausführungsablaufverfolgungen.

Wo werden hochgeladene Protokolle gespeichert?

Die Power BI oder Fabric Anmelderegion des Mandanten bestimmt den Speicherort. Der von Microsoft verwaltete Speicher in der entsprechenden Mandantenregion speichert die hochgeladenen Protokolle.

Welche Azure Regionen unterstützen dieses Feature?

Alle Fabric unterstützten Regionen, die die verwaltete Speicherinfrastruktur bieten, unterstützen lokale Diagnoseeinstellungen für Datengateways. Dieses Feature ist in der Region Katar nicht verfügbar.

Enthält die hochgeladenen Daten vertrauliche Informationen?

Yes. Die hochgeladene Diagnose enthält möglicherweise Informationen, die Kunden als vertraulich betrachten. Die Funktion ist standardmäßig deaktiviert. Überprüfen Sie die Datenverarbeitungs- und Supportrichtlinien Ihrer Organisation, bevor Sie sich für lokale Datengateways-Diagnoseeinstellungen entscheiden.

Wie lange werden Protokolle gespeichert?

Das System speichert Diagnosedaten 24 Stunden lang. Sie können Daten aus Fabric Dataflow Gen2-Ausführungen innerhalb dieses 24-Stunden-Zeitraums herunterladen.

Wer kann auf hochgeladene Protokolle zugreifen?

Der Zugriff wird streng kontrolliert. Microsoft Mitarbeiter greifen nicht routinemäßig auf hochgeladene Protokolle zu. Der Zugriff ist standardmäßig eingeschränkt und wird nur gewährt, wenn dies unter genehmigten Betriebsverfahren erforderlich ist.

Gibt es zusätzliche Kosten zum Speichern dieser Protokolle?

Nein. Ab heute werden die Diagnoseeinstellungen für lokale Datengateways ohne zusätzliche Kosten bereitgestellt.

Troubleshooting

Die Diagnose ist aktiviert, aber es werden keine Protokolle angezeigt.

Wenn die Diagnose aktiviert ist, aber keine Diagnoseprotokolle angezeigt werden, überprüfen Sie die folgenden Elemente:

1. Bestätigen Sie den ausgehenden HTTPS-Zugriff auf Port 443 zu *.dfs.core.windows.net.

2. Vergewissern Sie sich, dass das Gateway im Standardmodus ausgeführt wird. Gateways im persönlichen Modus werden nicht unterstützt.

3. Bestätigen Sie, dass die Zustimmung des Mandanten zu den Gatewaydiagnosen nicht widerrufen wurde.

4. Überprüfen Sie GatewayInfo*.log auf Tracezeilen für DiagnosticsUploader und DiagnosticsStorageClient. Nützliche Tracemeldungen sind: N hochladbare Dateien gefunden, AuthenticationFailed, Maximale Anzahl von Fehlern erreicht

5. Wenn drei aufeinander folgende Uploadfehler auftreten, wird die Diagnosesammlung beendet, bis der Zugriff erneuert wird. Dieses Verhalten kann den Eindruck erwecken, als ob die Diagnosefunktion unerwartet deaktiviert worden wäre, obwohl die eigentliche Ursache wiederholte Fehler beim Hochladen sind.

Verwandte Inhalte

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