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

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

  • Статья

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

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

  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, 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\On-premises data gateway. Чтобы задать количество сохраненных файлов журнала, измените первое число в значении initializeData файла. Чтобы настроить размер каждого файла журнала, измените второе число.

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

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

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

Следующие шаги

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