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

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

Ескерім

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

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

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

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

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

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

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

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

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

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

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

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 в список разрешений на вашем прокси-сервере.

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

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

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

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

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

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

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

Шлюз в автономном режиме на странице управления шлюзами.

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

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

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

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

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

Ошибка настройки сети шлюза, нераспечатаемая.

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

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

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

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

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

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

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

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

Ошибка: служба 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. Установите флажок On-premises data gateway service (служба "Локальный шлюз данных").

Журналы событий локального шлюза данных.

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

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

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

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

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

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

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