Поделиться через

Настройка файлов журналов для локального шлюза данных

Существует три категории журналов служб для локального шлюза данных: сведения, ошибка и сеть. Эта классификация предоставляет возможность устранения неполадок, которая позволяет сосредоточиться на конкретной области ошибки или проблемы.

Чтобы проверить конфигурации ведения журнала, выполните следующие действия.

  1. Откройте файл конфигурации шлюза Microsoft.PowerBI.EnterpriseGateway.exe.config, который по умолчанию должен находиться в папке \Program Files\Локальный шлюз данных.
  2. Прежде чем продолжить, сделайте копию этого файла только в случае, если потребуется восстановить его позже.
  3. Найдите прослушиватель ApplicationFileTraceListener, который находится в разделе system.diagnostics.

В следующих разделах приведены сведения о конфигурации для каждого типа хранения, который зависит от версии шлюза.

Срок хранения на основе возраста

Начиная с февраля 2023 года в шлюзе появилась новая концепция хранения на основе возраста. Эта концепция является типом хранения по умолчанию для новых установок шлюза.

Для этого типа хранения необходимо учитывать два основных аспекта (в порядке приоритета):

  • Максимальное дисковое пространство для использования журналами шлюза (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log) со значением по умолчанию 5 ГБ.
  • Период хранения в днях с значением по умолчанию — 30 дней.

В этой новой логике мы убеждаемся, что для каждого нового дня подготавливается новый файл журнала. Эта подготовка гарантирует наличие сведений для заданного дня в файлах журнала, где имя файла совпадает с датами записи журнала. Кроме того, раздел файла в течение дня выполняется, если достигается максимальный размер отдельного файла (по умолчанию — 100 МБ).

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

Если вы хотите изменить значения параметров хранения по умолчанию, их следует изменить в значении initializeData . В следующем списке описан каждый параметр:

  • Период хранения в днях (значение от 1 до 365 дней).
  • Максимальный общий размер в МБ, который может использоваться тремя типами файлов журнала.
  • Максимальный размер в МБ, который может иметь каждый файл журнала по отдельности. Каждый раз, когда достигнуто ограничение, создается новый файл с последовательным числом, добавленным.

Замечание

Журналы шлюза используют метки времени на основе UTC, а ежедневная ротация файлов журнала происходит в 00:00 UTC.

Хранение на основе количества файлов

Этот стиль был логикой хранения журналов по умолчанию в шлюзе для версий декабря 2022 года и более ранних версий. Эта логика имеет два основных понятия:

  • Количество файлов для каждого типа журнала (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
  • Максимальное количество дискового пространства для каждого типа журнала (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

Файлы секционируются соответствующим образом с ранее перечисленными критериями. Таким образом, каждый раз, когда вы достигаете максимальное количество файлов, оно также обычно находится в диапазоне или близко к максимальному объему дискового пространства.

Следующий фрагмент из файла конфигурации шлюза Microsoft.PowerBI.EnterpriseGateway.exe.config содержит три категории: GatewayInfo.log, GatewayErrors.logи 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>

По умолчанию файл конфигурации шлюза находится в каталоге \Program Files\Локальный шлюз данных. Чтобы задать количество сохраненных файлов журнала, измените первое число в значении initializeData файла. Чтобы настроить размер каждого файла журнала, измените второй номер.

В следующем примере указывается, что 20 файлов журнала, сумма всех файлов в каждой категории не превышает 50 МБ в размере, сохраняются: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

Применяется ли новая логика хранения на основе возраста по умолчанию к существующей локальной установке шлюза данных?

Нет. Эта логика хранения теперь применяется к полностью новым установкам шлюза. Существующие шлюзы при обновлении до версии февраля 2023 г. или более поздних должны сохранять свою текущую логику хранения журналов (удерживание основано на количестве файлов).

Связанный контент

Сведения об экспорте журналов шлюза для устранения неполадок см. в разделе "Устранение неполадок".

  • Last updated on