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 innehåller konfigurationsinformationen per kvarhållningstyp, som är beroende av din gatewayversion.

Å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. Även filpartitionen inom dagen utförs 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.

Kommentar

Gatewayloggar använder UTC-baserade tidsstämplar och den dagliga loggfilrotationen sker kl. 00:00 UTC.

Filantalsbaserad kvarhållning

Detta var standardlogik för loggkvarhållning i en gateway för versionerna 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, och när du når det maximala antalet filer är det vanligtvis också på eller nära maximalt diskutrymme.

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

Kommer den nya åldersbaserade kvarhållningslogik som standard att gälla för min befintliga lokala datagatewayinstallation?

Nej. Den här kvarhållningslogik för tillfället tillämpas på helt nya gatewayinstallationer. Befintliga gatewayer vid uppgradering till februari 2023 eller senare versioner bör behålla sin aktuella loggkvarhållningslogik (filantalbaserad kvarhållning).

Nästa steg

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