Configuración y resolución de problemas en Pasarela de datos Direct Access de Qlik

Este tema describe varias acciones que puede realizar para configurar y solucionar problemas en la pasarela de datos Direct Access gateway.

Configuración de Direct Access gateway desde su espacio empresarial inquilino Qlik Cloud

Si bien la configuración predeterminada de Direct Access gateway es adecuada para la mayoría de los entornos, es posible que deba anularla para mejorar el rendimiento, resolver algún problema (mediante la configuración de registro) o solucionar diversos problemas de conectividad.

Para poder editar la configuración en Qlik Cloud, se requiere uno de los siguientes permisos:

• Administración de espacio empresarial inquilino y propietario del espacio de pasarela de entrada

• Miembro espacio empresarial inquilino con Puede consumir datos en el espacio de pasarela de entrada

Para abrir la configuración de la pasarela:

1. En su espacio empresarial inquilino Qlik Cloud, navegue hasta Administración > Pasarelas de datos y localice su Direct Access gateway.

2. Haga clic en al final de la fila y seleccione Ver registros.

   Se abre el cuadro de diálogo Configuración de la pasarela para <nombre>.

   Los ajustes se dividen en ajustes generales (a continuación) y ajustes del conector. Tenga en cuenta que el cambio de ajustes también puede requerir que reinicie el servicio Direct Access gateway.

Configuración general

Estos ajustes son relevantes para la funcionalidad general de Direct Access gateway, independientemente del conector que esté utilizando.

ID de agente

El ID de agente para usar con la API pública de Direct Access gateway

Puerto del agente del conector

El puerto que se utilizará al conectarse al agente del conector. Este ajuste no puede modificarse.

Umbral de fallo de estado del agente del conector

Se realizan comprobaciones de estado periódicamente en los componentes de Direct Access gateway. A veces las comprobaciones de estado fallan inicialmente y luego tienen éxito. Si las comprobaciones de estado continúan fallando después del umbral especificado, se reiniciará el servicio Direct Access gateway. Solo debe cambiar esta configuración si se lo solicita el Soporte de Qlik.

Tiempo de espera de solicitud de carga

Cuando se producen interrupciones en la red, las recargas pueden fallar con los siguientes errores:

Connector error: The session does not exist (DirectAccess-1509)

Connector error: The stream session expired for the load data request (DirectAccess-1012)

Si se encuentra con frecuencia con los errores anteriores, pruebe a ajustar el tiempo de espera a 5-10 minutos.

Nivel de registro del agente del conector

Para solucionar problemas, puede que necesite cambiar el nivel de registro de los componentes del agente del conector. Solo debe cambiar esta configuración si se lo solicita el Soporte de Qlik.

Opciones de registro del agente del conector

Para solucionar problemas con un componente específico del agente conector, puede que tenga que seleccionar su archivo de registro correspondiente. Solo debe cambiar esta configuración si se lo solicita el Soporte de Qlik.

Memoria para fragmentos de datos almacenados en caché

Para cada operación de recarga, Direct Access gateway puede almacenar fragmentos de datos en la memoria caché y descargarlos en el disco (cuando se supere el tamaño asignado para el almacenamiento en caché). Esto es especialmente útil si no utiliza la recuperación automática y se encuentra frecuentemente con los errores 4025, 4020 y 4021. Cuando se alcanza el umbral especificado, la pasarela descarga los siguientes fragmentos cifrados en el disco del sistema de Direct Access gateway.

Umbral de duración de la recuperación de fragmentos

Este es el umbral (en minutos) para la duración de la recuperación de fragmentos. Si la recarga no se ha reanudado cuando se haya alcanzado el umbral establecido para la recuperación, dará un mensaje de error.

Esta opción es útil para recargas que, de otro modo, podrían superar el límite de tres horas, cuando la duración de la recuperación es demasiado larga. Por ejemplo, supongamos que se tarda 90 minutos en recuperar los datos de la base de datos, pero en cuanto comienza la recarga, uno de los fragmentos se corrompe. En ese caso, todos los fragmentos se almacenarán en la caché y se enviarán desde la caché. En tal escenario, el proceso completo de recarga (almacenamiento en caché + recarga real) podría tardar tres horas en completarse.

Puerto DCaaS

El puerto que se utilizará al conectarse a DCaaS. Este ajuste no puede modificarse.

Nivel de registro de DCaaS

Para solucionar problemas, puede que necesite cambiar el nivel de registro de los registros de DCaaS. Solo debe cambiar esta configuración si se lo solicita el Soporte de Qlik.

Configuración del conector

Para cambiar la configuración del conector, seleccione el tipo de conector a la izquierda y, a continuación, cambie la configuración según sea necesario.

Puerto

El puerto que utilizar cuando se conecta con la fuente de datos. Este ajuste no puede modificarse.

Nivel de registro

Para solucionar problemas, puede que necesite cambiar el nivel de registro de los registros del conector. Solo debe cambiar esta configuración si se lo solicita el Soporte de Qlik.

Aislamiento de procesos

El aislamiento de procesos permite a los administradores con acceso al sistema operativo del servidor Direct Access gateway controlar cuántos procesos están disponibles para las recargas por tipo de conector. Distribuir recargas entre múltiples procesos de conector aumenta el nivel de aislamiento al reducir la cantidad de recargas que se ejecutan simultáneamente en cada proceso del conector. Esto, a su vez, puede mejorar la estabilidad general de Direct Access gateway en los casos en que se hayan producido fallos en el conector.

Con una instalación completa, el aislamiento de procesos está habilitado de manera predeterminada. El número predeterminado de recargas simultáneas para cada tipo de conector es 9. Puede anular el valor predeterminado como se describe en Número de procesos de recarga simultáneos a continuación.

Deshabilitar el aislamiento de procesos

El equipo de soporte de Qlik podría pedirle que deshabilite el aislamiento de procesos para resolver algunos problemas.

Para desactivar el aislamiento de procesos, seleccione Deshabilitado.

Número de procesos de recarga simultáneos

El número de procesos de recarga concurrentes asignados para el conector, incluido el proceso de comandos. Así, por ejemplo, un valor de 30 significaría un máximo de 29 recargas simultáneas. Tenga en cuenta que este ajuste solo es relevante cuando el aislamiento de procesos está activado.

Duración de la sesión de recarga

Si la conexión entre Direct Access gateway y Qlik Cloud está inactiva durante 20 segundos o más, la operación de recarga a veces puede fallar mostrando el siguiente error:

Invalid object name '#<TempTableName>' (indicating that the Direct Access gateway temp tables are unavailable).

La duración predeterminada de la sesión es de 20 segundos, pero si experimenta este error con frecuencia, puede ampliar la duración de la sesión de la siguiente manera:

Número máximo de tablas que descargar

De forma predeterminada, se recupera un máximo de 10 000 tablas de la base de datos. Podrá anular el valor predeterminado cuando su base de datos tenga más de 10 000 tablas.

Reiniciando Direct Access gateway después de cambiar la configuración

Algunos ajustes solo se aplicarán después de reiniciar el servicio Direct Access gateway. En tal caso, se le pedirá que reinicie el servicio cuando guarde la configuración. Si hay recargas activas, no podrá reiniciar el servicio hasta que finalicen. Si no hay recargas activas, puede reiniciar el servicio en cualquier momento del siguiente modo:

1. En su espacio empresarial inquilino Qlik Cloud, navegue hasta Administración > Pasarelas de datos y localice su Direct Access gateway.

2. Haga clic en al final de la fila y seleccione Reiniciar servicio.

También puede reiniciar el servicio directamente en el equipo Direct Access gateway, como se describe en Iniciar, detener o reiniciar el servicio

Configuración de Direct Access gateway directamente en el equipo Direct Access gateway

Aunque la mayoría de los ajustes de Direct Access gateway pueden configurarse en Qlik Cloud, algunos ajustes solo pueden modificarse editando los archivos de configuración directamente en el equipo Direct Access gateway.

Anular el directorio caché de fragmentos por defecto

Para cada operación de recarga, Direct Access gateway puede almacenar fragmentos de datos en la memoria caché y descargarlos en el disco (cuando se supere el tamaño asignado para el almacenamiento en caché). Puede anular el directorio caché predeterminado para los fragmentos de datos (C:\ProgramData\Qlik\Gateway\tmp) si no tiene suficiente espacio en disco en la unidad del sistema.

Para ello:

1. Utilizando un editor de texto, abra C:\ProgramData\Qlik\Gateway\configuration.properties como administrador. Si lo hace desde el Explorador de Windows, asegúrese de que está seleccionada la opción Mostrar > Elementos ocultos.

2. Localice la propiedad OVERRIDE_CHUNKS_CACHE_DIR y ajústela al directorio de su elección.

   Ejemplo:

   OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp

   Nota informativaNo indique la ruta entre comillas.
3. Guarde el archivo configuration.properties y reinicie el servicio Pasarela de datos Direct Access de Qlik.

Vea también: Memoria para fragmentos de datos almacenados en caché

Anular el tipo de datos por defecto Qlik Cloud al trabajar con el conector ODBC (a través de Direct Access gateway)

A veces, debido a un problema con el manejo de los tipos de datos de origen por parte del controlador ODBC del proveedor, se producía un error durante la recarga o se cargaban datos incorrectos en Qlik Cloud. En estos casos, puede anular el tipo de datos Qlik Cloud o su especificación (escala o precisión, por ejemplo).

Para ello:

1. Utilizando un editor de texto, abra C:\ProgramData\Qlik\Gateway\custom_type_mappings.json como admin. Si lo hace a través del Explorador de Windows, asegúrese de tener seleccionada la opción Mostrar > Elementos ocultos. Este archivo contiene una fuente a modo de ejemplo con los tipos de datos de Qlik Cloud.

2. Añada una sección que asocie el tipo de datos problemático al tipo de datos deseado de Qlik Cloud.

   En el siguiente ejemplo (que se incluye en el archivo custom_type_mappings.json ), el cliente necesita cambiar el tamaño del tipo de datos Qlik Cloud DateTime a 27.

    

3. Guarde el archivo custom_type_mappings.json y reinicie el servicio Pasarela de datos Direct Access de Qlik.
4. Recargue los datos.

Obligar a la pasarela Direct Access gateway a reconectarse con Qlik Cloud

Por defecto, si Direct Access gateway se desconecta de Qlik Cloud, debería volver a conectarse al cabo de 45 segundos. Si nota que tarda mucho más, puede forzar a la pasarela a reconectarse antes.

Para ello:

1. Utilizando un editor de texto, abra C:\ProgramData\Qlik\Gateway\configuration.properties como administrador. Si lo hace a través del Explorador de Windows, asegúrese de que está seleccionada la opción Mostrar > Elementos ocultos. Este archivo contiene una fuente a modo de ejemplo con los tipos de datos de Qlik Cloud.

2. Añada AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds> a la sección # Connector Agent al principio del archivo.

    

   Ejemplo:

   {
   "Identifier": "Amazon Athena ODBC (x64)",
   "NativeDataType": "timestamp with time zone",
   "QlikDataType": "DateTime",
   "Size": 27,
   "IsBit": false
   }

   AGENT_PONG_TIMEOUT_SECONDS=30

   Nota informativaEl tiempo mínimo es de 30 segundos.
3. Guarde el archivo configuration.properties y reinicie el servicio Pasarela de datos Direct Access de Qlik.

Realizar solicitudes de carga de datos de forma asíncrona

Realizar la solicitud de carga de datos de forma asíncrona en el agente acorta significativamente el tiempo que el servicio en nube necesita esperar a las respuestas del agente.

Para habilitar las solicitudes asíncronas de carga de datos:

1. Utilizando un editor de texto, abra C:\ProgramData\Qlik\Gateway\configuration.properties como administrador. Si lo hace a través del Explorador de Windows, asegúrese de tener seleccionada la opción Mostrar > Elementos ocultos.

2. Añada la siguiente línea al archivo:

   OPTIONAL_CAPABILITIES=AsyncLoadDataRequest

3. Guarde el archivo configuration.properties.

Para deshabilitar las solicitudes asíncronas de carga de datos:

1. Utilizando un editor de texto, abra C:\ProgramData\Qlik\Gateway\configuration.properties como administrador. Si lo hace a través del Explorador de Windows, asegúrese de tener seleccionada la opción Mostrar > Elementos ocultos.

2. Sustituya AsyncLoadDataRequest por None de la siguiente manera:

   OPTIONAL_CAPABILITIES=None

3. Guarde el archivo configuration.properties.

Permitir conexiones a localhost utilizando el conector REST (a través de Direct Access gateway)

Puede permitir que el conector REST (a través de Direct Access gateway) se conecte a localhost. Esto facilita el uso de puntos finales de REST locales (para el servidor de puerta de enlace), como el punto final connector-agent/ estado, para determinar el número activo de cargas en un agente.

1. Utilizando un editor de texto, abra C:\ProgramData\Qlik\Gateway\configuration.properties como administrador. Si lo hace a través del Explorador de Windows, asegúrese de tener seleccionada la opción Mostrar > Elementos ocultos.

2. Establecer REST_ALLOW_LOCALHOST_CONNECTION=true (establecer en false para desactivar esta capacidad)

3. Guarde el archivo configuration.properties.

Aumentar el detalle del mensaje de error al conectarse a fuentes de datos ODBC

Por motivos de seguridad, el mensaje de error por defecto que devuelve el controlador ODBC contiene una información mínima. Sin embargo, en determinados escenarios, es posible que necesite más información para solucionar un problema específico. Para obtener un mensaje de error más detallado, añada la propiedad ShowErrorDetailMessage a la sección Avanzado del cuadro de diálogo del conector y ajústela a True. Una vez que haya resuelto su problema, para una seguridad óptima, se recomienda encarecidamente eliminar la propiedad o establecerla en False.

Visualización y descarga de archivos de registro

Los archivos de registro proporcionan información sobre las operaciones de Direct Access gateway. Qlik Soporte podría pedirle que proporcione archivos de registro para solucionar problemas. Puede ver o descargar los archivos de registro en el Visor de registros. En circunstancias normales, no hay razones para abrir o examinar los archivos de registro, pero si experimenta fallos repetidos u otros problemas, los archivos de registro le ayudarán a identificar la causa.

Para abrir el Visor de registros:

1. En el centro de actividades Administración, vaya a Pasarelas de datos y localice su Direct Access gateway.

2. Haga clic en al final de la fila y seleccione Ver registros.

   Se abre la ventana del Visor de registros.

3. En la lista desplegable en la parte superior izquierda, elija el tipo de registro que el Soporte de Qlik le haya pedido que vea o descargue.

   Los siguientes registros están disponibles:

   • Registros de Direct Access gateway (DirectAccessAgent)
   • Registros de DCaaS (dcaas_logs)
   • Registros de conectores basados en ODBC (odbc-connector_logs)
   • Registros del conector SAP BW (QvSAPBwConnector-<date + timestamp>)
   • Registros del conector de SQL de SAP (QvSqlBwConnector-<fecha + marca de tiempo>)

   • Registros del agente conector (connector-agent_logs_<date>)

   • Registros del connector SAPODP (QvSapConnectorPackage-<process_id>)

   • Registros del conector REST (rest-connector_logs_<timestamp>)

   • Registros del conector de archivos File (file-connector_logs_<timestamp>)

   Nota informativaA partir de Direct Access gateway 1.7.1, los eventos de inicio, salida y reinicio del conector se escribirán en el archivo de registro Direct Access gateway (DirectAccessAgent). En versiones anteriores, se escribían en el archivo de registro del agente del conector (connector-agent_logs_<date>).

4. En la lista desplegable adyacente, seleccione el registro que desee ver o descargar. Los archivos de registro están ordenados desde el más reciente (el archivo de registro actualmente activo) hasta el más antiguo. Después de seleccionar un archivo de registro, puede usar los botones y para ir al inicio o al final del archivo de registro, respectivamente.

   Nota de sugerenciaLa vista del archivo de registro no se actualiza automáticamente con los últimos mensajes. Para actualizar la vista, haga clic en para saltar al final del archivo de registro, que se actualizará con los mensajes más recientes.

5. Para descargar el archivo de registro, haga clic en Descargar.

   El archivo se descargará a su computadora o se le pedirá que lo guarde, según la configuración de su navegador.

Abrir registros de Direct Access gateway en la máquina de Direct Access gateway

Además de poder descargar los registros de Direct Access gateway (DirectAccessAgent) desde el centro de actividades Administración, también puede abrirlos directamente desde la máquina donde está instalada la pasarela Direct Access gateway. Con una instalación predeterminada, estos registros se encuentran en:

C:\Archivos de programa\Qlik\ConnectorAgent\data\logs

Cambiar el nivel de registro de DirectAccessAgent

Para solucionar problemas, puede que necesite cambiar el nivel de registro de los registros de DirectAccessAgent. DirectAccessAgent es responsable de la conexión a los servicios de Qlik Cloud. Para ver y cambiar el nivel de detalle de los registros de DirectAccessAgent, ejecute los siguientes comandos desde la subcarpeta ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent con una instalación predeterminada):

• Para ver el nivel de registro actual, ejecute:

  connectoragent configuration getloggers

• Para establecer el nivel de registro en Seguimiento, ejecute:

  connectoragent configuration setloggers -l Root -v DEBUG

• Para establecer el nivel de registro en Detallado, ejecute:

  connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

Si desea conocer otras opciones de registro, consulte la sección Configuración de Direct Access gateway en Qlik Cloud.

Actualizar la clave de registro

Es posible que sea necesario cambiar la clave de registro en el improbable caso de que la clave se dañe o si sospecha que un usuario no autorizado accedió al servidor de la pasarela de datos.

Para actualizar la clave de registro:

1. En el servidor de la pasarela de datos de acceso directo, abra un símbolo de sistema como administrador y cambie el directorio de trabajo a la subcarpeta ConnectorAgent ( C:\Archivos de programa\Qlik\ConnectorAgent\ConnectorAgent con una instalación predeterminada).

2. Ejecute los siguientes comandos:

   • Generar la nueva clave:

     connectoragent qcs generate_keys

   • Mostrar la clave:

     connectoragent qcs get_registration

     La clave se muestra:

     

3. Copie la clave completa, tal como se muestra en el ejemplo anterior.

4. En el centro de actividades Administración, abra la configuración de la pasarela de datos haciendo clic en el botón situado al final de la fila correspondiente y seleccionando Editar.

5. Pegue la clave en el campo Clave (reemplazando la clave actual) y guarde la configuración.

6. Vuelva al servidor de la pasarela de acceso directo y reinicie el servicio Pasarela de datos Direct Access de Qlik, como se describe en Administrar el servicio Pasarela de datos Direct Access de Qlik.