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\On-premises data gateway.
2. Než budete pokračovat, vytvořte kopii tohoto souboru jenom v případě, že ho budete potřebovat později obnovit.
3. Vyhledejte posluchač ApplicationFileTraceListener, který je pod 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, které mají spotřebovat protokoly z 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ý logovací soubor. Toto zajištění zajišťuje, že informace pro daný den se nacházejí v souborech protokolu, kde název souboru odpovídá datům záznamů položky protokolu. Pokud je během dne dosaženo maximální velikosti jednotlivého souboru (výchozí hodnota je 100 MB), je soubor také rozdělen.

  <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íhá v 00:00 UTC.

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

Tento styl byl výchozí logikou uchovávání protokolů v rámci brány pro verze z prosince 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 rozděleny odpovídajícím způsobem s dříve uvedenými kritérii. Proto pokaždé, když dosáhnete maximálního počtu souborů, obvykle je to 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

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

Ne. Tato logika uchovávání informací se prozatím aplikuje na zcela nové instalace brány. Aktuální brány při aktualizaci na verzi z února 2023 nebo novější by měly zachovat stávající logiku uchovávání logů (uchovávání na základě počtu souborů).

Související obsah

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