Konfigurace souborů protokolu pro místní bránu dat

Pro místní bránu dat existují tři kategorie protokolů služby: informace, chyba a síť. Tato kategorizace poskytuje prostředí pro řešení potíží, které vám umožní zaměřit se na konkrétní oblast chyby nebo problému.

Pokud chcete zkontrolovat konfigurace protokolování, proveďte následující kroky:

1. Otevřete konfigurační soubor brány Microsoft.PowerBI.EnterpriseGateway.exe.config, který by se ve výchozím nastavení měl nacházet ve složce \Program Files\Místní brána dat.
2. Než budete pokračovat, vytvořte kopii tohoto souboru jenom v případě, že ho budete potřebovat později obnovit.
3. Vyhledejte naslouchací procesApplicationFileTraceListener, pod kterým je .system.diagnostics

Následující části obsahují podrobnosti o konfiguraci pro jednotlivé typy uchovávání informací, které závisí na vaší verzi brány.

Uchovávání podle věku

Od února 2023 byl zaveden nový koncept uchovávání informací na základě věku v rámci brány. Tento koncept je výchozím typem uchovávání informací pro nové instalace brány.

Pro tento typ uchovávání existují dva hlavní aspekty, které je potřeba vzít v úvahu (v pořadí podle priority):

• Maximální místo na disku spotřebované protokoly brány (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log) s výchozí hodnotou 5 GB.
• Doba uchovávání ve dnech s výchozí hodnotou 30 dnů.

V této nové logice zajistíme, aby se každý nový den zřídil nový soubor protokolu. Toto zřizování zajišťuje, že informace pro daný den se nacházejí v souborech protokolu, kde název souboru odpovídá kalendářním datům položky protokolu. Pokud dosáhnete maximální velikosti jednotlivých souborů (výchozí hodnota 100 MB), provede se také oddíl souboru v daném dni.

  <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>

Pokud chcete změnit výchozí hodnoty parametrů uchovávání, měli byste je upravit v hodnotě initializeData . Každý parametr popisuje následující seznam:

• Doba uchovávání ve dnech (hodnota mezi 1 a 365 dny)
• Maximální celková velikost v MB, kterou můžou využívat tři typy souborů protokolu.
• Maximální velikost v MB, kterou může mít každý soubor protokolu zvlášť. Při každém dosažení limitu se vytvoří nový soubor s připojeným pořadovým číslem.

Poznámka:

Protokoly brány používají časová razítka založená na standardu UTC a denní obměna souborů protokolu proběhne v 00:00 UTC.

Uchovávání na základě počtu souborů

Toto byla výchozí logika uchovávání protokolů v rámci brány pro verze prosinec 2022 a starší. Tato logika má dva hlavní koncepty:

• Počet souborů, které se mají uchovávat podle typu protokolu (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
• Maximální využité místo na disku podle typu protokolu (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

Soubory jsou odpovídajícím způsobem rozděleny podle dříve uvedených kritérií, a proto pokaždé, když dosáhnete maximálního počtu souborů, bude obvykle také v blízkosti maximálního místa na disku.

Následující výňatek z konfiguračního souboru brány Microsoft.PowerBI.EnterpriseGateway.exe.config obsahuje tři kategorie: GatewayInfo.log, GatewayErrors.loga 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>

Ve výchozím nastavení se konfigurační soubor brány nachází v adresáři \Program Files\Místní brána dat. Pokud chcete nastavit počet souborů protokolu, které se mají zachovat, změňte první číslo v hodnotě initializeData souboru. Pokud chcete nakonfigurovat velikost každého souboru protokolu, změňte druhé číslo.

Následující příklad určuje, že se zachová 20 souborů protokolu, celkový součet všech souborů v každé kategorii o velikosti maximálně 50 MB: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

Bude logika uchovávání informací na základě nového věku ve výchozím nastavení platit pro stávající instalaci místní brány dat?

Č. Tato logika uchovávání informací se prozatím aplikuje na zcela nové instalace brány. Stávající brány při upgradu na únor 2023 nebo novější verze by měly zachovat aktuální logiku uchovávání protokolů (uchovávání na základě počtu souborů).

Další kroky

Informace o tom, jak exportovat protokoly brány pro řešení potíží, najdete v tématu Nástroje pro řešení potíží.