Del via

Konfigurer logfiler for datagatewayen i det lokale miljø

  • Artikel

Der er tre kategorier af tjenestelogge for en datagateway i det lokale miljø: oplysninger, fejl og netværk. Denne kategorisering giver dig en fejlfindingsoplevelse, hvor du kan fokusere på det specifikke område for en fejl eller et problem.

Hvis du vil kontrollere dine logføringskonfigurationer, skal du benytte følgende fremgangsmåde:

  1. Åbn gatewaykonfigurationsfilen Microsoft.PowerBI.EnterpriseGateway.exe.config, som som standard skal være placeret under \Programmer\Datagateway i det lokale miljø.
  2. Før du fortsætter, skal du oprette en kopi af filen, hvis du har brug for at gendanne den senere.
  3. Find den lyttefunktion ApplicationFileTraceListener , der er under system.diagnostics.

Følgende afsnit indeholder konfigurationsoplysningerne pr. opbevaringstype, som afhænger af din gatewayversion.

Aldersbaseret opbevaring

Fra og med februar 2023 blev det nye aldersbaserede opbevaringskoncept introduceret i en gateway. Dette koncept er standardopbevaringstypen for nye gatewayinstallationer.

For denne opbevaringstype er der to hovedaspekter, der skal overvejes (i prioriteret rækkefølge):

  • Den maksimale diskplads, der skal bruges af gatewaylogge (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log) med en standardværdi på 5 GB.
  • Opbevaringsperiode i dage med en standardværdi på 30 dage.

I denne nye logik sikrer vi, at der klargøres en ny logfil for hver ny dag. Denne klargøring sikrer, at oplysningerne for en given dag findes i logfiler, hvor filnavnet svarer til datoerne for logfilens post. Filpartitionen udføres også inden for dagen, hvis den maksimale individuelle filstørrelse (standard på 100 MB) er nået.

  <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 ændre standardværdierne for opbevaringsparametre, skal du justere dem i værdien initializeData . På følgende liste beskrives hver parameter:

  • Opbevaringsperiode i dage (en værdi mellem 1 og 365 dage).
  • Den maksimale samlede størrelse i MB, som kan bruges af de tre logfiltyper.
  • Maksimal størrelse i MB, som hver logfil kan have individuelt. Hver gang grænsen nås, oprettes der en ny fil med et sekventielt nummer tilføjet.

Bemærk

Gatewaylogge bruger UTC-baserede tidsstempel, og den daglige logfilrotation finder sted kl. 00:00 UTC.

Filoptællingsbaseret opbevaring

Dette var standardlogopbevaringslogikken i en gateway for versioner fra december 2022 og tidligere. Denne logik har to hovedbegreber:

  • Antal filer, der skal bevares pr. logtype (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
  • Den maksimale diskplads, der skal forbruges pr. logtype (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

Filerne er partitioneret i overensstemmelse hermed med de tidligere angivne kriterier, og når du når det maksimale antal filer, vil det derfor typisk også være på eller tæt på den maksimale diskplads.

Følgende uddrag fra gatewaykonfigurationsfilen Microsoft.PowerBI.EnterpriseGateway.exe.config indeholder de tre kategorier: 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>

Gatewaykonfigurationsfilen er som standard placeret i mappen \Programmer\Datagateway i det lokale miljø. Hvis du vil angive det antal logfiler, der skal bevares, skal du ændre det første tal i filens initializeData værdi. Hvis du vil konfigurere størrelsen på hver logfil, skal du ændre det andet tal.

I følgende eksempel angives det, at 20 logfiler, hvor summen af alle filer i hver kategori højst er 50 MB, bevares: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

Gælder den nye aldersbaserede opbevaringslogik som standard for min eksisterende installation af datagatewayen i det lokale miljø?

Nej. Denne opbevaringslogik anvendes nu på helt nye gatewayinstallationer. Eksisterende gateways, mens de opgraderes til februar 2023 eller nyere versioner, skal bevare deres aktuelle logopbevaringslogik (filoptællingsbaseret opbevaring).

Næste trin

Du kan finde oplysninger om, hvordan du eksporterer gatewaylogge til fejlfinding, under Fejlfindingsværktøjer.