Konfigurowanie plików dziennika dla lokalnej bramy danych

Istnieją trzy kategorie dzienników usług dla lokalnej bramy danych: informacje, błąd i sieć. Ta kategoryzacja zapewnia doświadczenie rozwiązywania problemów, pozwalające skupić się na określonym obszarze związanym z błędem lub problemem.

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 w zależności od typu przechowywania, który jest zależny od wersji twojej 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 retencji 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 tworzony 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 w ciągu dnia wykonywany jest podział pliku, jeśli zostanie osiągnięty maksymalny rozmiar 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 domyślnych parametrów przechowywania, powinieneś je dostosować do wartości w initializeData. 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.

Przechowywanie na podstawie liczby plików

Strategia ta była domyślną logiką przechowywania dzienników w bramie dla wersji z grudnia 2022 r. i wcześniejszych. 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 wykorzystania na każdy typ dziennika (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

Pliki są odpowiednio partycjonowane przy użyciu wcześniej wymienionych kryteriów. W związku z tym za każdym razem, gdy osiągniesz maksymalną liczbę plików, jest to zazwyczaj również wtedy, gdy zbliżasz się do lub osiągnąłeś maksymalną ilość 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, są zachowywane: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

Czy logika przechowywania danych oparta na wieku jest domyślnie stosowana do mojej istniejącej bramki danych lokalnych?

Nie. Ta logika przechowywania jest teraz stosowana do całkowicie nowych instalacji bramek. Istniejące bramy, podczas procesu aktualizacji do wersji z lutego 2023 r. lub nowszych, powinny zachować obecną logikę przechowywania dzienników (retencja oparta na liczbie plików).

Treści powiązane

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