Logboekbestanden configureren voor de on-premises gegevensgateway

Er zijn drie categorieën servicelogboeken voor een on-premises gegevensgateway: informatie, fout en netwerk. Deze categorisatie biedt een probleemoplossingservaring waarmee u zich kunt richten op het specifieke gebied voor een fout of probleem.

Voer de volgende stappen uit om uw logboekconfiguraties te controleren:

1. Open het gatewayconfiguratiebestand Microsoft.PowerBI.EnterpriseGateway.exe.config, dat zich standaard moet bevinden onder \Program Files\On-premises gegevensgateway.
2. Voordat u verdergaat, maakt u een kopie van dit bestand voor het geval u het later moet herstellen.
3. Zoek de listener ApplicationFileTraceListener onder system.diagnostics.

De volgende secties bevatten de configuratiegegevens per bewaartype, die afhankelijk zijn van uw gatewayversie.

Retentie op basis van leeftijd

Vanaf februari 2023 is het nieuwe concept voor retentie op basis van leeftijd binnen een gateway geïntroduceerd. Dit concept is het standaardretentietype voor nieuwe gatewayinstallaties.

Voor dit bewaartype zijn er twee belangrijke aspecten die u moet overwegen (in volgorde van prioriteit):

• Maximale schijfruimte die moet worden verbruikt door gatewaylogboeken (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log), met een standaardwaarde van 5 GB.
• Bewaarperiode in dagen, met een standaardwaarde van 30 dagen.

In deze nieuwe logica zorgen we ervoor dat er voor elke nieuwe dag een nieuw logboekbestand wordt ingericht. Deze inrichting zorgt ervoor dat de informatie voor een bepaalde dag aanwezig is in logboekbestanden waarin de bestandsnaam overeenkomt met de datums van de logboekvermelding. De bestandspartitie binnen de dag wordt ook uitgevoerd als de maximale afzonderlijke bestandsgrootte (standaard 100 MB) is bereikt.

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

Als u de standaardwaarden voor retentieparameters wilt wijzigen, moet u deze in de initializeData waarde aanpassen. In de volgende lijst wordt elke parameter beschreven:

• Bewaarperiode in dagen (een waarde tussen 1 en 365 dagen).
• Maximale totale grootte in MB die kan worden gebruikt door de drie logboekbestandstypen.
• Maximale grootte in MB die elk logboekbestand afzonderlijk kan hebben. Telkens wanneer de limiet wordt bereikt, wordt er een nieuw bestand gemaakt met een volgnummer toegevoegd.

Notitie

Gatewaylogboeken maken gebruik van tijdstempels op basis van UTC en de dagelijkse rotatie van logboekbestanden vindt plaats om 00:00 UTC.

Retentie op basis van het aantal bestanden

Dit was de standaardlogica voor logboekretentie binnen een gateway voor versies van december 2022 en eerder. Deze logica heeft twee hoofdconcepten:

• Aantal bestanden dat moet worden bewaard per logboektype (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
• Maximale schijfruimte die per logboektype moet worden verbruikt (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

De bestanden worden dienovereenkomstig gepartitioneerd met de eerder vermelde criteria en daarom, wanneer u het maximum aantal bestanden bereikt, is het meestal ook op of dicht bij de maximale schijfruimte.

Het volgende fragment uit het gatewayconfiguratiebestand Microsoft.PowerBI.EnterpriseGateway.exe.config bevat de drie categorieën: GatewayInfo.log, GatewayErrors.logen 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>

Het configuratiebestand van de gateway bevindt zich standaard in de map \Program Files\On-premises gegevensgateway. Als u het aantal logboekbestanden wilt instellen dat moet worden bewaard, wijzigt u het eerste getal in de waarde van initializeData het bestand. Als u de grootte van elk logboekbestand wilt configureren, wijzigt u het tweede getal.

In het volgende voorbeeld wordt aangegeven dat 20 logboekbestanden, het totaal van alle bestanden in elke categorie niet meer dan 50 MB groot zijn, behouden blijven: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

Wordt de bewaarlogica op basis van nieuwe leeftijd standaard toegepast op de installatie van mijn bestaande on-premises gegevensgateway?

Nee Deze bewaarlogica wordt nu toegepast op volledig nieuwe gatewayinstallaties. Bestaande gateways tijdens een upgrade naar februari 2023 of nieuwere versies moeten hun huidige logica voor het bewaren van logboeken behouden (bewaarbeleid op basis van het aantal bestanden).

Volgende stappen

Ga naar Hulpprogramma's voor probleemoplossing voor informatie over het exporteren van gatewaylogboeken.