Monitorování a optimalizace výkonu místní brány dat

Monitorování výkonu brány (Public Preview)

Správci brány obvykle ručně monitorují čítače výkonu pomocí nástroje Sledování výkonu systému Windows. Nyní nabízíme další protokolování dotazů a Soubor šablony PBI výkonu brány pro vizualizaci výsledků. Tato funkce poskytuje nové přehledy o používání brány. Můžete ji použít k řešení problémů se zdlouhavými dotazy.

Poznámka

Tato funkce je aktuálně k dispozici pouze pro místní bránu dat ve standardním režimu. Není k dispozici pro osobní režim.

Šablona PBI byla aktualizována, aby vyhovovala novým atributům, a bude moci vizualizovat protokoly generované až v únoru 2020 a později.

Povolení protokolování výkonu

Pro povolení této funkce proveďte následující změny v souboru Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config dostupném ve složce \Program Files\On-premises data gateway.

Poznámka

V současné době jsou v tomto protokolování někdy vynechány dotazy z kapacity Premium na bránu. Aktivně pracujeme na opravě tohoto problému.

  1. Vlastnost DisableQueryExecutionReport je ve výchozím nastavení nastavena na False, čímž je povoleno dodatečné protokolování pro dotazy prováděné pomocí brány. Tím se vytvoří jak sestava provedení dotazu, tak soubory sestavy agregace provedení dotazu. Chcete-li tuto funkci vypnout, přepněte příznak na True.

    <setting name="DisableQueryExecutionReport" serializeAs="String">
      <value>False</value>
    </setting>
    
  2. DisableSystemCounterReport má ve výchozím nastavení hodnotu False, čímž je povoleno dodatečné protokolování systémových čítačů paměti a CPU. Tím se vytvoří soubor sestavy agregace systémových čítačů. Chcete-li tuto funkci vypnout, přepněte příznak na True.

    <setting name=" DisableSystemCounterReport" serializeAs="String">
      <value>False</value>
    </setting>
    
  3. V konfiguračním souboru jsou další hodnoty, které můžete podle potřeby aktualizovat:

    • ReportFilePath: Určuje cestu, kde jsou uloženy tři soubory protokolu. Ve výchozím nastavení je tato cesta buď \Users\PBIEgwService\AppData\Local\Microsoft\On-premises data gateway\Report nebo \Windows\ServiceProfiles\PBIEgwService\AppData\Local\Microsoft\On-premises data gateway\Report. Cesta závisí na verzi operačního systému. Používáte-li pro bránu jiný účet služby než PBIEgwService, nahraďte tuto část cesty názvem účtu služby.
    • ReportFileCount: Určuje počet souborů protokolu každého druhu, které se mají uchovat. Výchozí hodnota je 10.
    • ReportFileSizeInBytes: Určuje velikost souboru, který chcete zachovat. Výchozí hodnota je 104,857,600.
    • QueryExecutionAggregationTimeInMinutes: Určuje počet minut, za které jsou agregovány informace o provádění dotazu. Výchozí hodnota je 5.
    • SystemCounterAggregationTimeInMinutes: Určuje počet minut, za které je agregován systémový čítač. Výchozí hodnota je 5.
  4. Po provedení změn v konfiguračním souboru restartujte bránu, aby se tyto konfigurační hodnoty projevily. Nyní uvidíte soubory zpráv generované v umístění, které jste určili pro ReportFilePath.

    Poznámka

    Může to trvat až 10 minut plus čas stanovený pro QueryExecutionAggregationTimeInMinutes v konfiguračním souboru, dokud se soubory nezačnou zobrazovat ve složce.

Principy protokolů výkonu

Po zapnutí této funkce se vytvoří tři nové soubory protokolu:

  • Sestava provedení dotazu
  • Sestava spuštění dotazu
  • Sestava agregace provedení dotazu
  • Sestava agregace čítače systému

Sestava provedení dotazu obsahuje podrobné informace o provádění dotazu. Jsou zachyceny následující atributy.

Atribut Popis
GatewayObjectId Jedinečný identifikátor brány.
RequestId Jedinečný identifikátor požadavku brány. Může být stejný pro více dotazů.
DataSource Obsahuje jak typ zdroje dat, tak zdroj dat.
QueryTrackingId Jedinečný identifikátor dotazu. Může se však opakovat, pokud dotaz selže a je opakován.
QueryExecutionEndTimeUTC Čas, kdy bylo provádění dotazu dokončeno.
QueryExecutionDuration (ms) Doba trvání provedení dotazu.
QueryType Typ dotazu. Například předaný dotaz může být aktualizace Power BI nebo DirectQuery. Nebo to mohou být dotazy Power Apps a Power Automate.
DataProcessingEndTimeUTC Čas, kdy jsou dokončeny činnosti zpracování dat, jako je zařazování, získávání dat, komprese a zpracování dat.
DataProcessingDuration (ms) Doba trvání pro zpracování dat, jako je zařazování, získávání dat, komprese a zpracování dat.
Úspěch Udává, zda byl dotaz úspěšný nebo neúspěšný.
ErrorMessage Pokud dotaz selhal, označuje chybovou zprávu.
SpoolingDiskWritingDuration (ms) Udává dobu, po kterou brána zapíše všechna data na disk
SpoolingDiskReadingDuration (ms) Udává dobu, po kterou brána načte všechna data z disku
SpoolingTotalDataSize (bajty) Velikost (komprimovaná) dat, která se zapisují/čtou z disku
DataReadingAndSerializationDuration (ms) Označuje dobu, kterou brána potřebuje ke čtení dat ze zdroje dat a jejich serializaci do paketů.
DiskRead (bajt/s) Označuje bajty načtené bránou za sekundu. DiskRead(byte/sec) = SpoolingTotalDataSize / SpoolingDiskReadingDuration
DiskWrite (bajt/s) Označuje bajty zapsané bránou za sekundu. DiskWrite(byte/sec) = SpoolingTotalDataSize / SpoolingDiskWritingDuration

Sestava spuštění dotazu obsahuje dotaz a čas zahájení dotazu. Jsou zachyceny následující atributy.

Atribut Popis
GatewayObjectId Jedinečný identifikátor brány.
RequestId Jedinečný identifikátor požadavku brány. Může být stejný pro více dotazů.
DataSource Obsahuje jak typ zdroje dat, tak zdroj dat.
QueryTrackingId Jedinečný identifikátor dotazu. Může se však opakovat, pokud dotaz selže a je opakován.
QueryExecutionStartTimeUTC Čas, kdy bylo provádění dotazu zahájeno.
QueryType Typ dotazu. Například předaný dotaz může být aktualizace Power BI nebo DirectQuery. Nebo to mohou být dotazy Power Apps a Power Automate.
QueryText Kompletní dotaz kódovaný jako base64.

Sestava agregace provedení dotazů obsahuje informace o dotazech agregované do časového intervalu podle GatewayObjectId, DataSource, Success a QueryType. Výchozí hodnota je 5 minut, ale můžete ji upravit. Jsou zachyceny následující atributy.

Atribut Popis
GatewayObjectId Jedinečný identifikátor brány.
AggregationStartTimeUTC Začátek časového okna, pro které byly agregovány atributy dotazu.
AggregationEndTimeUTC Konec časového okna, pro které byly agregovány atributy dotazu.
DataSource Obsahuje jak typ zdroje dat, tak zdroj dat.
Úspěch Udává, zda byl dotaz úspěšný nebo neúspěšný.
AverageQueryExecutionDuration (ms) Průměrná doba provedení dotazu pro časové okno agregace.
MaxQueryExecutionDuration (ms) Maximální doba provedení dotazu pro časové okno agregace.
MinQueryExecutionDuration (ms) Minimální doba provedení dotazu pro časové okno agregace.
QueryType Typ dotazu. Například předaný dotaz může být aktualizace Power BI nebo DirectQuery. Nebo to mohou být dotazy Power Apps a Power Automate.
AverageDataProcessingDuration (ms) Průměrná doba zpracování dat, jako je zařazování, získávání dat, komprese a zpracování dat pro časové okno agregace.
MaxDataProcessingDuration (ms) Maximální doba zpracování dat, jako je zařazování, získávání dat, komprese a zpracování dat pro časové okno agregace.
MinDataProcessingDuration (ms) Minimální doba zpracování dat, jako je zařazování, získávání dat, komprese a zpracování dat pro časové okno agregace.
Počet Počet dotazů.

Sestava agregace čítače systému obsahuje hodnoty systémových čítačů agregované do časového intervalu. Výchozí hodnota je 5 minut, ale můžete ji upravit. Jsou zachyceny následující atributy.

Atribut Popis
GatewayObjectId Jedinečný identifikátor brány.
AggregationStartTimeUTC Začátek časového okna pro čítače systému, které byly agregovány.
AggregationEndTimeUTC Konec časového okna pro čítače systému, které byly agregovány.
CounterName Systémové čítače, které zahrnují využití paměti a CPU bránou, modulem hybridní webové aplikace a celkově počítačem hostujícím bránu.
Maximum Maximální hodnota pro čítač systému pro časové okno agregace.
Minimum Minimální hodnota pro čítač systému pro časové okno agregace.
Průměr Průměrná hodnota pro čítač systému pro časové okno agregace.

Vizualizace výkonu brány

Nyní si můžete vizualizovat data, která jsou v souborech protokolu.

  1. Stáhněte si šablonu PBI výkonu brány a otevřete jej pomocí Power BI Desktop.

  2. V otevřeném dialogovém okně zkontrolujte, zda cesta ke složce odpovídá hodnotě v ReportFilePath.

    Místní okno pro cestu ke složce

  3. Vyberte Načíst a soubor šablony začne načítat data ze souborů protokolu. Všechny vizuální prvky jsou vyplněny daty v sestavách.

  4. Volitelně uložte tento soubor jako PBIX a publikujte jej do své služby pro zajištění automatických aktualizací. Další informace viz Publikování datových sad a sestav z Power BI Desktop.

Tento soubor šablony můžete také přizpůsobit vašim potřebám. Více informací o šablonách Power BI viz tento blogový příspěvek o Microsoft Power BI.

Pomalu prováděné dotazy

Dlouze se provádějící dotazy mohou vyžadovat další úpravu vašeho zdroje dat nebo další optimalizaci samotného dotazu. To se může týkat buď aktualizací Power BI nebo přímých dotazů na databázi, jako Power BI DirectQuery, Power Apps nebo Azure Logic Apps.

Ve výchozím nastavení provádí brána základní protokolování. Pokud zkoumáte pomalu prováděné dotazy, můžete kromě funkce sledování výkonu také dočasně povolit Další protokolování a shromažďovat další informace v protokolu. Chcete-li to provést, v aplikaci místní brány dat vyberte Diagnostika > Další protokolování.

Zapnutí dalšího protokolování

Povolením tohoto nastavení se pravděpodobně výrazně zvýší velikost protokolu v závislosti na využití brány. Doporučujeme, abyste po zkontrolování protokolů vypnuli dodatečné protokolování. Během normálního používání brány nedoporučujeme toto nastavení nechávat zapnuté.

Další kroky