Konfigurer logfiler for datagatewayen i det lokale miljø

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 gateway-konfigurationsfilen Microsoft.PowerBI.EnterpriseGateway.exe.config, som som standard skal være placeret under \Program Files\On-premises data gateway.
2. Før du fortsætter, skal du oprette en kopi af filen, hvis du har brug for at gendanne den senere.
3. Find lyttefunktionen ApplicationFileTraceListener, som 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, der kan bruges af de tre logfiltyper.
• Den maksimale 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.

Filoptællingsbaseret opbevaring

Denne typografi 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).
• Maksimal diskplads pr. logtype (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

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

Følgende uddrag fra gateway-konfigurationsfilen indeholder Microsoft.PowerBI.EnterpriseGateway.exe.config de tre kategorier: GatewayInfo.log, GatewayErrors.log og 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).

Admin-samtykke til gateway-diagnostik (Forhåndsvisning)

Administratorsamtykke til gateway-diagnostik er en funktion, der gør det muligt for administratorer eksplicit at kontrollere, om diagnostiske data fra lokale datagateways indsamles og sendes til skyen.

Denne funktion introducerer en samtykkebaseret model for at sikre, at potentielt følsomme data – såsom Mashup-logs – kun sendes efter administrativ godkendelse. Det muliggør også fremtidig overvågning og diagnostik.

Når aktiveret:

• Diagnostiske data kan sikkert indsamles og behandles
• Et Fabric-arbejdsområde er tilknyttet gatewayen
• Arbejdsområdet er reserveret til fremtidige overvågnings- og diagnostikoplevelser

Sådan fungerer det

Gateway-administratorer aktiverer diagnostik i gateway-indstillinger og tilknytter et arbejdsområde Lejeradministratorer kan tilbagekalde samtykke når som helst, hvilket forhindrer alle gateways i lejeren i at deltage i diagnostikken

Diagnostisk dataflow håndhæves strengt:

• Ingen samtykke → ingen dataoverførsel

• Samtykke tilbagekaldt, → adgang stoppes

  

  

  

For øjeblikkelig håndhævelse afsluttes eventuelle igangværende diagnostiske uploads ved genstart af den lokale datagateway.

Relateret indhold

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