Solución de problemas de Data Gateway

En un agente de Data Gateway, utilice las opciones del navegador para mostrar las páginas Estado, Logs y Consulta para supervisar el tráfico de la conexión remota y solucionar incidencias comunes de conectividad y rendimiento.

Haga clic en Navegador para acceder a las páginas de Data Gateway.

A continuación se muestra la descripción de GUID-12258C9F-20C9-4812-AED5-9A886A025BFE-default.png
.png

Diagnóstico de problemas de conexión con la página Estado

Utilice esta página para revisar las solicitudes de base de datos que el agente de Data Gateway realiza con la base de datos remota.

En un agente de Data Gateway, haga clic en Navegador y, a continuación, en Estado para revisar las solicitudes de base de datos.

Para diagnosticar problemas, se suele buscar por fecha o estado del trabajo:
  • Para buscar por fecha, en el campo Buscar solicitud, introduzca la fecha y la hora total o parcialmente en el formato "AAAA-MM-DD HH-MM-SS". Por ejemplo, introduzca "2022-03-28" para buscar entradas del 28 de marzo de 2022.
  • Para buscar trabajos fallidos, en el campo Buscar solicitud, introduzca "REQUEST FINISHED WITH ERRORS".

Borre el campo Solicitud de búsqueda para revisar todos los trabajos.
A continuación se muestra la descripción de GUID-0476B3A6-F490-44F2-B7D4-E1EDE0FD0B49-default.png
.png

Haga clic en un trabajo para ver la información detallada del estado.
A continuación se muestra la descripción de GUID-DDFD4D08-83CA-4134-A739-517DE4EBBC0B-default.png
.png

Diagnóstico de problemas de conexión con la página Logs

Utilice esta página para revisar las entradas de log de un agente de Data Gateway con el fin de analizar el tráfico de conexión.

En un agente de Data Gateway, haga clic en Navegador y, a continuación, en Logs para revisar las entradas de log. Active la opción Activar sondeo de logs y seleccione un nivel de registro adecuado. Por ejemplo, para diagnosticar problemas de conexión, puede establecer Tipo de log en Depuración.
A continuación se muestra la descripción de GUID-B3F74324-7D86-492D-AF32-DD13F152A57F-default.png
.png

Oracle recomienda que, una vez finalizada la resolución de errores, desactive Activar sondeo de logs o ajuste Tipo de log para que capture menos información.

Diagnóstico de problemas de conexión con la página Consulta

Utilice esta página para consultar una base de datos remota desde un agente de Data Gateway para probar la conexión y evaluar el rendimiento.

En un agente de Data Gateway, haga clic en Navegador y, a continuación, en Consulta para ejecutar una sentencia SQL directamente desde el agente de Data Gateway en la base de datos (local). Por ejemplo, puede copiar la Cadena de consulta, la Cadena de conexión y la Clase de controlador de un trabajo fallido indicado en la página Estado. Proporcione las credenciales de la base de datos y ejecute la consulta para revisar las estadísticas de rendimiento y los resultados (Tiempo empleado). Nota: la base de datos remota debe admitir la conexión con una cadena de conexión JDBC.
A continuación se muestra la descripción de GUID-D263ECAE-DE5F-4FC7-8A4E-D468B24E0A90-default.png
.png

Problemas de conectividad remota y consejos

A continuación, se muestran algunos problemas de conectividad que puede experimentar y consejos sobre cómo solucionarlos.

Problemas de análisis y del panel de control

Problema notificado Realice esta acción
Código de error 603: ningún agente conectado

Compruebe que el agente de Data Gateway se está ejecutando y está activado en la página Configuración de Data Gateway. Con Data Gateway en Linux: ejecute $ <Data Gateway Install Directory>/domain/bin/status.sh y observe si el "Estado de Data Gateway" es UP o DOWN. Con Data Gateway en Windows: compruebe en Gestor de tareas > separador Detalles los procesos "datagateway.exe".

[nQSError: 77031] Se produce un error al llamar al servicio remoto DatasourceService. Detalles: [JDSError : 78] Error, URL con formato incorrecto Revise el Pool de conexiones en el modelo semántico y verifique la configuración en el separador General y el separador Varios.

Problemas de conjuntos de datos o conexiones

Problema notificado Realice esta acción
Código de error 603: ningún agente conectado Compruebe que el agente de Data Gateway se está ejecutando. Con Data Gateway en Linux: ejecute $ <Data Gateway Install Directory>/domain/bin/status.sh y observe si el "Estado de Data Gateway" es UP o DOWN. Para agentes de Data Gateway en Windows: compruebe en el separador Detalles del Gestor de tareas los procesos "datagateway.exe".
Fallo al guardar la conexión. Se han proporcionado detalles de conexión no válidos. Introduzca los detalles correctos y vuelva a intentarlo. Este error aparece en el cuadro de diálogo de conexión al crear una conexión a DB2 o SQL Server.

En la página Estado del agente también se muestra "REQUEST FINISHED WITH ERRORS" y, si hace clic en las solicitudes, aparece "[JDSError : 110] JDS - Invalid connect string / URL to external source, Cause: Invalid Oracle URL specified".

Solución alternativa:

  1. Edite el archivo <Data Gateway Install Directory>/oracle_common/jdk1.8.0_333/jre/lib/security/java.security.
  2. Localice este texto en la línea número 720:

    jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1, RC4, DES, MD5withRSA, \

  3. Cámbielo a:

    jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1, RC4, DES, MD5withRSA, \

  4. Reinicie el agente ejecutando <Data Gateway Install Directory>/domain/bin/stopJetty.sh, seguido de <Data Gateway Install Directory>/domain/bin/startJetty.sh.
JDSError : 110  - Cadena de conexión o URL a origen externo no válidas Compruebe que el agente de Data Gateway puede conectarse al origen de datos. Por ejemplo, si se está conectando a una instancia de Oracle Database, pruebe a usar "telnet <hostname> <port>" en la máquina donde Data Gateway esté instalado.
No se muestran columnas Cambie la versión del agente de Data Gateway. Este problema suele ocurrir si usa una actualización anterior del agente de Data Gateway que no coincide con la actualización de Oracle Analytics Cloud.
Falta la opción Usar conectividad de datos remota

Compruebe que la opción Activar Data Gateway está activada en la página Conectividad de datos remota de la consola.

Problemas generales

Problema notificado Realice esta acción
Fallo de cambio de estado del agente con un error que indica que no se ha especificado el nombre del agente o la URL de Oracle Analytics Cloud o que no se ha generado el par de claves. Haga clic en Guardar y, a continuación, en Activar. Si el problema continúa, reinicie la aplicación. Si es necesario, compruebe su red.
La prueba ha devuelto el mensaje de error: "Fallo al autenticar con el error: 401" Entre los posibles motivos se incluyen:

- La clave del agente de Data Gateway no se ha copiado en la página Conectividad de datos remota de la consola de Oracle Analytics Cloud. Por ejemplo, puede que haya hecho clic en el botón Probar antes de pegar la clave en OAC > Consola > página Conectividad de datos remota.

- La clave del agente de Data Gateway se ha regenerado, pero la clave nueva no se ha copiado en la página Conectividad de datos remota de la consola de Oracle Analytics Cloud. Por ejemplo, puede que haya registrado un agente de Data Gateway en la página Conectividad de datos remota de la consola, pero su ID no coincide con el "ID" de la clave en la página de inicio del agente de Data Gateway.


A continuación se muestra la descripción de GUID-993A05E7-934B-4EFE-A233-29A85B823B8C-default.png
.png

Si la clave del agente de Data Gateway no se ha copiado, péguela en la consola para registrar el agente.

Si la clave del agente de Data Gateway se ha regenerado, suprima el agente de Data Gateway en la consola y, a continuación, pegue la clave en la consola para registrar el agente.

El guardado ha devuelto el mensaje de error: "Fallo al autenticar con el error: 404"

Esto suele ocurrir cuando la instancia de Oracle Analytics se ha actualizado.

Consulte:

- Guidance For Using Remote Data Gateway on Environments Upgraded From Oracle Analytics Cloud 105.2 and Lower (ID de documento 2574387.1)

- Oracle Analytics Cloud - Classic: How to Enable Remote Data Gateway in Customer Managed Oracle Analytics Cloud-Classic Instance Upgraded from 105.2 or Lower Release (ID de documento 2632064.1).

URL de OAC no válida / Excepción de host desconocida o no se devuelve ningún mensaje o error al pulsar Probar.

Entre los posibles motivos se incluyen:

- Se especifica una URL incorrecta en la página de inicio del agente de Data Gateway. Por ejemplo, puede que haya proporcionado una URL como https://oacinst-tenancy.analytics.ocp.oraclecloud.com/dv/ui o https://oacinst-tenancy.analytics.ocp.oraclecloud.com/analytics

- No hay ninguna ruta de red adecuada del agente de Data Gateway a la instancia de Oracle Analytics Cloud. Por ejemplo, puede que tenga un servidor proxy para acceder a Internet y el firewall esté bloqueando el acceso del agente de Data Gateway a Oracle Analytics Cloud. Si no se requiere un servidor proxy, confirme la conectividad a Oracle Analytics Cloud de la máquina en la que se está ejecutando Data Gateway.

Si se especifica una URL incorrecta en la página de inicio del agente de Data Gateway, actualice la URL en el campo URL. Por ejemplo, si la URL de Oracle Analytics Cloud es https://<instance details>.oraclecloud.com/dv/ui, especifique esta URL: https://<instance details>.oraclecloud.com.

No hay ninguna ruta de red adecuada del agente de Data Gateway a la instancia de Oracle Analytics Cloud.

- En Linux, ejecute el comando $ sudo traceroute -T -p 443 https://<detalles instancia>.oraclecloud.com

- En Windows, ejecute el comando C:\> telnet https://<detalles instancia>.oraclecloud.com 443.

Si se requiere un servidor proxy, compruebe los detalles de proxy para Data Gateway. Consulte URL de Oracle Analytics Cloud no válida (Data Gateway no se puede comunicar con Oracle Analytics Cloud).

URL de Oracle Analytics Cloud no válida (Data Gateway no se puede comunicar con Oracle Analytics Cloud)

  • Compruebe que ha activado y configurado Data Gateway en la consola de Oracle Analytics Cloud.
  • Asegúrese de que puede acceder a la URL de Oracle Analytics Cloud desde el entorno en el que se está ejecutando Data Gateway. Por ejemplo, en Linux puede usar un comando traceroute, como sudo traceroute -T -p 443 <Nombre de dominio totalmente cualificado de la instancia de Oracle Analytics Cloud>.
  • Asegúrese de que no haya nada más que bloquee la comunicación a través del firewall.
  • Si está utilizando un proxy, vaya hasta la página de inicio del agente de Data Gateway y compruebe la configuración de Proxy para Host, Puerto, Usuario y Contraseña.
El rendimiento es lento Revise la página Logs y busque lo siguiente:
  • Fecha
  • Trabajos fallidos
  • ID de trabajo
  • 'REMOTE'

Una vez que encuentre las entradas de log, haga clic en un trabajo y revise el cuadro de diálogo Estado de la solicitud para ver el tiempo empleado en milisegundos.

Solicite al equipo de cuenta de ventas instrucciones sobre cómo ajustar el tamaño de Data Gateway.

Fallo de la prueba en la página Conectividad de datos remota de la consola

Si la prueba falla, el agente de Data Gateway no puede realizar la autenticación por varios motivos, entre los que se incluyen:

  • La clave del agente de Data Gateway no se ha copiado en la página Conectividad de datos remota de la consola de Oracle Analytics Cloud.
  • La clave del agente de Data Gateway se ha regenerado, pero la clave nueva no se ha copiado en la página Conectividad de datos remota de la consola de Oracle Analytics Cloud.
  • No hay ninguna ruta de red adecuada del agente de Data Gateway a Oracle Analytics Cloud.