Resolución de problemas en Pasarela Direct Access

Esta sección describe varias acciones que puede realizar para solucionar problemas en Pasarela Direct Access.

Visualización y descarga de archivos de registro

Los archivos de registro proporcionan información sobre las operaciones de Pasarela Direct Access. El Soporte de Qlik 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 Pasarela Direct Access.

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 Pasarela Direct Access (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 ODP de SAP (QvSapConnectorPackage-<id_de_proceso>)
   • Registros del conector de SQL de SAP (QvSqlBwConnector-<fecha + marca de tiempo>)
   • Registros del agente 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 Pasarela Direct Access en la máquina de Pasarela Direct Access

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

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

Cambiar el nivel de detalle del registro

Puede ver y cambiar el nivel de detalle de los registros de Pasarela Direct Access (DirectAccessAgent) según sea necesario. Para ello ejecute los siguientes comandos desde la subcarpeta ConnectorAgent (C:\Archivos de programa\Qlik\ConnectorAgent\ConnectorAgent con una instalación predeterminada).

• Para ver el nivel de registro actual, ejecute:

  connectoragent configuration getloggers

• Para cambiar el nivel de registro a Seguimiento, ejecute:

  connectoragent configuration setloggers -l Root -v DEBUG

• Para cambiar el nivel de registro a Detallado, ejecute:

  connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

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 Direct Access gateway y reinicie el servicio Pasarela de datos de Qlik - Direct Access, como se describe en Administrar el servicio Pasarela de datos de Qlik - Direct Access.

Ampliar la vida útil de la sesión de recarga

Si la conexión entre Pasarela Direct Access 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 Pasarela Direct Access 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:

1. Abra C:\ProgramData\Qlik\Gateway\configuration.properties como administrador. Si está haciendo esto mediante el Explorador de Windows, asegúrese de que Mostrar archivos, carpetas y unidades ocultos esté seleccionado.

2. Localice el parámetro ODBC_RELOAD_SESSION_LIFE y aumente su valor según sea necesario.
3. Guarde el archivo configuration.properties y reinicie el servicio Pasarela de datos de Qlik - Direct Access.

Extensión del tiempo de espera para las peticiones 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 parámetro EXTEND_FIRST_REQUEST_TIMEOUT a 5-10 minutos.

Para esta acción:

1. Abra C:\ProgramData\Qlik\Gateway\configuration.properties como administrador. Si está haciendo esto mediante el Explorador de Windows, asegúrese de que Mostrar archivos, carpetas y unidades ocultos esté seleccionado.

2. Localice el parámetro EXTEND_FIRST_REQUEST_TIMEOUT y aumente su valor a 5-10 minutos. El valor predeterminado es 0.
3. Guarde el archivo configuration.properties y reinicie el servicio Pasarela de datos de Qlik - Direct Access.

Mitigar los fallos del conector durante la recarga

El aislamiento de procesos permite a los administradores con acceso directo al sistema operativo del servidor de la pasarela de datos 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 Pasarela Direct Access en los casos en que se hayan producido fallos en el conector.

Desactivar el aislamiento de procesos

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

Para desactivar el aislamiento de procesos:

1. Abra el archivo C:\ProgramData\Qlik\Gateway\configuration.properties. Si está haciendo esto mediante el Explorador de Windows, asegúrese de que Mostrar archivos, carpetas y unidades ocultos esté seleccionado.

2. Configure [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE como None.

3. Guarde el archivo configuration.properties y reinicie el servicio Pasarela de datos de Qlik - Direct Access.

Activar el aislamiento de procesos o cambiar el número de recargas simultáneas

Para activar el aislamiento de procesos o cambiar el número de recargas simultáneas:

1. Abra C:\ProgramData\Qlik\Gateway\configuration.properties como administrador. Si está haciendo esto desde el Explorador de Windows, asegúrese de que Mostrar archivos, carpetas y unidades ocultos esté seleccionado.

   El archivo contiene tres prefijos correspondientes a los diferentes tipos de conectores: ODBC_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name> y SAPPACKAGE_<property-name>.

2. Configure [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE en Load y [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT en N.

   Donde:

   N= Un proceso de comando + El número de procesos de recarga simultáneos que se han de asignar. Así, por ejemplo, un valor de 10 significaría un máximo de 9 recargas simultáneas.

3. Guarde el archivo configuration.properties y reinicie el servicio Pasarela de datos de Qlik - Direct Access.

Ejemplos de aislamiento de procesos del conector ODBC

El siguiente extracto del archivo configuration.properties muestra cómo habilitar el aislamiento del proceso del conector ODBC para hasta 12 recargas:

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=13

 

A partir de Pasarela Direct Access versión 1.6.7, el valor de MAX_PROCESS_COUNT puede superar 10 sin necesidad de cambiar otras configuraciones. Para aislar completamente las recargas con un tipo de conector en particular (es decir, no más de una recarga por proceso de conector), este valor debe establecerse en un mínimo de 30, pero es posible que deba establecerse en un máximo de 60 en función de la carga de trabajo.

Almacenamiento de trozos de datos corruptos o faltantes para una futura recarga

Para cada operación de recarga, Pasarela Direct Access puede almacenar los fragmentos de datos corruptos o que faltan en la memoria y descargarlos en el disco. Esto es especialmente útil si no utiliza la recuperación automática y se encuentra frecuentemente con errores 4025, 4020 y 4021. Esta funcionalidad se activa fijando el umbral del tamaño de la caché para descargar en el disco los fragmentos de datos dañados o que faltan (por recarga). Cuando se alcanza el umbral especificado, la pasarela descarga los siguientes fragmentos cifrados en el disco del sistema de Pasarela Direct Access.

Para establecer el tamaño de la caché:

1. Abra C:\ProgramData\Qlik\Gateway\configuration.properties como administrador. Si está haciendo esto mediante el Explorador de Windows, asegúrese de que Mostrar archivos, carpetas y unidades ocultos esté seleccionado.

2. Establezca RELOAD_CACHE_MEMORY_MB en N (El valor predeterminado es 0, lo que significa que la funcionalidad no está habilitada).

   Donde:

   N = El tamaño que puede alcanzar un fragmento de datos antes de que se cargue de nuevo.

   Nota informativaHabilitar esta funcionalidad aumentará el consumo de memoria en el sistema Pasarela Direct Access, por lo que recomendamos vigilar el impacto en la memoria mientras esté habilitada. Establecer el valor de RELOAD_CACHE_MEMORY_MB en 100 debería ser suficiente para la mayoría de las situaciones.
3. Guarde el archivo configuration.properties y reinicie el servicio Pasarela de datos de Qlik - Direct Access.