Konfigurere loggfiler for den lokale datagatewayen

Artikkel
05/06/2024

Det finnes tre kategorier med tjenestelogger for en lokal datagateway: informasjon, feil og nettverk. Denne kategoriseringen gir en feilsøkingsopplevelse som lar deg fokusere på det bestemte området for en feil eller et problem.

Gjør følgende for å kontrollere loggingskonfigurasjonene:

Åpne gatewaykonfigurasjonsfilen Microsoft.PowerBI.EnterpriseGateway.exe.config, som som standard bør være plassert under \Programfiler\Lokal datagateway.
Før du fortsetter videre, må du lage en kopi av denne filen i tilfelle du må gjenopprette den senere.
Finn lytteren ApplicationFileTraceListener som er under system.diagnostics.

De følgende delene inneholder konfigurasjonsdetaljene per oppbevaringstype, som avhenger av gateway-versjonen.

Aldersbasert oppbevaring

Fra og med februar 2023 ble det nye aldersbaserte oppbevaringskonseptet i en gateway introdusert. Dette konseptet er standard oppbevaringstype for nye gateway-installasjoner.

For denne oppbevaringstypen er det to hovedaspekter å vurdere (i rekkefølge av prioritet):

Maksimal diskplass som skal brukes av gatewaylogger (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log), med en standardverdi på 5 GB.
Oppbevaringsperiode i dager, med en standardverdi på 30 dager.

I denne nye logikken sikrer vi at for hver ny dag klargjøres en ny loggfil. Denne klargjøringen sikrer at informasjonen for en gitt dag finnes i loggfiler der filnavnet samsvarer med loggoppføringsdatoene. Filpartisjonen utføres også i løpet av dagen hvis den maksimale individuelle filstørrelsen (standard på 100 MB) er nådd.

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

Hvis du vil endre standard parameterverdier for oppbevaring, bør du justere dem i initializeData verdien. Følgende liste beskriver hver parameter:

Oppbevaringsperiode i dager (en verdi mellom 1 og 365 dager).
Maksimal total størrelse i MB som kan brukes av de tre loggfiltypene.
Maksimal størrelse i MB som hver loggfil kan ha individuelt. Hver gang grensen nås, opprettes en ny fil med et sekvensielt tall tilføyet.

Merk

Gateway-logger bruker UTC-baserte tidsstempel, og den daglige loggfilrotasjonen finner sted kl. 00:00 UTC.

Filantallbasert oppbevaring

Dette var standard logikk for oppbevaring av logg i en gateway for versjoner desember 2022 og tidligere. Denne logikken har to hovedkonsepter:

Antall filer som skal beholdes per loggtype (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
Maksimal diskplass som skal brukes per loggtype (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

Filene partisjoneres tilsvarende med de tidligere oppførte kriteriene, og når du når maksimalt antall filer, vil det vanligvis også være på eller nær maksimal diskplass.

Følgende utdrag fra gatewaykonfigurasjonsfilen Microsoft.PowerBI.EnterpriseGateway.exe.config inneholder de tre kategoriene: GatewayInfo.log, GatewayErrors.logog 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>

Gatewaykonfigurasjonsfilen er som standard plassert i katalogen \Programfiler\Lokal datagateway. Hvis du vil angi hvor mange loggfiler som skal beholdes, endrer du det første tallet i filens initializeData verdi. Hvis du vil konfigurere størrelsen på hver loggfil, endrer du det andre tallet.

Følgende eksempel angir at 20 loggfiler, summen av alle filene i hver kategori som ikke er mer enn 50 MB, beholdes: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

Gjelder den nye aldersbaserte oppbevaringslogikken som standard for den eksisterende lokale datagatewayinstallasjonen?

Nei. Denne oppbevaringslogikken brukes for øyeblikket på helt nye gateway-installasjoner. Eksisterende gatewayer under oppgradering til februar 2023 eller senere versjoner bør beholde gjeldende loggoppbevaringslogikk (filantallbasert oppbevaring).

Neste trinn

Hvis du vil ha informasjon om hvordan du eksporterer gatewaylogger for feilsøking, kan du gå til feilsøkingsverktøy.

Del via