Устранение неполадок с локальным шлюзом данных

В этой статье описаны распространенные проблемы при работе с локальным шлюзом данных.

Обновление до последней версии

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

Несовместимые версии между участниками шлюза в кластере

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

Устранение проблем управления шлюзом

Вот несколько общих проблем управления и решения, которые помогли другим клиентам.

Ошибка при удалении основного узла кластера шлюза

Основной узел шлюза нельзя удалить, если в кластере есть другие участники. Удаление основного узла также означает удаление кластера шлюза.

Устранение распространенных проблем установки

Вот несколько распространенных проблем установки и решения, которые помогли другим клиентам.

Error: Failed to add user to group. (Ошибка: не удалось добавить пользователя в группу.) (-2147463168 PBIEgwService Performance Log Users ) (-2147463168 пользователей журналов производительности PBIEgwService)

Эта ошибка может возникнуть, если вы пытаетесь установить шлюз на контроллере домена. Развертывание на контроллере домена не поддерживается. Шлюз нужно устанавливать на компьютере, который не является контроллером домена.

Устаревшее антивирусное программное обеспечение

Вы можете столкнуться с ошибками установки, если антивирусное программное обеспечение на установочном компьютере устарело. Вы можете обновить антивирусную установку или отключить антивирусное программное обеспечение только во время установки шлюза. После завершения установки снова включите антивирусное программное обеспечение.

Программное обеспечение McAfee Endpoint Defender включено

При включении антивирусного программного обеспечения, например McAfee Endpoint Defender, может возникнуть сбой установки. Настройте антивирусное программное обеспечение так, чтобы оно игнорировало процесс шлюза.

Та же или более ранняя версия шлюза

Вы можете столкнуться со следующей ошибкой, если попытаетесь установить ту же версию или предыдущую версию шлюза по сравнению с той, которая у вас уже есть.

Ошибка. Профиль пользователя является временным

Возникла проблема с компьютером. Свяжитесь со своим внутренним ИТ-отделом, чтобы удалить временный профиль.

Ошибка при создании асимметричного ключа

Антивирусная программа, например McCafee, может привести к повреждению или удалению файлов, необходимых для завершения установки шлюза. Отключите антивирусную программу временно или настройте ее, чтобы игнорировать процесс шлюза. Затем удалите папку RSA из пути c:\Users<GW Service Account User>\AppData\Roaming\Microsoft\Crypto\RSA. В некоторых случаях в зависимости от того, выполняется ли вход в качестве пользователя или профиля службы, корневой путь может отличаться. Наконец, перезапустите компьютер и завершите настройку сетевого шлюза и вход в систему.

Устранение неполадок с конфигурацией

Брандмауэр или прокси-сервер

Чтобы проверить, имеет ли шлюз доступ ко всем необходимым портам, запустите проверку сетевых портов. Результатом проверки будет "Завершено (успешно)" или "Завершено (сбой; см. результаты последней проверки)". Если проверка пройдена, шлюз успешно подключен ко всем нужным портам. Сбой проверки может означать, что сетевая среда может блокировать необходимые порты и серверы.

Информацию о том, как предоставить информацию о прокси-сервере для вашего шлюза, см. в разделе Настройка параметров прокси для локального шлюза данных.

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

Проверка подлинности на прокси-сервере

Прокси-сервер может требовать выполнения проверки подлинности от учетной записи пользователя домена. По умолчанию шлюз использует SID службы для пользователя, выполняющего вход в службу Windows. В этой ситуации может помочь замена пользователя для входа на пользователя домена. Дополнительные сведения см. в разделе Смена учетной записи службы шлюза на пользователя домена.

Прокси-сервер разрешает только порты 80 и 443 трафика

Некоторые прокси-серверы ограничивают трафик только портами 80 и 443. По умолчанию обмен данными с Azure Relay происходит на портах, отличных от 443.

Шлюз можно принудительно взаимодействовать с Azure Relay с помощью HTTPS вместо прямого TCP.

Шлюзовой прокси не может подключиться к управляемому озеру данных.

Если вы используете прокси-сервер для доступа к локальным данным с помощью локального шлюза данных, возможно, вы не сможете подключиться к управляемому озеру данных (MDL) с настройками прокси-сервера по умолчанию. Для подключения к MDL обязательно добавьте адреса *.dfs.core.windows.net и *.blob.core.windows.net в список разрешений на вашем прокси-сервере.

Данные счетчика производительности системы недоступны

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

Чтобы устранить это поведение, добавьте учетную запись службы локального шлюза данных в локальную группу безопасности "Пользователи журнала производительности" и перезапустите локальную службу шлюза данных.

Создание собственного ретранслятора Azure

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

Ошибки подключения.

Если шлюз сталкивается с проблемами с подключением, вы можете наблюдать различные симптомы. Вот несколько распространенных симптомов.

Ошибка: шлюз отображает состояние "Автономный" на странице "Управление шлюзами"

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

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

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

Ошибка: сетевой запрос вернул непредвиденное сообщение об ошибке

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

Проблемы с подключением могут иметь несколько различных причин. Поэтому при возникновении любого из упомянутых ранее симптомов выполните следующие проверки:

1. Открыты или разрешены ли в вашем брандмауэре и/или прокси-сервере полные доменные имена и порты, указанные в нашей документации?

2. Если вы используете прокси-сервер в вашей среде:

   1. Убедитесь, что прокси-сервер правильно настроен в файлах конфигурации шлюза.
   2. Проверьте, согласована ли конфигурация прокси-сервера.
   3. Проверьте журналы прокси-сервера, чтобы проверить, заблокированы ли какие-либо запросы на уровне прокси-сервера.

3. Только ли брандмауэр разрешает обмен данными между портами 80 и 443?

   1. Если да, убедитесь, что режим HTTPS в шлюзе включен.

Требования к памяти технологического процесса Fabric на локальном шлюзе данных

При запуске конвейера в локальном шлюзе данных каждое действие разбивается на одну или несколько задач. Компьютер шлюза должен иметь достаточно памяти для выполнения этих задач; в противном случае они будут помещены в очередь.

1. Системное управление: 5% памяти компьютера зарезервированы для системных процессов.

2. Выполнение задачи. Каждый процесс, выполняющий задачу, выделяется фиксированный объем памяти. По умолчанию это 1000 МБ, но его можно изменить значение OnPremRuntimeDefaultWorkerMaxWorkingSetInMB в файле конфигурации Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.configс минимальным значением 100 МБ.

Распространенные ошибки

Ошибка. Не удалось создать шлюз. Повторите попытку.

Эта ошибка может быть вызвана неправильной конфигурацией прокси-сервера. Журнал шлюза содержит дополнительные сведения об устранении неполадок. Дополнительные сведения см. в статье Настройка параметров прокси-сервера для локального шлюза данных.

Ошибка: служба Power BI сообщили, что локальный шлюз недоступен. Перезапустите шлюз и повторите попытку.

В конце конфигурации служба Power BI снова вызывается для проверки шлюза. Служба Power BI не объявляет шлюз активным. Перезапуск службы Windows может позволить успешному обмену данными. Чтобы получить более подробную информацию, соберите и просмотрите журналы, как описано в следующем разделе.

Ошибка. Для объединения данных необходимо указать сведения

Может возникнуть сбой обновления в службе Power BI с ошибкой "Сведения необходимы для объединения данных", даже если обновление в Power BI Desktop работает. Эта проблема возникает, когда обновление в Power BI Desktop работает с параметром Файл>Параметры и настройки>Параметры>Конфиденциальность>Всегда игнорировать параметры уровней конфиденциальности, но при выборе других параметров выдает ошибку брандмауэра. Если вы пытаетесь выполнить это обновление в службе Power BI, обновление не удаётся, поскольку Всегда игнорировать параметры уровня конфиденциальности недоступно в службе Power BI. Чтобы устранить эту ошибку, попробуйте изменить уровень конфиденциальности в настройках Power BI Desktop Параметры>Глобальные>Конфиденциальность и Параметры>Текущий файл>Конфиденциальность, чтобы не игнорировать конфиденциальность данных. Повторно опубликуйте файл в службе Power BI и обновите учетные данные до "Организационные" в службе Power BI.

Ошибка: одновременно возникает слишком много обновлений

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

Средства диагностики

Сбор журналов из локального приложения шлюза передачи данных

Существует несколько журналов, которые можно собирать на шлюзе, и вы всегда должны начинать с журналов. Самый простой способ сбора журналов после установки шлюза — через локальное приложение шлюза данных. В локальном приложении шлюза данных выберите "Диагностика " и щелкните ссылку "Экспорт журналов ".

Этот файл сохраняется в папке ODGLogs на рабочем столе Windows в формате ZIP.

Журналы событий

Чтобы найти журналы событий для локальной службы шлюза данных, выполните следующие действия:

1. На компьютере, где установлен шлюз, откройте средство Просмотр событий.

2. Разверните Средство просмотра событий>Журналы приложений и служб.

3. Выберите службу 'Локальный шлюз данных'.

Устранение сбоев обновления для конкретного источника

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

Хотя это не гарантирует успешное обновление через шлюз, успешное обновление Power BI Desktop с компьютера шлюза является сильным индикатором правильности настройки всего на компьютере шлюза. Другими словами, если вы не можете обновить Power BI Desktop с помощью компьютера шлюза, то очень маловероятно, что обновление через сам шлюз будет успешным. После успешного обновления на рабочем столе можно сузить шаги по устранению неполадок в конфигурации источника данных и семантической модели в службе Power BI.

Рекомендации и ограничения

При использовании учетных данных OAuth2 шлюз в настоящее время не поддерживает автоматическое обновление маркеров при истечении срока действия маркеров доступа (через час после запуска обновления). При получении ошибок "InvalidConnectionCredentials" или "AccessUnauthorized" при доступе к облачным источникам данных с использованием учетных данных OAuth2, даже если учетные данные были обновлены недавно, вы могли столкнуться с этой ошибкой. Это ограничение для длительных обновлений существует как для шлюзов виртуальных сетей, так и для локальных шлюзов данных.

REST API шлюзов в Power BI не поддерживают кластеры шлюзов.

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

• Вопросы и ответы о локальном шлюзе данных