Documentación de productos
Servicio NetScaler Console

Solucionar problemas de HDX Insight

August 22, 2025
Contribución de: 
C

Si la solución HDX Insight no funciona como se espera, el problema podría estar en uno de los siguientes puntos. Consulta las listas de comprobación en las secciones respectivas para solucionar el problema.

  • Configuración de HDX Insight.

  • Conectividad entre NetScaler y NetScaler Console.
  • Generación de registros para el tráfico HDX/ICA en NetScaler.
  • Relleno de registros en NetScaler Console.

Lista de comprobación de la configuración de HDX Insight

  • Asegúrate de que la función AppFlow esté habilitada en NetScaler. Para obtener más detalles, consulta Habilitar AppFlow.

  • Comprueba la configuración de HDX Insight en la configuración en ejecución de NetScaler.

    Ejecuta el comando show running | grep -i <appflow_policy> para comprobar la configuración de HDX Insight. Asegúrate de que el tipo de enlace sea ICA REQUEST. Por ejemplo:

    bind vpn vserver afsanity -policy afp -priority 100 -type REQUEST

    Para el modo transparente, el tipo de enlace debe ser ICA_REQ_DEFAULT. Por ejemplo:

    bind appflow global afp 100 END -type ICA_REQ_DEFAULT

  • Para implementaciones de salto único/Access Gateway o doble salto, asegúrate de que la política de AppFlow de HDX Insight esté enlazada al servidor virtual VPN, por donde fluye el tráfico HDX/ICA.

  • Para el modo transparente o el modo de usuario LAN, asegúrate de que los puertos ICA 1494 y 2598 estén establecidos.
  • Comprueba que el parámetro appflowlog en NetScaler Gateway o el servidor virtual VPN esté habilitado para la implementación de Access Gateway o doble salto. Para obtener más detalles, consulta Habilitar AppFlow para servidores virtuales.
  • Comprueba que la “conexión en cadena” esté habilitada en NetScaler de doble salto. Para obtener más detalles, consulta Configurar dispositivos NetScaler Gateway para exportar datos.
  • Después de una conmutación por error de HA, si los detalles de HDX Insight se analizan con omisión, comprueba que el parámetro ICA “enableSRonHAFailover” esté habilitado. Para obtener más detalles, consulta Fiabilidad de sesión en un par de alta disponibilidad de NetScaler.

Lista de comprobación de la conectividad entre NetScaler y NetScaler Console

  • Comprueba el estado del recopilador de AppFlow en NetScaler. Para obtener más detalles, consulta Cómo comprobar el estado de la conectividad entre NetScaler y AppFlow Collector.

  • Comprueba las coincidencias de la política de AppFlow de HDX Insight.

    Ejecuta el comando show appflow policy <policy_name> para comprobar las coincidencias de la política de AppFlow.

    También puedes navegar a System > AppFlow > Policies en la GUI para comprobar las coincidencias de la política de AppFlow.

  • Valida si algún firewall está bloqueando los puertos AppFlow 4739 o 5557.

Lista de comprobación de la generación de registros para el tráfico HDX/ICA en NetScaler

Ejecuta el comando tail -f /var/log/ns.log | grep -i "default ICA Message" para la validación de registros. Según los registros que se generen, puedes usar esta información para solucionar problemas.

  • Registro: Skipped parsing ICA connection - HDX Insight not supported for this host

    Causa: Versiones de Citrix Virtual Apps and Desktops no compatibles

    Solución alternativa: Actualiza los servidores de Citrix Virtual Apps and Desktops a una versión compatible.

  • Registro: Client type received 0x53, NOT SUPPORTED

    Causa: Versión de la aplicación Citrix Workspace no compatible

    Solución: Actualiza la aplicación Citrix Workspace a una versión compatible.

  • Registro: Error from Expand Packet - Skipping all hdx processing for this flow

    Causa: Problema al descomprimir el tráfico ICA

    Solución: No hay informes disponibles para esta sesión ICA hasta que se establezca una nueva sesión.

  • Registro: Invalid transition: NS_ICA_ST_FLOW_INIT/NS_ICA_EVT_INVALID -> NS_ICA_ST_UNINIT”

    Causa: Problema al analizar el intercambio inicial de ICA

    Solución: No hay informes disponibles para esta sesión ICA en particular hasta que se establezca una nueva sesión.

  • Registro: Missing EUEM ICA RTT

    Causa: No se pueden analizar los datos del canal de supervisión de la experiencia del usuario final

    Solución: Asegúrate de que el servicio de supervisión de la experiencia del usuario final esté iniciado en los servidores de Citrix Virtual Apps and Desktops. Asegúrate de que estás usando las versiones compatibles de la aplicación Citrix Workspace.

  • Registro: Invalid Channel Header

    Causa: No se puede identificar el encabezado del canal

    Solución: No hay informes disponibles para esta sesión ICA en particular hasta que se establezca una nueva sesión.

  • Registro: Skip code

    Si ves alguno de los siguientes valores para el código de omisión, los detalles de Insight se analizan con omisión.

    El código de omisión 0 indica que el registro se exportó correctamente desde NetScaler.

Código de omisión Mensaje de error Causa del error
100 NS_ICA_ERR_NULL_FRAG Error al manejar fragmentos ICA, probablemente debido a condiciones de memoria
101 NS_ICA_ERR_INVALID_HS_CMD Comando de intercambio inicial no válido recibido
102 NS_ICA_ERR_REDUC_PARAM_CNT Parámetro no válido especificado para la inicialización del expansor V3
103 NS_ICA_ERR_REDUC_INIT No se puede inicializar el expansor V3 correctamente
104 NS_ICA_ERR_REDUC_PARAM_BYTES Bytes insuficientes para asignar un codificador a un canal
105 NS_ICA_ERR_INVALID_CHANNEL Número de canal ICA no válido
106 NS_ICA_ERR_INVALID_DECODER Descodificador no válido especificado para un canal
107 NS_ICA_ERR_INVALID_TW_PARAM Recuento de parámetros no válido especificado en el canal Thinwire
108 NS_ICA_ERR_INVALID_TW_DECODER Descodificador no válido para el canal Thinwire
109 NS_ICA_ERR_REDUC_NO_DECODER No hay descodificador definido para el canal
110 NS_ICA_ERR_REDUC_V3_EXPANDER No se pudo expandir los datos del canal
111 NS_ICA_ERR_REDUC_BYTES_V3_OOR Error del expansor: Bytes consumidos más de los bytes disponibles
112 NS_ICA_ERR_REDUC_BYTES_OOR Error: Desbordamiento de datos sin comprimir
113 NS_ICA_ERR_REDUC_INVALID_CMD Comando de expansor indefinido
114 NS_ICA_ERR_CGP_FILL_HOLE Error al manejar tramas CGP divididas
115 NS_ICA_ERR_MEM_NSB_ALLOC Error de asignación de NSB – debido a condiciones de poca memoria
116 NS_ICA_ERR_MEM_REDUC_CTX_ALLOC Error de asignación de memoria para el contexto del expansor
117 NS_ICA_ERR_ICA_OLD_SERVER Servidor antiguo, bloques de capacidad no compatibles
118 NS_ICA_ERR_PIR_MANY_FRAG La solicitud de inicialización de paquete está fragmentada, no se puede procesar
119 NS_ICA_ERR_INIT_ICA_CAPS Error de inicialización de capacidad ICA
120 NS_ICA_ERR_NO_MSI_SUPPORT El host no es compatible con la función MSI. Indica para la versión de XenApp inferior a 6.5 o las versiones de XenDesktop inferiores a 5.0
121 NS_ICA_ERR_CGP_INVALID_CMD Comando CGP no válido encontrado
122 NS_ICA_ERR_INSUFFICENT_CHANNEL_BYTES Bytes insuficientes en el canal
123 NS_ICA_ERR_CHANNEL_DATA Datos incorrectos en el canal EUEM, CONTROL o SEAMLESS
124 NS_ICA_ERR_INVALID_PURE_CMD Comando no válido recibido al procesar datos de canal ICA puros
125 NS_ICA_ERR_INVALID_PURE_LEN0 Longitud no válida encontrada al procesar datos de canal ICA puros
126 NS_ICA_ERR_INVALID_PURE_LEN Longitud no válida encontrada al procesar datos de canal ICA PUROS
127 NS_ICA_ERR_INVALID_CLNT_DATA Longitud de datos no válida recibida del cliente
128 NS_ICA_ERR_MSI_GUID_SZ Error en el tamaño de GUID de MSI
129 NS_ICA_ERR_INVALID_CHANNEL_HEADER Encabezado de canal no válido detectado
130 NS_ICA_ERR_CGP_PARSE_RECONNECT_ID Falló la recuperación de la sesión reconectada
131 NS_ICA_ERR_DISABLE_SR_NON_NS_RECONNECT Error al deshabilitar SR
132 NS_ICA_ERR_REDUC_NOT_V3 Versión de ICA Reducer no compatible
133 NS_ICA_ERR_HS_COMPRESSION_DISABLED Compresión deshabilitada, no respetada por el host
134 NS_ICA_ERR_IDENT_PROTO No se puede identificar el protocolo ICA o CGP, visto con receptores incorrectos
135 NS_ICA_ERR_INVALID_SIGNATURE Firma o cadena mágica ICA incorrecta
136 NS_ICA_ERR_PARSE_RAW Error al analizar el paquete de intercambio inicial de ICA
137 NS_ICA_ERR_INCOMPLETE_PKT Paquete incompleto recibido en el intercambio inicial
138 NS_ICA_ERR_ICAFRAME_TOO_LARGE La trama ICA es demasiado grande, supera los 1.460 bytes
139 NS_ICA_ERR_FORWARD Error al reenviar los datos ICA
140 NS_ICA_ERR_MAX_HOLES No se puede procesar el comando CGP ya que está dividido más allá del límite admitido
141 NS_ICA_ERR_ASSEMBLE_FRAME No se puede volver a ensamblar la trama ICA correctamente
142 NS_ICA_ERR_UNSUPPORTED_RECEIVER_VERSION Se omitió el análisis de ICA para este espacio de trabajo (cliente) ya que no está en la lista de permitidos
143 NS_ICA_ERR_LOOKUP_RECONNECT_ID No se puede detectar el estado de análisis para la cookie de reconexión del cliente
144 NS_ICA_ERR_SYNCUP_RECONNECT_ID Longitud de cookie de reconexión no válida detectada después de la reconexión del cliente
145 NS_ICA_ERR_INVALID_RECONNECT_ID La cookie de reconexión del cliente no cumplió la restricción necesaria
146 NS_ICA_ERR_INVALID_CLIENT_VERSION Cadena de versión de cliente no válida recibida del cliente
147 NS_ICA_ERR_UNKNOWN_CLIENT_PRODUCT_ID ID de producto de cliente no válido recibido del cliente
148 NS_ICA_ERR_V3_HDR_CORRUPT_LEN Longitud de canal no válida después de la expansión
149 NS_ICA_ERR_SPECIAL_THINWIRE Error de descompresión
150 NS_ICA_ERR_SEAMLESS_INSUFFBYTE Se encontraron bytes insuficientes para el comando Seamless
151 NS_ICA_ERR_EUEM_INSUFFBYTE Se encontraron bytes insuficientes para el comando EUEM
152 NS_ICA_ERR_SEAMLESS_INVALID_EVENT Evento no válido para el análisis del canal Seamless
153 NS_ICA_ERR_CTRL_INVALID_EVENT Evento no válido para el análisis del canal CTRL
154 NS_ICA_ERR_EUEM_INVALID_EVENT Evento no válido para el análisis del canal EUEM
155 NS_ICA_ERR_USB_INVALID_EVENT Evento no válido para el análisis del canal USB
156 NS_ICA_ERR_PURE_INVALID_EVENT Evento no válido para el análisis del canal Pure
157 NS_ICA_ERR_VCP_INVALID_EVENT Evento no válido para el análisis del canal virtual
158 NS_ICA_ERR_ICAP_INVALID_EVENT Evento no válido para el análisis de datos ICA
159 NS_ICA_ERR_CGPP_INVALID_EVENT Evento no válido para el análisis de datos CGP
160 NS_ICA_ERR_BASICCRYPT_INVALIDSTATE Estado no válido para un comando de cifrado en cifrado básico
161 NS_ICA_ERR_BASICCRYPT_INVALIDCRYPTCMD Comando de cifrado no válido en cifrado básico
162 NS_ICA_ERR_ADVCRYPT_INVALIDSTATE Estado no válido para un comando de cifrado en cifrado RC5
163 NS_ICA_ERR_ADVCRYPT_INVALIDCRYPTCMD Comando de cifrado no válido en cifrado RC5
164 NS_ICA_ERR_ADVCRYPT_ENC Error en el cifrado/descifrado RC5
165 NS_ICA_ERR_ADVCRYPT_DEC Error en el cifrado/descifrado RC5
166 NS_ICA_ERR_SERVER_NOT_REDUCER_V3 VDA no es compatible con Reducer Versión 3
167 NS_ICA_ERR_CLIENT_NOT_REDUCER_V3 Workspace no es compatible con Reducer Versión 3
168 NS_ICA_ERR_ICAP_INSUFFBYTE Número inesperado de bytes en el intercambio inicial de ICA
169 NS_ICA_ERR_HIGHER_RECONSEQ Número de secuencia de reanudación CGP superior del par después de las reconexiones
170 NS_ICA_ERR_DESCSRINFO_ABSENT No se puede restaurar el estado de análisis de ICA después de la reconexión
171 NS_ICA_ERR_NSAP_PARSING Error al analizar los datos del canal de Insight
172 NS_ICA_ERR_NSAP_APP Error al analizar los detalles de la aplicación a partir de los datos del canal de Insight
173 NS_ICA_ERR_NSAP_ACR Error al analizar los detalles de ACR a partir de los datos del canal de Insight
174 NS_ICA_ERR_NSAP_SESSION_END Error al analizar los detalles de finalización de sesión a partir de los datos del canal de Insight
175 NS_ICA_ERR_NON_NSAP_SN Se omitió el análisis de ICA en el nodo de servicio debido a la ausencia de soporte de canal de Insight
176 NS_ICA_ERR_NON_NSAP_CLIENT NSAP no es compatible con el cliente
177 NS_ICA_ERR_NON_NSAP_SERVER NSAP no es compatible con VDA
178 NS_ICA_ERR_NSAP_NEG_FAIL Error durante la negociación de datos de NSAP
179 NS_ICA_ERR_SN_RECONNECT_TKT_FETCH Error al obtener el ticket de reconexión de servicio en el nodo de servicio
180 NS_ICA_ERR_SN_HIGHER_RECONSEQ Error al recibir un número de secuencia de reconexión superior en el nodo de servicio
181 NS_ICA_ERR_DISABLE_HDXINSIGHT_NONNSAP Error al deshabilitar HDX Insight para conexiones no NSAP

Registros de ejemplo:

Jan 9 22:57:02 <local0.notice> 10.106.40.223 01/09/2020:22:57:02 GMT ns-223 0-PPE-2 : default ICA Message 1234 0 : "Session setup data send: Session GUID [57af35043e624abab409f5e6af7fd22c], Client IP/Port [10.105.232.40/52314], Server IP/Port [10.106.40.215/2598], MSI Client Cookie [Non-MSI], Session setup time [01/09/2020:22:56:49 GMT], Client Type [0x0052], Receiver Version [19.12.0.23], User [user1], Client [10.105.232.40], Server [WIN2K12-215], Ctx Flags [0x8820220228], Track Flags [0x1775010c3fc], Skip Code [0]"

Jan 9 22:55:41 <local0.notice> 10.106.40.223 01/09/2020:22:55:41 GMT ns-223 0-PPE-0 : default ICA Message 156 0 : "Skipping ICA flow: Session GUID [4e3a91175ebcbe686baf175eec7e0200], Client IP/Port [10.105.232.40/60059], Server IP/Port [10.106.40.219/2598], MSI Client Cookie [Non-MSI], Session setup time [01/09/2020:22:55:39 GMT], Client Type [0x0052], Receiver Version [19.12.0.23], User [user1], Client [10.105.232.40], Server [10.106.40.219], Ctx Flags [0x8820220008], Track Flags [0x1600010c040], Skip Code [171]"

Contadores de errores

Se capturan varios contadores de análisis de ICA. La siguiente tabla enumera los diversos contadores para el análisis de ICA. Ejecuta el comando nsconmsg –g hdx –d statswt0 para ver los detalles del contador.

Nombre del contador HDX Propósito Categoría (Estadísticas/Error/Diagnóstico)
hdx_tot_ica_conn Indica el número total de conexiones ICA puras detectadas por NS. Se incrementa cada vez que se detecta una conexión ICA basada en la firma ICA en una PCB de cliente. Estadísticas
hdx_tot_cgp_conn Indica el número total de conexiones CGP detectadas por NS (Fiabilidad de sesión ACTIVADA). Se incrementa cada vez que se detecta una conexión CGP basada en la firma CGP en una PCB de cliente. Estadísticas
hdx_dbg_tot_udt_conn Indica el número total de conexiones UDP ICA detectadas por NS Estadísticas
hdx_dbg_tot_nsap_conn Indica el número total de conexiones compatibles con NSAP detectadas por NS Estadísticas
hdx_tot_skip_conn Indica cuántas conexiones ICA fueron omitidas por el analizador debido a una firma ICA o CGP no válida. Estadísticas
hdx_dbg_active_conn Total de conexiones EDT/CGP/ICA activas en ese instante. Estadísticas
hdx_dbg_active_nsap_conn Total de conexiones NSAP EDT/CGP/ICA activas en ese instante. Estadísticas
hdx_dbg_skip_appflow_disabled Número total de instancias en las que AppFlow se desvinculó de una sesión debido a la deshabilitación de AppFlow Estadísticas/Diagnóstico
hdx_dbg_transparent_user Número total de accesos de usuario transparentes Estadísticas/Diagnóstico
hdx_dbg_ag_user Número total de accesos de usuario de Access Gateway Estadísticas/Diagnóstico
hdx_dbg_lan_user Número total de accesos en modo de usuario LAN Estadísticas/Diagnóstico
hdx_basic_enc Indica el número de conexiones ICA que usan cifrado básico Estadísticas/Diagnóstico
hdx_advanced_enc Indica el número de conexiones ICA que usan cifrado avanzado basado en RC5 Estadísticas/Diagnóstico
hdx_dbg_reconnected_session Número total de solicitudes de reconexión del cliente sin ningún error de NetScaler Estadísticas/Diagnóstico
hdx_dbg_host_rejected_ns_reconnect Número total de hosts que rechazaron las solicitudes de reconexión del cliente Estadísticas/Diagnóstico
hdx_euem_available Indica el número de conexiones que tienen el canal de supervisión de la experiencia del usuario final disponible. El canal de supervisión de la experiencia del usuario final es necesario para recopilar estadísticas como ICA RTT. Estadísticas/Diagnóstico
hdx_err_disabled_sr La fiabilidad de sesión está deshabilitada usando el parámetro nsapimgr. La sesión no funciona para esta sesión. Error
hdx_err_skip_no_msi El servidor XA/XD carece de capacidad MSI. Esto indica una versión de servidor anterior, HDX Insight omite esta conexión. Error
hdx_err_skip_old_server Versión de servidor antigua no compatible Error
hdx_err_clnt_not_whitelist Receptor de cliente no en la lista de permitidos, HDX Insight omite esta conexión Error
hdx_sm_ica_cam_channel_disabled Número total de NS_ICA_CAM_CHANNEL deshabilitados mediante la política SmartAccess Diagnóstico
hdx_sm_ica_usb_channel_disabled Número total de NS_ICA_USB_CHANNEL deshabilitados mediante la política SmartAccess Diagnóstico
hdx_sm_ica_clip_channel_disabled Número total de NS_ICA_CLIP_CHANNEL deshabilitados mediante la política SmartAccess Diagnóstico
hdx_sm_ica_ccm_channel_disabled Número total de NS_ICA_CCM_CHANNEL deshabilitados mediante la política SmartAccess Diagnóstico
hdx_sm_ica_cdm_channel_disabled Número total de NS_ICA_CDM_CHANNEL deshabilitados mediante la política SmartAccess Diagnóstico
hdx_sm_ica_com1_channel_disabled Número total de NS_ICA_COM1_CHANNEL deshabilitados mediante la política SmartAccess Diagnóstico
hdx_sm_ica_com2_channel_disabled Número total de NS_ICA_COM2_CHANNEL deshabilitados mediante la política SmartAccess Diagnóstico
hdx_sm_ica_cpm_channel_disabled Número total de NS_ICA_CPM_CHANNEL deshabilitados mediante la política SmartAccess Diagnóstico
hdx_sm_ica_lpt1_channel_disabled Número total de NS_ICA_LPT1_CHANNEL deshabilitados mediante la política SmartAccess Diagnóstico
hdx_sm_ica_lpt2_channel_disabled Número total de NS_ICA_LPT2_CHANNEL deshabilitados mediante la política SmartAccess Diagnóstico
dx_dbg_sm_ica_msi_disabled Número total de casos en los que MSI está deshabilitado mediante la política SmartAccess Diagnóstico
hdx_sm_ica_file_channel_disabled Número total de NS_ICA_FILE_CHANNEL deshabilitados mediante la política SmartAccess Diagnóstico
hdx_dbg_usb_accept_device Número total de dispositivos USB aceptados Diagnóstico
hdx_dbg_usb_reject_device Número total de dispositivos USB rechazados Diagnóstico
hdx_dbg_usb_reset_endpoint Número total de puntos finales USB restablecidos Diagnóstico
hdx_dbg_usb_reset_device Número total de dispositivos USB restablecidos Diagnóstico
hdx_dbg_usb_stop_device Número total de dispositivos USB detenidos Diagnóstico
hdx_dbg_usb_stop_device_response Número total de respuestas de dispositivos USB detenidos Diagnóstico
hdx_dbg_usb_device_gone Número total de dispositivos USB desaparecidos Diagnóstico
hdx_dbg_usb_device_stopped Número total de dispositivos USB detenidos Diagnóstico

Validación de nstrace

Comprueba el protocolo CFLOW para ver todos los registros de AppFlow que salen de NetScaler.

Lista de comprobación del relleno de registros en NetScaler Console

  • Ejecuta el comando tail -f /var/mps/log/mps_afdecoder.log | grep -i "Data Record: ica_" y comprueba los registros para confirmar que NetScaler Console está recibiendo registros de AppFlow.

  • Confirma que la instancia de NetScaler está agregada a NetScaler Console.
  • Valida que el servidor virtual NetScaler Gateway/VPN tiene licencia en NetScaler Console.
  • Asegúrate de que la configuración del parámetro de salto múltiple esté habilitada para doble salto.
  • Asegúrate de que NetScaler Gateway esté despejado para el segundo salto en la implementación de doble salto.

Antes de contactar con el soporte técnico de Citrix

Para una resolución rápida, asegúrate de tener la siguiente información antes de contactar con el soporte técnico de Citrix:

  • Detalles de la implementación y la topología de red.

  • Versiones de NetScaler y NetScaler Console.
  • Versiones del servidor de Citrix Virtual Apps and Desktops.
  • Versiones del espacio de trabajo del cliente.
  • Número de sesiones ICA activas cuando ocurrió el problema.
  • Paquete de soporte técnico capturado al ejecutar el comando show techsupport en el símbolo del sistema de NetScaler.
  • Paquete de soporte técnico capturado para NetScaler Console.
  • Rastreos de paquetes capturados en todos los NetScaler. Para iniciar un rastreo de paquetes, escribe start nstrace -size 0' Para detener un rastreo de paquetes, escribe stop nstrace
  • Recopila entradas en la tabla ARP del sistema ejecutando el comando show arp.

Problemas conocidos

Consulta las notas de la versión de NetScaler para conocer los problemas conocidos de HDX Insight.

Solucionar problemas de HDX Insight
August 22, 2025
Contribución de: 
C
August 22, 2025
Contribución de: 
C

En este artículo

Comentarios sobre el sitio | Your privacy choices footer linkSus opciones de privacidad | Condiciones legales y de privacidad | Preferencias de cookies | Parámetros de consentimiento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.