Konfigurer loggfiler for den lokale datagatewayen

Den lokale datagatewayen har tre kategorier med tjenestelogger: informasjon, feil og nettverk. Denne kategoriseringen gir en feilsøkingsopplevelse som du kan fokusere på det bestemte området for en feil eller et problem.

Følg disse trinnene for å kontrollere loggingskonfigurasjonene:

1. Åpne konfigurasjonsfilen Microsoft.PowerBI.EnterpriseGateway.exe.configfor gatewayen. Som standard finner du denne filen under \Program Files\On-premises data gateway.
2. Lag en kopi av denne filen i tilfelle du må gjenopprette den senere.
3. Finn lytteren ApplicationFileTraceListener, som er under system.diagnostics.

Følgende seksjoner gir konfigurasjonsdetaljer per retensjonstype, som avhenger av gateway-versjonen din.

Aldersbasert bevaring

Fra og med februar 2023 introduserer gatewayen et nytt tidsbasert oppbevaringskonsept. Dette konseptet er standard oppbevaringstype for nye gateway-installasjoner.

For denne oppbevaringstypen bør du vurdere to hovedaspekter (i rekkefølgen av prioritet):

• Maksimal diskplass for 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 gatewayen at den for hver nye dag oppretter en ny loggfil. Denne provisioneringen sikrer at informasjonen for en gitt dag er til stede i loggfiler der filnavnet samsvarer med loggoppføringsdatoene. Gatewayen utfører også filpartisjonering 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, justerer du initializeData verdien. Følgende liste beskriver hver parameter:

• Oppbevaringstid i dager (en verdi mellom 1 og 365 dager).
• Maksimal total størrelse i MB som de tre loggfiltypene kan bruke.
• Maksimal størrelse i MB som hver loggfil kan ha individuelt. Hver gang grensen er nådd, oppretter gatewayen en ny fil med et sekvensielt tall tilføyet.

Filantallsbasert oppbevaring

Denne stilen var standard logretensjonslogikk 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 forbrukes per loggtype (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

Filene er partisjonert i henhold til disse kriteriene. Når du når maksimalt antall filer, når du vanligvis maksimal diskplass.

Følgende utdrag fra gateway-konfigurasjonsfilen inneholder Microsoft.PowerBI.EnterpriseGateway.exe.config de tre kategoriene: 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>

Som standard ligger gateway-konfigurasjonsfilen i mappen \Program Files\On-premises data gateway. For å sette antall loggfiler som skal beholdes, endre det første tallet i filens initializeData verdi. For å konfigurere størrelsen på hver loggfil, endre det andre tallet.

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

Gjelder den nye tidsaldersbaserte retensjonslogikken som standard for min eksisterende lokale datagateway-installasjon?

Nei. Denne oppbevaringslogikken gjelder for øyeblikket bare for nye gateway-installasjoner. Eksisterende gatewayer som oppgraderer til februar 2023 eller senere versjoner, beholder den gjeldende logikken for oppbevaring av loggen (filantallbasert oppbevaring).

Administratorsamtykke for gateway-diagnostikk (Forhåndsvisning)

Administratorsamtykke for gatewaydiagnose er en funksjon som administratorer bruker til eksplisitt å kontrollere om diagnosedata fra lokale datagatewayer samles inn og sendes til skyen.

Gateway Diagnostic-funksjonen introduserer en samtykkedrevet modell for å sikre at potensielt sensitive data, for eksempel Mashup-logger, bare sendes etter administrativ godkjenning. Det muliggjør også fremtidig overvåking og diagnostikk. For øyeblikket gjelder denne funksjonen bare for Dataflyter Gen2-artefakt. Hvis du vil ha mer informasjon, kan du se Laste ned detaljerte oppdateringslogger.

Slik fungerer det

Gatewayadministratorer kan aktivere gateway-diagnostikk i gateway-innstillingene. Når du aktiverer denne innstillingen, begynner gatewayen å samle inn og sende diagnosedata til skyen.

Leieradministratorer gir et ekstra lag med styring ved å kontrollere organisasjonens samtykke for diagnostikk. Gatewayadministratorer kan som standard aktivere diagnostikk uten å måtte godkjenne leiernivå. Leietakeradministratorer kan imidlertid når som helst trekke tilbake samtykke for å stoppe innsamling av diagnostiske data på tvers av alle gatewayer i organisasjonen.

Hvis samtykke på leietakernivå trekkes tilbake, slutter alle gatewayer umiddelbart å sende diagnostiske data, og all pågående dataoverføring avsluttes.

For umiddelbar håndhevelse avslutter omstart av den lokale datagatewayen alle pågående diagnoseopplastinger.

Tjenesten lagrer diagnosedata for gateway i 24 timer i en Azure Data Lake Storage som administreres av tjenesten. Etter 24 timer er ikke dataene lenger tilgjengelige for nedlasting.

Opplastingsvirkemåte

Når du aktiverer gateway-diagnostikk, laster gatewayen opp diagnosefiler i periodiske grupper. Opplastinger er ikke kontinuerlig strømming og er ikke i sanntid. Gatewayen ser etter opplastbare diagnosefiler omtrent hvert 60. sekund, så det er vanligvis en forsinkelse på ca. 1–2 minutter mellom sporingsgenerering og tilgjengelighet i Microsoft administrert lagringsplass.

Hver opplasting er en kortvarig utgående HTTPS-forespørsel fra gateway-maskinen. Når en diagnosefil er lastet opp, sletter gatewayen umiddelbart den lokale oppsamlingskopien.

Nettverkskrav

Legg til følgende rad i tabellen for nettverkskrav:

Lagringskontoen som brukes til opplasting av diagnoser, er Microsoft administrert og kan variere etter område. Fordi kontonavnet er områdeavhengig, kan du tillate utgående HTTPS-trafikk til *.dfs.core.windows.net eller bruke Azure Storage-tjenestekoden.

Hvis miljøet bruker en TLS-undersøkende proxy, må du kontrollere at proxyen bevarer nettadressen for hele forespørselen, inkludert SAS-spørringsstrengen. SAS-tokenet kreves for at gatewayen skal kunne laste opp diagnosefiler.

Aktiver gatewaydiagnose

Du kan bare aktivere gateway-diagnostikk i skyen fra Administrer tilkoblinger og gatewayer i Power Bi-tjeneste eller Microsoft Fabric. Det lokale datagatewayprogrammet har ingen innstilling for å aktivere denne funksjonen.

Før du aktiverer gateway-diagnostikk, må du kontrollere følgende forutsetninger:

• Gatewayen kjører i standardmodus. Gatewayer for personlig modus støttes ikke.
• ETW-sporing er aktivert på gatewayen.
• For gatewayklynger laster hvert klyngemedlem opp diagnostikk uavhengig av hverandre. Kontroller at utgående brannmur og proxy-regler er konfigurert for hver gatewaynode i klyngen.

Diskplass og lagringsplass

Klargjøringsdata for gatewaydiagnose er skrevet under gateway-tjenestekontoens LOCALAPPDATA-bane, ikke installasjonskatalogen for gatewayen. Undermappen MSessions inneholder de lokale oppsamlingsfilene som brukes til opplasting av diagnoser.

I jevn tilstand er lokal oppbevaring vanligvis omtrent ett til to minutter fordi filene slettes umiddelbart etter vellykket opplasting. I feil- eller forsøksscenarioer kan lokale oppsamlingsdata forbli i opptil omtrent én time.

Dette lagringsavtrykket er atskilt fra, og additive til, det lokale loggoppbevaringsbudsjettet på 5 GB dokumentert for gatewaylogger. Som utgangspunkt kan du planlegge om lag 5 til 10 GB ekstra ledig diskplass på hver gateway-maskin, og deretter overvåke faktisk bruk i miljøet og justere etter behov.

Sikkerhetsstilling for opplasting av diagnostikk

Gatewaydiagnoseopplasting bruker et kortvarig, katalogomfanget SAS-token over HTTPS. SAS-tokenet er gyldig i en begrenset periode, for øyeblikket opptil ni timer, og gir bare skriveorienterte tillatelser som Legg til, Skriv og Opprett.

Gatewayen kan laste opp diagnosefiler, men den kan ikke leses opp, liste opp eller nummerere opplastede diagnosedata.

Vanlige spørsmål om gatewaydiagnose for lokale datagatewayer i Fabric

Diagnoseinnstillingene for lokale datagatewayer bidrar til å samle inn detaljerte diagnoselogger for feilsøking Fabric oppdateringsoperasjoner for dataflyt gen2. Denne delen svarer på vanlige spørsmål om hvor opplastede logger lagres, hvilken informasjon som samles inn, hvem som har tilgang til loggene, og om lagringsplass har ekstra kostnader.

Kreves ytterligere logging for Gateway-diagnostikk?

Gatewaydiagnose og tilleggslogging er separate funksjoner. Tilleggslogging kreves ikke for opplasting av diagnoser.

De to funksjonene skriver til forskjellige mål: Ytterligere logging skriver mer detaljerte lokale logger, mens gatewaydiagnose stadier diagnosedata lokalt og laster det opp til Microsoft administrert lagring etter leiersamtykke og gateway-nivå aktivering.

Hva er relasjonen mellom lokale diagnosedatainnstillinger for datagatewayer og dataflyter?

Diagnoseinnstillingene for lokale datagatewayer gjelder for øyeblikket bare for Fabric Dataflyt gen2. Når en Dataflyt Gen2-oppdatering kjøres:

• Gatewayen samler inn diagnosedata som kreves for feilsøking.
• Systemet laster opp relevante mashup-logger til Microsoft administrert lagringsplass.
• Loggene knytter seg til oppdateringskjøringen.
• Brukere kan laste ned den detaljerte diagnosen fra oppdateringsloggen for dataflyt gen2.

Denne funksjonen kan også støtte fremtidige diagnosescenarioer.

Hvilke logger samles inn og lastes opp?

For øyeblikket laster diagnoseinnstillinger for lokale datagatewayer primært opp mashup-motorlogger som er knyttet til Fabric oppdateringsoperasjoner for Dataflyt Gen2.

Eksempler på innsamlede opplysninger inkluderer:

• Informasjon om kjøring av dataflyt gen2-oppdatering.

• Diagnostikk for mashup-motor.

• Spørringsbehandlings- og kjøringssporinger.

Hvor lagres opplastede logger?

Leierens Power BI eller Fabric registreringsområde bestemmer lagringsplasseringen. Microsoft administrert lagring i gjeldende leierområde lagrer de opplastede loggene.

Hvilke Azure områder støtter denne funksjonen?

Alle Fabric støttede områder som tilbyr den administrerte lagringsinfrastrukturen, støtter lokale diagnoseinnstillinger for datagatewayer. Denne funksjonen er ikke tilgjengelig i Qatar-regionen.

Inneholder de opplastede dataene sensitiv informasjon?

Ja. Opplastede diagnostikker kan inneholde informasjon som kundene anser som sensitive. Funksjonen er deaktivert som standard. Se gjennom organisasjonens policyer for databehandling og støtte før du velger lokale diagnosedatainnstillinger for datagatewayer.

Hvor lenge lagres logger?

Systemet beholder diagnosedata i 24 timer. Du kan laste ned data fra Fabric Dataflyt Gen2-kjøringer i løpet av denne 24-timers perioden.

Hvem har tilgang til opplastede logger?

Tilgangen er tett kontrollert. Microsoft personell får ikke rutinemessig tilgang til opplastede logger. Tilgang er begrenset som standard og gis bare når det er nødvendig under godkjente driftsprosedyrer.

Er det noen ekstra kostnader for lagring av disse loggene?

Nei. Fra og med i dag tilbys lokale diagnosedatainnstillinger for datagatewayer uten ekstra kostnad.

Feilsøking

Diagnostikk er aktivert, men ingen logger vises

Hvis diagnostikk er aktivert, men diagnoselogger ikke vises, kontrollerer du følgende elementer:

1. Bekreft utgående HTTPS-tilgang på port 443 til *.dfs.core.windows.net.

2. Bekreft at gatewayen kjører i standardmodus. Gatewayer for personlig modus støttes ikke.

3. Bekreft at leiersamtykke for gatewaydiagnose ikke er tilbakekalt.

4. Kontroller gatewayInfo*.log for sporingslinjer for DiagnosticsUploader og DiagnosticsStorageClient. Nyttige sporingsmeldinger inkluderer: Fant N opplastbare filer, AuthenticationFailed, maksimalt antall feil nådd

5. Hvis det oppstår tre påfølgende opplastingsfeil, stopper diagnosesamlingen til tilgangen fornyes. Denne virkemåten kan få diagnoser til å se ut til å ha slått av uventet, selv om årsaken er gjentatt opplastingsfeil.

Relatert innhold

Hvis du vil ha informasjon om hvordan du eksporterer gatewaylogger for feilsøking, kan du se Feilsøkingsverktøy.