Konfigurera loggfiler för den lokala datagatewayen

Det finns tre kategorier av tjänstloggar för en lokal datagateway: information, fel och nätverk. Den här kategoriseringen ger en felsökningsupplevelse som gör att du kan fokusera på det specifika området för ett fel eller problem.

Utför följande steg för att kontrollera loggningskonfigurationerna:

1. Öppna gatewaykonfigurationsfilen Microsoft.PowerBI.EnterpriseGateway.exe.config, som som standard ska finnas under \Program Files\On-premises data gateway.
2. Innan du fortsätter gör du en kopia av den här filen ifall du behöver återställa den senare.
3. Leta upp lyssnaren ApplicationFileTraceListener, som finns under system.diagnostics.

Följande avsnitt ger konfigurationsdetaljer per behållningstyp, beroende på vilken gatewayversion du har.

Åldersbaserad kvarhållning

Från och med februari 2023 introducerades det nya åldersbaserade kvarhållningskonceptet inom en gateway. Det här konceptet är standardkvarhållningstypen för nya gatewayinstallationer.

För den här kvarhållningstypen finns det två huvudsakliga aspekter att tänka på (i prioritetsordning):

• Maximalt diskutrymme som ska förbrukas av gatewayloggar (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log) med ett standardvärde på 5 GB.
• Kvarhållningsperiod i dagar, med ett standardvärde på 30 dagar.

I den här nya logiken ser vi till att för varje ny dag etableras en ny loggfil. Den här etableringen säkerställer att informationen för en viss dag finns i loggfiler där filnamnet matchar logginmatningsdatumen. Dessutom utförs filpartitionen inom dagen om den maximala enskilda filstorleken (standardvärdet är 100 MB) nås.

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

Om du vill ändra standardparametrarna för kvarhållning bör du justera dem i värdet initializeData . I följande lista beskrivs varje parameter:

• Kvarhållningsperiod i dagar (ett värde mellan 1 och 365 dagar).
• Maximal total storlek i MB som kan användas av de tre loggfilstyperna.
• Maximal storlek i MB som varje loggfil kan ha individuellt. Varje gång gränsen nås skapas en ny fil med ett sekventiellt nummer.

Filantalsbaserad kvarhållning

Det här formatet var standardlogik för loggkvarhållning i en gateway för versioner december 2022 och tidigare. Den här logiken har två huvudkoncept:

• Antal filer som ska behållas per loggtyp (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
• Maximalt diskutrymme som ska förbrukas per loggtyp (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

Filerna partitioneras i enlighet med de tidigare angivna kriterierna. När du når det maximala antalet filer är det därför vanligtvis på eller nära det maximala diskutrymmet.

Följande utdrag från gatewaykonfigurationsfilen Microsoft.PowerBI.EnterpriseGateway.exe.config innehåller de tre kategorierna: GatewayInfo.log, GatewayErrors.logoch 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>

Som standard finns gatewaykonfigurationsfilen i katalogen \Program Files\On-premises data gateway. Om du vill ange hur många loggfiler som ska behållas ändrar du det första talet i filens initializeData värde. Om du vill konfigurera storleken på varje loggfil ändrar du det andra talet.

I följande exempel anges att 20 loggfiler, summan av alla filer i varje kategori som inte är större än 50 MB, behålls: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

Gäller den nya åldersbaserade kvarhållningslogik som standard för min befintliga lokala datagatewayinstallation?

Nej. Den här kvarhållningslogiken tillämpas för tillfället på helt nya gatewayinstallationer. Befintliga gateways när de uppgraderar till februari 2023 eller senare versioner bör behålla sin nuvarande loggkvarhållningslogik (baserat på antal filer).

Relaterat innehåll

Information om hur du exporterar gatewayloggar för felsökning finns i Felsökningsverktyg.