Solución de problemas de la puerta de enlace de datos local

En este artículo se examinan algunos problemas comunes cuando se usa la puerta de enlace de datos local.

Nota:

Si encuentra un problema que no está en la lista, cree un ticket de soporte para el servicio en la nube en particular que ejecuta la puerta de enlace.

Actualización a la versión más reciente

Es una buena práctica general asegurarse de que usa una versión compatible. Lanzamos una nueva actualización de las puertas de enlace de datos locales cada mes. Actualmente, Microsoft solo admite activamente las últimas seis versiones de la puerta de enlace de datos local. Si tiene problemas con la versión que está utilizando, intente actualizar a la última, ya que su problema puede haberse resuelto en la última versión.

Versiones inconsistentes entre los miembros de puerta de enlace de un clúster

Mantenga sincronizadas las versiones de los miembros de puerta de enlace de un clúster. Tener la misma versión en un clúster ayuda a evitar errores de actualización inesperados. Estos errores de actualización pueden ocurrir porque el miembro de puerta de enlace al que se enruta una consulta específica podría no ser capaz de ejecutarla debido a una versión inferior.

Solucionar problemas de administración de puertas de enlace

A continuación, se muestran algunos problemas de administración comunes y las soluciones que ayudaron a otros clientes.

Error al eliminar el nodo principal de un clúster de puerta de enlace

El nodo principal de una puerta de enlace no se puede eliminar si hay otros miembros en el clúster. Eliminar el nodo principal también implica eliminar el clúster de puerta de enlace.

Solucionar problemas de instalación comunes

Aquí encontrará algunos problemas comunes de instalación y las soluciones que ayudaron a otros clientes.

Error: Error al agregar el usuario al grupo. (Usuarios del registro de rendimiento de-2147463168 PBIEgwService)

Podría recibir este error si intenta instalar la puerta de enlace en un controlador de dominio. No se admite la implementación de un controlador de dominio. Debe implementar la puerta de enlace en una máquina que no es un controlador de dominio.

Software antivirus desactualizado

Podrían producirse errores de instalación si el software antivirus de la máquina de instalación no está actualizado. Puede actualizar la instalación del antivirus o deshabilitar el software antivirus solo durante la instalación de la puerta de enlace. Una vez finalizada la instalación, vuelva a habilitar el software antivirus.

Software McAfee Endpoint Defender habilitado

Es posible que se produzca un error de instalación cuando esté habilitado un software antivirus, como McAfee Endpoint Defender. Configure su software antivirus para ignorar el proceso de puerta de enlace.

Misma versión de puerta de enlace o una versión anterior

Es posible que encuentre el siguiente error si intenta instalar la misma versión o una versión anterior de la puerta de enlace en comparación con la que ya tiene.

Gateway installation error.

Error: el perfil de usuario es un perfil temporal

Hay un problema con la máquina. Póngase en contacto con su equipo de TI interno para eliminar el perfil temporal.

Error al generar una clave asimétrica

Un antivirus como McCafee puede provocar daños o eliminación de archivos necesarios para que la puerta de enlace pueda completar la configuración. Deshabilite el antivirus temporalmente o configúrelo para omitir el proceso de puerta de enlace. A continuación, elimine la carpeta RSA de la ruta de acceso c:\Users<GW Service Account User>\AppData\Roaming\Microsoft\Crypto\RSA. En algunos casos, dependiendo de si inicia sesión como usuario o perfil de servicio, la ruta de acceso raíz podría ser diferente. Por último, reinicie la máquina y complete la configuración y el inicio de sesión de la puerta de enlace.

Solucionar problemas de configuración

Firewall o proxy

Para probar si la puerta de enlace tiene acceso a todos los puertos necesarios, ejecute la prueba de puertos de red. Los resultados de la prueba son Completado (correcto) o Completado (error, consulte los resultados de la última prueba). Si la prueba se ha realizado correctamente, la puerta de enlace se ha conectado correctamente con todos los puertos necesarios. Si la prueba ha producido algún error, el entorno de red podría estar bloqueando estos servidores y puertos necesarios.

Para obtener información sobre cómo proporcionar información del proxy para su puerta de enlace, vaya a Configurar el proxy para la puerta de enlace de datos local.

Un firewall también podría estar bloqueando las conexiones que Azure Relay realiza a los centros de datos de Azure. Si es así, quizás desee desbloquear las direcciones IP de esos centros de datos para su región en una lista de permitidos. Puede obtener una lista de direcciones IP de Azure desde este sitio web. Para encontrar la región actual del centro de datos en la que se encuentra, vaya a Establecer la región del centro de datos.

Autenticación de servidor proxy

Puede que el proxy requiera autenticación de una cuenta de usuario de dominio. De manera predeterminada, la puerta de enlace usa un SID de servicio para el usuario de inicio de sesión del servicio de Windows. Cambiar el usuario de inicio de sesión a un usuario de dominio puede ayudarle con esta situación. Para más información, vaya a Cambiar la cuenta de servicio de la puerta de enlace a un usuario de dominio.

El proxy solamente permite tráfico de los puertos 80 y 443

Algunos proxy restringen el tráfico solo a los puertos 80 y 443. De forma predeterminada, la comunicación con Azure Relay se produce en puertos distintos de 443.

Puede obligar a la puerta de enlace a comunicarse con Azure Relay a través de HTTPS en vez de TCP directo.

El proxy de la puerta de enlace no puede conectarse al lago de datos administrado

Si usa un proxy para acceder a los datos locales usando una puerta de enlace de datos local, es posible que no pueda conectarse a un lago de datos administrado (MDL) usando la configuración de proxy predeterminada. Para conectarse a MDL, asegúrese de agregar direcciones *.dfs.core.windows.net y *.blob.core.windows.net a la lista de permitidos de su servidor proxy.

Los datos del contador de rendimiento del sistema no están disponibles

Si la cuenta de servicio actual que la aplicación de puerta de enlace de datos local usa no es miembro del grupo de seguridad local Usuarios del registro de rendimiento, puede observar en el informe de agregación de contadores del sistema, que solo está disponible el valor de uso de memoria del sistema.

Para solucionar este comportamiento, agregue la cuenta de servicio de puerta de enlace de datos local al grupo de seguridad local Usuarios del registro de rendimiento y reinicie el servicio de puerta de enlace de datos local.

Errores de conectividad

Cuando una puerta de enlace tiene problemas de conectividad, es posible que observe distintos síntomas. Estos son algunos de los síntomas comunes.

Error: La puerta de enlace muestra el estado sin conexión en la página Administrar puertas de enlace

Es posible que vea una de las siguientes indicaciones en la página Administrar puertas de enlace si hay un problema de conectividad.

Gateway offline in manage gateways page.

Error: Su puerta de enlace de datos no tiene conexión o no se puede acceder a ella.

Es posible que se produzca uno de los siguientes errores de actualización de datos si hay un problema de conectividad.

Gateway offline or couldn't be reached error.

Error: La solicitud de red ha devuelto un error inesperado.

Es posible que se produzca uno de los siguientes errores al intentar iniciar sesión en el configurador de puerta de enlace si hay un problema de conectividad.

Gateway configurator network unpexted error.

Los problemas de conectividad pueden tener varias causas diferentes. Por lo tanto, si tiene alguno de los síntomas mencionados anteriormente, realice las siguientes comprobaciones:

  1. ¿Están los FQDN y los puertos mencionados en nuestra documentación abiertos/permitidos en su firewall y/o proxy?

  2. Si usa un servidor proxy en su entorno:

    1. Asegúrese de que el servidor proxy está configurado correctamente en los archivos de configuración de la puerta de enlace.
    2. Compruebe si la configuración del proxy es coherente.
    3. Compruebe los registros de proxy para comprobar si hay alguna solicitud bloqueada en el nivel de proxy.
  3. ¿El firewall solo permite la comunicación en los puertos 80 y 443?

    1. Si es así, asegúrese de que el modo HTTPS de la puerta de enlace está habilitado.

Errores comunes

Error: No se pudo crear una puerta de enlace. Inténtelo de nuevo.

Este error podría deberse a problemas de configuración de proxy. El registro de puerta de enlace proporciona más detalles para solucionar problemas. Para más información, vaya a Configurar el proxy para la puerta de enlace de datos local.

Error: el servicio Power BI informó de que no se puede acceder a la puerta de enlace local. Reinicie la puerta de enlace e inténtelo de nuevo.

Cuando finalice la configuración, se vuelve a llamar al servicio Power BI para validar la puerta de enlace. El servicio Power BI no informa de que la puerta de enlace sea dinámica. El reinicio del servicio de Windows puede permitir que la comunicación se realice correctamente. Para obtener más detalles, recopile y revise los registros, como se describe en la siguiente sección.

Error: se necesita información para combinar datos

Es posible que experimente un error de actualización en el servicio Power BI con un error “Se necesita información para combinar datos”, aunque funcione la actualización en Power BI Desktop. Este problema ocurre cuando la actualización en Power BI Desktop trabaja con el conjunto de opciones Archivo>Opciones y configuraciones>Opciones>Privacidad>Ignorar siempre la configuración del nivel de privacidad, pero arroja un error de firewall cuando se seleccionan otras opciones. Si intenta realizar esta actualización en el servicio Power BI, la actualización no funcionará porque Ignorar siempre la configuración del nivel de privacidad no está disponible en el servicio Power BI. Para resolver este error, intente cambiar el nivel de privacidad en la configuración de Power BI para escritorio Opciones>Global>Privacidad y Opciones>Archivo actual>Privacidad, para que no se ignore la privacidad de los datos. Vuelva a publicar el archivo para servicio Power BI y actualice las credenciales a "Organizativo" en servicio Power BI.

Error: hay demasiadas actualizaciones que se producen simultáneamente.

La puerta de enlace tiene un límite de simultaneidad de 30. Si recibe este error, significa que ha alcanzado el límite de simultaneidad. Puede supervisar el recuento de simultaneidad con la plantilla de diagnóstico de la puerta de enlace. Para evitar este problema, actualice el número de puertas de enlace de un clúster o inicie un nuevo clúster para equilibrar la carga de la solicitud.

Herramienta para la solución de problemas

Recopilar registros de la aplicación de puerta de enlace de datos local

Hay varios registros que se pueden recopilar para la puerta de enlace y esto debería ser siempre lo que hiciera en primer lugar. La forma más sencilla de recopilar registros después de instalar la puerta de enlace es a través de la aplicación de puerta de enlace de datos local. En la aplicación de puerta de enlace de datos local, seleccione Diagnósticos y luego seleccione el vínculo Exportar registros, como se muestra en la siguiente imagen.

On-premises data gateway app logs.

Este archivo se guarda en la carpeta ODGLogs, en el escritorio de Windows, en formato .zip.

Registros de eventos

Para buscar los registros de eventos del servicio de puerta de enlace de datos local, siga estos pasos:

  1. En el equipo con la instalación de puerta de enlace, abra el Visor de eventos.

  2. Expanda Visor de eventos>Registros de aplicaciones y servicios.

  3. Seleccione On-premises data gateway service (Servicio de puerta de enlace de datos local).

On-premises data gateway event logs.

Solución de errores de actualización para un origen específico

Las actualizaciones que usan la puerta de enlace requieren que el origen sea accesible desde el equipo con la instalación de la puerta de enlace. Para solucionar un problema de origen de datos, use Power BI Desktop localmente en el equipo de puerta de enlace para probar la conexión. Esta prueba es especialmente útil si el origen de datos requiere que se instalen componentes adicionales en el equipo, como un controlador de base de datos de terceros. Además, una prueba local ayuda a probar las conexiones de origen de datos que requieren una configuración de entorno adicional, como el acceso a un archivo o carpeta de unidad de red compartida. Esta técnica permite probar de forma iterativa la conexión en el equipo de puerta de enlace después de cada cambio de configuración.

Aunque no es una garantía de una actualización correcta a través de la puerta de enlace, una actualización correcta de Power BI Desktop desde el equipo de puerta de enlace es un indicador seguro de que todo está configurado correctamente en el equipo de puerta de enlace. Es decir, si no se puede actualizar en Power BI Desktop desde el equipo de puerta de enlace, es muy poco probable que una actualización a través de la puerta de enlace se realice correctamente. Después de una actualización correcta en Desktop, puede restringir los pasos de solución de problemas a la configuración del origen de datos y el modelo semántico en el servicio Power BI.

Limitaciones y consideraciones

Al usar las credenciales de OAuth2, la puerta de enlace actualmente no admite la actualización automática de tokens cuando expiran los tokens de acceso (una hora después del inicio de la actualización). Si recibe los errores "InvalidConnectionCredentials" o "AccessUnauthorized" al acceder a orígenes de datos en la nube mediante credenciales de OAuth2 aunque las credenciales se hayan actualizado recientemente, es posible que se produzca este error. Esta limitación para las actualizaciones de larga duración existe para las puertas de enlace de VNET y para las puertas de enlace de datos locales.

Las API REST de puerta de enlace de Power BI no admiten clústeres de puerta de enlace.

Pasos siguientes