Konfigurer logfiler for datagatewayen i det lokale miljø

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

Følg disse trin for at kontrollere dine logføringskonfigurationer:

1. Åbn konfigurationsfilen Microsoft.PowerBI.EnterpriseGateway.exe.configtil gatewayen . Du kan som standard finde denne fil under \Program Files\On-premises data gateway.
2. Opret 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 introducerer gatewayen et nyt aldersbaseret opbevaringskoncept. Dette koncept er standardopbevaringstypen for nye gatewayinstallationer.

I forbindelse med denne opbevaringstype skal du overveje to hovedaspekter (i prioriteret rækkefølge):

• Maksimal diskplads til 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 gatewayen, at den for hver ny dag opretter en ny logfil. Denne klargøring sikrer, at oplysningerne for en given dag findes i logfiler, hvor filnavnet svarer til datoerne for logfilens post. Gatewayen udfører også filpartitionering 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 parameterværdierne for opbevaring, skal du justere 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 de tre logfiltyper kan forbruge.
• Den maksimale størrelse i MB, som hver logfil kan have individuelt. Hver gang grænsen nås, opretter gatewayen 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 henhold til disse kriterier. Når du når det maksimale antal filer, når du derfor typisk 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 bevares, og summen af alle filer i hver kategori er højst 50 MB: 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 gælder i øjeblikket kun for nye gatewayinstallationer. Eksisterende gateways, der opgraderer til februar 2023 eller nyere versioner, bevarer deres aktuelle logopbevaringslogik (filoptællingsbaseret opbevaring).

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

Administratorsamtykke for gatewaydiagnosticering er en funktion, som administratorer bruger til eksplicit at styre, om diagnosticeringsdata fra datagateways i det lokale miljø indsamles og sendes til cloudmiljøet.

Funktionen Til gatewaydiagnosticering introducerer en samtykkebaseret model for at sikre, at potentielt følsomme data, f.eks. Mikslogge, kun overføres efter administrativ godkendelse. Det muliggør også fremtidig overvågning og diagnostik. Indtil videre gælder denne funktion kun for dataflow gen2-artefakt. Du kan finde flere oplysninger under Download detaljerede opdateringslogge.

Sådan fungerer det

Gatewayadministratorer kan aktivere gatewaydiagnosticering i gatewayindstillingerne. Når du aktiverer denne indstilling, begynder gatewayen at indsamle og sende diagnosticeringsdata til cloudmiljøet.

Lejeradministratorer giver et ekstra lag af styring ved at styre organisationens samtykke til diagnosticering. Gatewayadministratorer kan som standard aktivere diagnosticering uden at skulle godkende på lejerniveau. Dog kan lejeradministratorer til enhver tid tilbagekalde samtykke for at stoppe indsamling af diagnostiske data på alle gateways i organisationen.

Hvis samtykke på lejerniveau tilbagekaldes, stopper alle gateways straks med at sende diagnostiske data, og enhver igangværende dataoverførsel afsluttes.

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

Tjenesten gemmer gatewaydiagnosticeringsdata i 24 timer i et Azure Data Lake Storage, der administreres af tjenesten. Efter 24 timer er dataene ikke længere tilgængelige til download.

Funktionsmåde for upload

Når du aktiverer gatewaydiagnosticering, uploader gatewayen diagnosticeringsfiler i periodiske batches. Uploads er ikke kontinuerlig streaming og er ikke i realtid. Gatewayen kontrollerer, om der er uploadbare diagnosticeringsfiler ca. hvert 60. sekund, så der er typisk en forsinkelse på ca. 1-2 minutter mellem sporingsgenerering og tilgængelighed i Microsoft-administreret lager.

Hver upload er en kortlivet udgående HTTPS-anmodning fra gatewaycomputeren. Når en diagnosticeringsfil er overført, sletter gatewayen straks den lokale midlertidige kopi.

Netværkskrav

Føj følgende række til tabellen med netværkskrav:

Den lagerkonto, der bruges til upload af diagnosticering, administreres Microsoft og kan variere efter område. Da kontonavnet er områdeafhængigt, kan du tillade udgående HTTPS-trafik til *.dfs.core.windows.net eller bruge Azure Storage-tjenestekoden.

Hvis dit miljø bruger en TLS-inspektionsproxy, skal du sørge for, at proxyen bevarer den fulde URL-adresse til anmodningen, herunder SAS-forespørgselsstrengen. SAS-tokenet er påkrævet, for at gatewayen kan uploade diagnosticeringsfiler.

Aktivér gatewaydiagnosticering

Du kan kun aktivere gatewaydiagnosticering i cloudmiljøet fra Administrer forbindelser og gateways i Power BI-tjeneste eller Microsoft Fabric. Programmet til datagateway i det lokale miljø har ikke en indstilling for at aktivere denne funktion.

Før du aktiverer gatewaydiagnosticering, skal du kontrollere følgende forudsætninger:

• Gatewayen kører i standardtilstand. Gateways i personlig tilstand understøttes ikke.
• ETW-sporing er aktiveret på gatewayen.
• For gatewayklynger uploader hvert klyngemedlem diagnosticering uafhængigt af hinanden. Sørg for, at udgående firewall- og proxyregler er konfigureret for alle gatewaynoder i klyngen.

Diskplads og lagerfodaftryk

Midlertidige data til gatewaydiagnosticering skrives under gatewaytjenestekontoens LOCALAPPDATA-sti og ikke i gatewayinstallationsmappen. MSessions-undermappen indeholder de lokale midlertidige filer, der bruges til overførsel af diagnosticering.

I konstant tilstand er lokal opbevaring typisk omkring et til to minutter, fordi filer slettes umiddelbart efter vellykket upload. I scenarier med fejl eller forsøg kan lokale midlertidige data forblive i op til ca. en time.

Dette lagerfodaftryk er adskilt fra og additivt til det lokale logopbevaringsbudget på 5 GB, der er dokumenteret for gatewaylogge. Som udgangspunkt skal du planlægge ca. 5 til 10 GB ekstra ledig diskplads på hver gatewaycomputer og derefter overvåge det faktiske forbrug i dit miljø og justere efter behov.

Sikkerhedsholdning af upload af diagnosticering

Upload af gatewaydiagnosticering bruger et kortlivet SAS-token med adresseliste over HTTPS. SAS-tokenet er gyldigt i en begrænset periode, i øjeblikket op til ni timer, og giver kun skriveorienterede tilladelser, f.eks. Tilføj, Skriv og Opret.

Gatewayen kan uploade diagnosticeringsfiler, men den kan ikke læse tilbage, vise eller optælle uploadede diagnosticeringsdata.

Ofte stillede spørgsmål om gatewaydiagnosticering for datagateways i det lokale miljø i Fabric

Indstillinger for diagnosticering i det lokale miljø hjælper med at indsamle detaljerede diagnosticeringslogge til fejlfinding Fabric opdateringshandlinger for Dataflow Gen2. I dette afsnit besvares almindelige spørgsmål om, hvor uploadede logge gemmes, hvilke oplysninger der indsamles, hvem der kan få adgang til loggene, og om lageret har ekstra omkostninger.

Kræves der yderligere logføring til gatewaydiagnosticering?

Gatewaydiagnosticering og yderligere logføring er separate funktioner. Yderligere logføring er ikke påkrævet til overførsel af diagnosticering.

De to funktioner skriver til forskellige destinationer: Yderligere logføring skriver mere detaljerede lokale logge, mens gatewaydiagnosticering faser diagnosticeringsdata lokalt og uploader dem til Microsoft-administreret lager efter lejersamtykke og aktivering på gatewayniveau.

Hvad er relationen mellem datagateways i det lokale miljø Indstillinger for diagnosticering og dataflow?

Indstillingerne for diagnosticering i det lokale miljø gælder i øjeblikket kun for Fabric Dataflow Gen2. Når en Opdatering af Dataflow Gen2 kører:

• Gatewayen indsamler diagnosticeringsoplysninger, der kræves til fejlfinding.
• Systemet uploader relevante mikslogge for at Microsoft-administreret lager.
• Loggene er knyttet til udførelsen af opdateringen.
• Brugerne kan downloade den detaljerede diagnosticering fra historikken for opdatering af Dataflow Gen2.

Denne funktion understøtter muligvis også fremtidige diagnosticeringsscenarier.

Hvilke logge indsamles og uploades?

I øjeblikket uploader diagnosticeringsindstillinger for datagateways i det lokale miljø primært Mashup Engine-logge, der er knyttet til Fabric Dataflow Gen2-opdateringshandlinger.

Eksempler på indsamlede oplysninger omfatter:

• Oplysninger om udførelse af dataflow Gen2 opdateres.

• Miksmaskinediagnosticering.

• Forespørgselsbehandlings- og udførelsessporinger.

Hvor gemmes uploadede logge?

Lejerens Power BI eller Fabric tilmeldingsområde bestemmer lagringsplaceringen. Microsoft-administreret lager i det relevante lejerområde gemmer de overførte logge.

Hvilke Azure områder understøtter denne funktion?

Alle Fabric-understøttede områder, der tilbyder den administrerede lagerinfrastruktur, understøtter datagateways i det lokale miljø Diagnosticeringsindstillinger. Denne funktion er ikke tilgængelig i området Qatar.

Indeholder de overførte data følsomme oplysninger?

Ja. Overført diagnosticering kan indeholde oplysninger, som kunderne anser for følsomme. Denne funktion er deaktiveret som standard. Gennemse organisationens politikker for datahåndtering og -support, før du vælger indstillinger for datagateways i det lokale miljø Diagnosticering.

Hvor længe gemmes loggene?

Systemet bevarer diagnosticeringsdata i 24 timer. Du kan downloade data fra Fabric Dataflow Gen2 kører i løbet af denne 24-timers periode.

Hvem kan få adgang til uploadede logge?

Adgangen er stramt kontrolleret. Microsoft medarbejdere får ikke rutinemæssigt adgang til overførte logge. Adgangen er som standard begrænset og gives kun, når det er nødvendigt i henhold til godkendte driftsprocedurer.

Er der yderligere omkostninger ved lagring af disse logge?

Nej. Fra og med i dag leveres indstillinger for diagnosticering i det lokale miljø uden ekstra omkostninger.

Fejlfinding

Diagnosticering er aktiveret, men der vises ingen logge

Hvis diagnosticering er aktiveret, men diagnosticeringslogge ikke vises, skal du kontrollere følgende elementer:

1. Bekræft udgående HTTPS-adgang på port 443 til *.dfs.core.windows.net.

2. Bekræft, at gatewayen kører i standardtilstand. Gateways i personlig tilstand understøttes ikke.

3. Bekræft, at lejersamtykke for gatewaydiagnosticering ikke er tilbagekaldt.

4. Kontrollér GatewayInfo*.log for sporingslinjer for DiagnosticsUploader og DiagnosticsStorageClient. Nyttige sporingsmeddelelser omfatter: Fundne N-filer, der kan overføres, AuthenticationFailed, Det maksimale antal fejl, der er nået

5. Hvis der opstår tre uploadfejl efter hinanden, stopper indsamlingen af diagnosticering, indtil adgangen fornyes. Denne funktionsmåde kan få diagnosticering til at se ud til at være blevet deaktiveret uventet, selvom hovedårsagen er gentaget overførselsfejl.

Relateret indhold

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