Udostępnij za pośrednictwem

Konfigurowanie plików dziennika dla lokalnej bramy danych

  • Artykuł

Istnieją trzy kategorie dzienników usług dla lokalnej bramy danych: informacje, błąd i sieć. Ta kategoryzacja zapewnia środowisko rozwiązywania problemów, które pozwala skupić się na określonym obszarze dla błędu lub problemu.

Aby sprawdzić konfiguracje rejestrowania, wykonaj następujące kroki:

  1. Otwórz plik konfiguracji bramy Microsoft.PowerBI.EnterpriseGateway.exe.config, który domyślnie powinien znajdować się w folderze \Program Files\On-premises data gateway.
  2. Przed kontynuowaniem utwórz kopię tego pliku na wypadek, gdy trzeba go przywrócić później.
  3. Znajdź odbiornik ApplicationFileTraceListener , który znajduje się w obszarze system.diagnostics.

Poniższe sekcje zawierają szczegóły konfiguracji dla typu przechowywania, który zależy od wersji bramy.

Przechowywanie na podstawie wieku

Począwszy od lutego 2023 r., wprowadzono nową koncepcję przechowywania na podstawie wieku w ramach bramy. Ta koncepcja jest domyślnym typem przechowywania dla nowych instalacji bramy.

W przypadku tego typu przechowywania należy wziąć pod uwagę dwa główne aspekty (w kolejności pierwszeństwa):

  • Maksymalna ilość miejsca na dysku do użycia przez dzienniki bramy (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log), z wartością domyślną 5 GB.
  • Okres przechowywania w dniach z wartością domyślną 30 dni.

W tej nowej logice upewniamy się, że dla każdego nowego dnia aprowizowany jest nowy plik dziennika. Ta aprowizacja zapewnia, że informacje dotyczące danego dnia są obecne w plikach dziennika, w których nazwa pliku jest zgodna z datami wprowadzania dziennika. Ponadto partycja pliku w ciągu dnia jest wykonywana, jeśli zostanie osiągnięty maksymalny rozmiar pojedynczego pliku (domyślnie 100 MB).

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

Jeśli chcesz zmienić wartości parametrów domyślnych przechowywania, należy je dostosować w initializeData wartości. Poniższa lista zawiera opis każdego parametru:

  • Okres przechowywania w dniach (wartość z zakresu od 1 do 365 dni).
  • Maksymalny całkowity rozmiar w MB, który może być używany przez trzy typy plików dziennika.
  • Maksymalny rozmiar w MB, który każdy plik dziennika może mieć indywidualnie. Za każdym razem, gdy limit zostanie osiągnięty, zostanie utworzony nowy plik z dołączonym numerem sekwencyjnym.

Uwaga

Dzienniki bramy używają sygnatur czasowych utc, a dzienny obrót pliku dziennika odbędzie się o 00:00 UTC.

Przechowywanie na podstawie liczby plików

Była to domyślna logika przechowywania dzienników w bramie w wersjach z grudnia 2022 r. i starszych. Ta logika ma dwa główne pojęcia:

  • Liczba plików do przechowywania według typu dziennika (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
  • Maksymalna ilość miejsca na dysku do użycia na typ dziennika (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

Pliki są odpowiednio podzielone na partycje z wcześniej wymienionymi kryteriami, a zatem zawsze, gdy osiągniesz maksymalną liczbę plików, zwykle będzie on również zbliżony do maksymalnej ilości miejsca na dysku.

Poniższy fragment pliku konfiguracji bramy Microsoft.PowerBI.EnterpriseGateway.exe.config zawiera trzy kategorie: GatewayInfo.log, GatewayErrors.logi 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>

Domyślnie plik konfiguracji bramy znajduje się w katalogu \Program Files\On-premises data gateway. Aby ustawić liczbę plików dziennika do zachowania, zmień pierwszą liczbę w wartości pliku initializeData . Aby skonfigurować rozmiar każdego pliku dziennika, zmień drugą liczbę.

Poniższy przykład określa, że 20 plików dziennika, suma wszystkich plików w każdej kategorii nie przekracza 50 MB rozmiaru, zostanie zachowana: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

Czy logika przechowywania na podstawie nowego wieku będzie domyślnie stosowana do mojej istniejącej lokalnej bramy danych?

Nie Ta logika przechowywania jest teraz stosowana do całkowicie nowych instalacji bramy. Istniejące bramy podczas uaktualniania do lutego 2023 r. lub nowszych wersji powinny zachować bieżącą logikę przechowywania dziennika (przechowywanie na podstawie liczby plików).

Następne kroki

Aby uzyskać informacje na temat eksportowania dzienników bramy na potrzeby rozwiązywania problemów, zobacz Narzędzia do rozwiązywania problemów.