Overvåge og optimere ydeevne for datagateways i det lokale miljø

Overvågning af gatewayens ydeevne (offentlig prøveversion)

Hvis du vil overvåge ydeevnen, er gatewayadministratorer traditionelt afhængige af at kunne overvåge ydeevnetællere manuelt via værktøjet Windows-værktøjet til overvågning af ydeevne. Vi tilbyder nu yderligere logføring af forespørgsler og en PBI-skabelonfil for ydeevne for gateways til at præsentere resultaterne. Denne funktion giver ny indsigt i brugen af gateways. Du kan bruge den til at foretage fejlfinding af forespørgsler med langsom ydeevne.

Bemærk

Denne funktion er i øjeblikket kun tilgængelig i standardtilstand for gatewayen i det lokale miljø. Den er ikke tilgængelig i personlig tilstand.

Logføring af ydeevne

Denne funktion er nu som standard slået til. Du kan deaktivere denne funktion ved at foretage følgende ændringer af filen Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config i mappen \Programmer\Datagateway i det lokale miljø.

Bemærk

  • Forespørgsler fra Premium-kapacitet til gatewayen er i øjeblikket ikke altid medtaget i denne logføring. Vi arbejder på en rettelse af problemet.
  • Power BI-sideinddelte rapportforespørgsler logføres i øjeblikket ikke ved hjælp af dette værktøj.
  1. Egenskaben DisableQueryExecutionReport er som standard angivet til False for at gøre det muligt at aktivere yderligere logføring for forespørgsler, der køres ved hjælp af gatewayen. Dette opretter både rapporten Kørsel af forespørgsel og rapportfilerne til sammenlægning af forespørgselsudførelse. Hvis du vil deaktivere denne funktion, skal du skifte flaget til True.

    <setting name="DisableQueryExecutionReport" serializeAs="String">
      <value>False</value>
    </setting>
    
  2. DisableSystemCounterReport er angivet som standard til False for at gøre det muligt at aktivere yderligere logføring for hukommelse og CPU-systemets tællere. Derved oprettes rapportfilerne til sammenlægning af systemtælleren. Hvis du vil deaktivere denne funktion, skal du skifte flaget til True.

    <setting name=" DisableSystemCounterReport" serializeAs="String">
      <value>False</value>
    </setting>
    

Konfigurere logføring af ydeevne

Der er andre værdier i konfigurationsfilen, som du kan opdatere efter behov:

  • ReportFilePath: Angiver den sti, hvor de tre logfiler er gemt. Denne sti er som standard enten \Users\PBIEgwService\AppData\Local\Microsoft\On-Premises data gateway\Report eller \Windows\ServiceProfiles\PBIEgwService\AppData\Local\Microsoft\On-Premises data gateway\Report. Stien afhænger af operativsystemversionen. Hvis du bruger en anden tjenestekonto til gatewayen end PBIEgwService, skal du erstatte denne del af stien med tjenestekontonavnet.
  • ReportFileCount: Angiver antallet af hver type logfiler, som skal bevares. Standardværdien er 10.
  • ReportFileSizeInBytes: Angiver størrelsen på den fil, der skal bevares. Standardværdien er 104,857,600.
  • QueryExecutionAggregationTimeInMinutes: Angiver det antal minutter, som forespørgslens kørselsoplysninger samles for. Standardværdien er 5.
  • SystemCounterAggregationTimeInMinutes: Angiver det antal minutter, som systemtælleren samles for. Standardværdien er 5.

Når du har foretaget ændringerne af konfigurationsfilen, skal du genstarte gatewayen, for at konfigurationsværdierne kan træde i kraft. Du kan nu se, at rapportfilerne genereres på den placering, du har angivet for ReportFilePath.

Bemærk

Det kan tage op til 10 minutter plus den tidsrum, der er angivet for QueryExecutionAggregationTimeInMinutes i konfigurationsfilen, før filer begynder at blive vist i mappen.

Forstå logfiler for ydeevne

Når du slår denne funktion til, oprettes der tre nye logfiler:

  • Rapporten for udførelse af forespørgsel
  • Rapporten for start af forespørgsel
  • Rapporten for aggregering af forespørgsel
  • Rapporten for aggregering af systemtæller

Rapporten for udførelse af forespørgsel indeholder detaljerede kørselsoplysninger for forespørgslen. Følgende attributter er registreret.

Attribut Beskrivelse
GatewayObjectId Entydigt id for gatewayen.
RequestId Entydigt id for en gatewayanmodning. Det kan være det samme for flere forespørgsler.
DataSource Indeholder både datakildetypen og datakilden.
QueryTrackingId Entydigt id for en forespørgsel. Det gentages dog, hvis en forespørgsel mislykkes og prøves igen.
QueryExecutionEndTimeUTC Det tidspunkt, hvor udførelsen af forespørgslen blev fuldført.
QueryExecutionDuration (msek.) Varighed for udførelse af en forespørgsel.
QueryType Forespørgselstype. Den overførte forespørgsel vil f.eks. kunne være en Power BI-opdatering eller en DirectQuery. Det kan også være forespørgsler fra Power Apps og Power Automate.
DataProcessingEndTimeUTC Det tidspunkt, hvor databehandlingsaktiviteter, f. eks. spooling, hentning af data, komprimering og databehandling er fuldført.
DataProcessingDuration (msek.) Varigheden af databehandlingsaktiviteter som f. eks. spooling, hentning af data, komprimering og databehandling.
Fuldført Angiver, om forespørgslen lykkedes eller mislykkedes.
ErrorMessage Hvis forespørgslen mislykkedes, angives fejlmeddelelsen.
SpoolingDiskWritingDuration (msek.) Angiver, hvor længe gatewayen er om at skrive alle data til disken
SpoolingDiskReadingDuration (msek.) Angiver, hvor længe gatewayen er om at læse alle data til disken
SpoolingTotalDataSize (byte) Størrelse (komprimeret) af data, som skrives til/læses fra disken
DataReadingAndSerializationDuration (msek.) Angiver, hvor længe gatewayen er om at læse data fra datakilden og serialisere dem til pakker.
DiskRead (byte/sek.) Angiver antal byte, som er læst af gatewayen pr. sekund. DiskRead(byte/sek.) = SpoolingTotalDataSize/SpoolingDiskReadingDuration
DiskWrite (byte/sek.) Angiver antal byte, som er skrevet af gatewayen pr. sekund. DiskWrite(byte/sek.) = SpoolingTotalDataSize/SpoolingDiskWritingDuration

Rapporten for start af forespørgsel indeholder forespørgslen og starttidspunktet for forespørgslen. Følgende attributter er registreret.

Attribut Beskrivelse
GatewayObjectId Entydigt id for gatewayen.
RequestId Entydigt id for en gatewayanmodning. Det kan være det samme for flere forespørgsler.
DataSource Indeholder både datakildetypen og datakilden.
QueryTrackingId Entydigt id for en forespørgsel. Det gentages dog, hvis en forespørgsel mislykkes og prøves igen.
QueryExecutionStartTimeUTC Det tidspunkt, hvor udførelsen af forespørgslen blev startet.
QueryType Forespørgselstype. Den overførte forespørgsel vil f.eks. kunne være en Power BI-opdatering eller en DirectQuery. Det kan også være forespørgsler fra Power Apps og Power Automate.
QueryText Komplet forespørgsel kodet med base64.

Rapporten for aggregering af udførelse af forespørgsel indeholder aggregerede forespørgselsoplysninger for et tidsinterval defineret af GatewayObjectId, DataSource, Success og QueryType. Standardværdien er 5 minutter, men du kan justere den. Følgende attributter er registreret.

Attribut Beskrivelse
GatewayObjectId Entydigt id for gatewayen.
AggregationStartTimeUTC Starttidspunktet for det tidsrum, hvor forespørgselsattributterne blev aggregeret.
AggregationEndTimeUTC Sluttidspunktet for det tidsrum, hvor forespørgselsattributterne blev aggregeret.
DataSource Indeholder både datakildetypen og datakilden.
Fuldført Angiver, om forespørgslen lykkedes eller mislykkedes.
AverageQueryExecutionDuration (msek.) Gennemsnitlig tid for forespørgsels udførelse i tidsrummet for aggregering.
MaxQueryExecutionDuration (msek.) Maksimal tid for forespørgsels udførelse i tidsrummet for aggregering.
MinQueryExecutionDuration (msek.) Minimal tid for forespørgsels udførelse i tidsrummet for aggregering.
QueryType Forespørgselstype. Den overførte forespørgsel vil f.eks. kunne være en Power BI-opdatering eller en DirectQuery. Det kan også være forespørgsler fra Power Apps og Power Automate.
AverageDataProcessingDuration (msek.) Gennemsnitlig tid for databehandlingsaktiviteter som f.eks. spooling, hentning af data, komprimering og databehandling i tidsrummet for aggregeringen.
MaxDataProcessingDuration (msek.) Maksimal tid for databehandlingsaktiviteter som f.eks. spooling, hentning af data, komprimering og databehandling i tidsrummet for aggregeringen.
MinDataProcessingDuration (msek.) Minimal tid for databehandlingsaktiviteter som f.eks. spooling, hentning af data, komprimering og databehandling i tidsrummet for aggregeringen.
Antal Antal forespørgsler.

Rapporten for aggregering af systemtæller indeholder system tællerværdier, der er aggregeret for et tidsrum. Standardværdien er 5 minutter, men du kan justere den. Følgende attributter er registreret.

Attribut Beskrivelse
GatewayObjectId Entydigt id for gatewayen.
AggregationStartTimeUTC Starttidspunkt for tidsrum for de systemtællere, der blev aggregeret.
AggregationEndTimeUTC Sluttidspunkt for tidsrum for de systemtællere, der blev aggregeret.
CounterName Systemtællere, som omfatter forbrug af hukommelse og CPU for gatewayen, miks-programmet og samlet for den computer, der er vært for gatewayen.
Maks. Maksimumværdi for systemtælleren i tidsrummet for aggregering.
Min. Minimumværdi for systemtælleren i tidsrummet for aggregering.
Gennemsnitlig Gennemsnitsværdi for systemtælleren i tidsrummet for aggregering.

Visualisere gateways ydeevne

Nu kan du få visualisere de data, der er i logfilerne.

  1. Hent PBI-skabelonen for gatewayens ydeevne, og åbn den ved hjælp af Power BI Desktop.

  2. Kontrollér, at mappestien stemmer overens med værdien i ReportFilePath i den dialogboks, der åbnes.

    Pop op-vindue for mappestien.

  3. Vælg Indlæs, hvorefter skabelonfilen begynder at indlæse dataene fra dine logfiler. Alle visuelle elementer udfyldes ved hjælp af dataene i rapporterne.

  4. Du kan også gemme filen som en PBIX og udgive den til din tjeneste, hvis du vil have automatiske opdateringer. Du kan få flere oplysninger i Udgiv datasæt og rapporter fra Power BI Desktop.

Du kan også tilpasse skabelonfilen, så den passer til dine behov. Du kan finde flere oplysninger om Power BI-skabeloner i dette Microsoft Power BI-blogindlæg.

Forespørgsler med langsom ydeevne

Forespørgsler, der kører i lang tid, kan kræve yderligere ændringer af datakilden eller yderligere optimering af selve forespørgslen. Det kan enten være for Power BI-opdateringer eller direkte databaseforespørgsler som f.eks. Power BI DirectQuery, Power Apps eller Azure Logic Apps.

Gatewayen udfører som standard grundlæggende logføring. Hvis du undersøger forespørgsler med langsom ydeevne, kan du ud over at bruge funktionen til overvågning af ydeevnen midlertidigt aktivere Supplerende logføring for at indsamle flere logoplysninger. Til dette formål skal du vælge Diagnose > Supplerende logføring i appen Datagateway i det lokale miljø.

Slå supplerende logføring til.

Når du aktiverer denne indstilling, øges logstørrelsen sandsynligvis markant, baseret på brugen af gatewayen. Vi anbefaler, at du deaktiverer supplerende logføring, når du er færdig med at gennemse logfilerne. Vi anbefaler ikke, at du lader indstillingen forblive aktiveret under normal brug af gatewayen.

Når du slår denne indstilling til, kan du se flere oplysninger (programkonteksten i følgende eksempel) i de gatewaylogfiler, der angiver, hvilke datasæt eller hvilken rapport denne forespørgsel tilhører. Bemærk, at ikke alle tjenester er i stand til at sende disse oplysninger på nuværende tidspunkt, og vi arbejder på at identificere de forskellige tjenester.

QueryAdditionalInformation is: {
  "Application": "Dataset-Premium",
  "ObjectId": "6de5b524-8a04-4578-961d-e65b2bf3dcd4",
  "ApplicationContext": "{\"DatasetId\":\"6de5b524-8a04-4578-961d-ej67gdf3dcd4\",\"Sources\":[{\"ReportId\":\"e0cec7bc-f53d-4174-b551-678656fba\"}]}"
}.

Næste trin