Solucionar problemas de HDX™ Insight

Last published : Oct 02, 2026
Si la solución HDX Insight no funciona como se espera, el problema podría estar en uno de los siguientes puntos. Consulte las listas de comprobación en las secciones respectivas para la solución de problemas.
  • 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úrese de que la función AppFlow esté habilitada en NetScaler. Para obtener más información, consulte Habilitación de AppFlow.
  • Compruebe la configuración de HDX Insight en la configuración en ejecución de NetScaler.
    Ejecute el comando show running | grep -i <appflow_policy> para comprobar la configuración de HDX Insight. Asegúrese 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 un solo salto/Access Gateway o de doble salto, asegúrese de que la directiva AppFlow de HDX Insight esté vinculada al servidor virtual VPN, por donde fluye el tráfico HDX/ICA.
  • Para el modo transparente o el modo de usuario de LAN, asegúrese de que los puertos ICA® 1494 y 2598 estén configurados.
  • Compruebe que el parámetro appflowlog en NetScaler Gateway o el servidor virtual VPN esté habilitado para la implementación de Access Gateway o de doble salto. Para obtener más información, consulte Habilitar AppFlow para servidores virtuales.
  • Compruebe que la «conexión en cadena» esté habilitada en NetScaler de doble salto. Para obtener más información, consulte Configuración de dispositivos NetScaler Gateway para exportar datos.
  • Después de la conmutación por error de HA, si los detalles de HDX Insight se omiten, compruebe que el parámetro ICA «enableSRonHAFailover» esté habilitado. Para obtener más información, consulte Fiabilidad de la sesión en el par de alta disponibilidad de NetScaler.

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

  • Compruebe el estado del recopilador de AppFlow en NetScaler. Para obtener más información, consulte Cómo comprobar el estado de la conectividad entre NetScaler y AppFlow Collector.
  • Compruebe los aciertos de la política de AppFlow® de HDX Insight.
    Ejecute el comando show appflow policy <policy_name> para comprobar los aciertos de la política de AppFlow.
    También puede navegar a Sistema > AppFlow > Políticas en la GUI para comprobar los aciertos de la política de AppFlow.
  • Valide cualquier firewall que bloquee los puertos AppFlow 4739 o 5557.

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

Ejecute el comando tail -f /var/log/ns.log | grep -i "default ICA Message" para la validación del registro. En función de los registros generados, puede utilizar esta información para la resolución de problemas.
  • Registro: Análisis de conexión ICA omitido: HDX Insight no es compatible con este host
    Causa: Versiones no compatibles de Citrix Virtual Apps and Desktops
    Solución alternativa: Actualice los servidores de Citrix Virtual Apps and Desktops a una versión compatible.
  • Registro: Tipo de cliente recibido 0x53, NO COMPATIBLE
    Causa: Versión no compatible de la aplicación Citrix Workspace
    Solución: Actualice 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 protocolo de enlace 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úrese 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úrese de que está utilizando 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 ve alguno de los siguientes valores para el código de omisión, los detalles de Insight se omiten en el análisis.
    El código de omisión 0 indica que el registro se ha exportado 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 protocolo de enlace 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 Decodificador 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 Decodificador no válido para el canal Thinwire
109 NS_ICA_ERR_REDUC_NO_DECODER No hay decodificador definido para el canal
110 NS_ICA_ERR_REDUC_V3_EXPANDER No se pudieron expandir los datos del canal
111 NS_ICA_ERR_REDUC_BYTES_V3_OOR Error del expansor: Bytes consumidos superan 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 no definido
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 inicio de paquete está fragmentada, no se puede procesar
119 NS_ICA_ERR_INIT_ICA_CAPS Error de inicialización de la capacidad de ICA
120 NS_ICA_ERR_NO_MSI_SUPPORT El host no es compatible con la función MSI. Indica una versión de XenApp inferior a 6.5 o versiones de XenDesktop inferiores a 5.0
121 NS_ICA_ERR_CGP_INVALID_CMD Se encontró un comando CGP no válido
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 del canal ICA puro
125 NS_ICA_ERR_INVALID_PURE_LEN0 Longitud no válida encontrada al procesar datos del canal ICA puro
126 NS_ICA_ERR_INVALID_PURE_LEN Longitud no válida encontrada al procesar datos del canal PURE ICA
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 del GUID de MSI
129 NS_ICA_ERR_INVALID_CHANNEL_HEADER Cabecera de canal no válida detectada
130 NS_ICA_ERR_CGP_PARSE_RECONNECT_ID Error al recuperar 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 reconocida por el host
134 NS_ICA_ERR_IDENT_PROTO No se puede identificar el protocolo ICA o CGP, observado con receptores incorrectos
135 NS_ICA_ERR_INVALID_SIGNATURE Firma ICA o cadena mágica incorrecta
136 NS_ICA_ERR_PARSE_RAW Error al analizar el paquete de protocolo de enlace ICA
137 NS_ICA_ERR_INCOMPLETE_PKT Paquete incompleto recibido en el protocolo de enlace
138 NS_ICA_ERR_ICAFRAME_TOO_LARGE El marco ICA es demasiado grande, excede 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 el marco 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 Se detectó una longitud de cookie de reconexión no válida después de la reconexión del cliente
145 NS_ICA_ERR_INVALID_RECONNECT_ID La cookie de reconexión del cliente no cumplió con la restricción necesaria
146 NS_ICA_ERR_INVALID_CLIENT_VERSION Cadena de versión de espacio de trabajo no válida recibida del cliente
147 NS_ICA_ERR_UNKNOWN_CLIENT_PRODUCT_ID ID de producto 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 sin interrupciones
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 de canal sin interrupciones
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 puro
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 el cifrado básico
161 NS_ICA_ERR_BASICCRYPT_INVALIDCRYPTCMD Comando de cifrado no válido en el cifrado básico
162 NS_ICA_ERR_ADVCRYPT_INVALIDSTATE Estado no válido para un comando de cifrado en el cifrado RC5
163 NS_ICA_ERR_ADVCRYPT_INVALIDCRYPTCMD Comando crypt no válido en el 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 protocolo de enlace ICA
169 NS_ICA_ERR_HIGHER_RECONSEQ Número de secuencia de reanudación de 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 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 de los datos del canal de Insight
175 NS_ICA_ERR_NON_NSAP_SN Análisis de ICA omitido 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 NSAP
179 NS_ICA_ERR_SN_RECONNECT_TKT_FETCH Error al obtener el ticket de reconexión del 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 que no son 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 ICA. La siguiente tabla enumera los distintos contadores para el análisis ICA. Ejecute 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. Stats
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. Stats
hdx_dbg_tot_udt_conn Indica el número total de conexiones UDP ICA detectadas por NS Stats
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 utilizan cifrado básico Estadísticas/Diagnóstico
hdx_advanced_enc Indica el número de conexiones ICA que utilizan 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 solicitudes de reconexión rechazadas por el cliente. Estadísticas/Diagnóstico
hdx_euem_available Indica el número de conexiones que tienen disponible el canal de supervisión de la experiencia del usuario final. 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 la sesión está inhabilitada mediante 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 la 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 El receptor del cliente no está 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 a través de la política de SmartAccess Diagnóstico
hdx_sm_ica_usb_channel_disabled Número total de NS_ICA_USB_CHANNEL deshabilitados a través de la política de SmartAccess Diagnóstico
hdx_sm_ica_clip_channel_disabled Número total de NS_ICA_CLIP_CHANNEL deshabilitados a través de la política de SmartAccess Diagnóstico
hdx_sm_ica_ccm_channel_disabled Número total de NS_ICA_CCM_CHANNEL deshabilitados a través de la política de SmartAccess Diagnóstico
hdx_sm_ica_cdm_channel_disabled Número total de NS_ICA_CDM_CHANNEL deshabilitados mediante la política de SmartAccess Diagnóstico
hdx_sm_ica_com1_channel_disabled Número total de NS_ICA_COM1_CHANNEL deshabilitados mediante la política de SmartAccess Diagnóstico
hdx_sm_ica_com2_channel_disabled Número total de NS_ICA_COM2_CHANNEL deshabilitados mediante la política de SmartAccess Diagnóstico
hdx_sm_ica_cpm_channel_disabled Número total de NS_ICA_CPM_CHANNEL deshabilitados mediante la política de SmartAccess Diagnóstico
hdx_sm_ica_lpt1_channel_disabled Número total de NS_ICA_LPT1_CHANNEL deshabilitados mediante la política de SmartAccess Diagnóstico
hdx_sm_ica_lpt2_channel_disabled Número total de NS_ICA_LPT2_CHANNEL deshabilitados a través de la política SmartAccess Diagnóstico
dx_dbg_sm_ica_msi_disabled Número total de casos en los que MSI está deshabilitado a través de la política SmartAccess Diagnóstico
hdx_sm_ica_file_channel_disabled Número total de NS_ICA_FILE_CHANNEL deshabilitados a través de 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

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

Lista de comprobación de la población de registros en NetScaler Console

  • Ejecute el comando tail -f /var/mps/log/mps_afdecoder.log | grep -i "Data Record: ica_"y compruebe los registros para confirmar que NetScaler Console está recibiendo registros de AppFlow.
  • Confirme que la instancia de NetScaler se ha añadido a NetScaler Console.
  • Valide que el servidor virtual NetScaler Gateway/VPN tiene licencia en NetScaler Console.
  • Asegúrese de que la configuración del parámetro de salto múltiple está habilitada para doble salto.
  • Asegúrese de que NetScaler Gateway está despejado para el segundo salto en una implementación de doble salto.

Antes de ponerse en contacto con el soporte técnico de Citrix

Para una resolución rápida, asegúrese de tener la siguiente información antes de ponerse en contacto 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.
  • Rastros de paquetes capturados en todos los NetScaler. Para iniciar un rastro de paquetes, escriba start nstrace -size 0' Para detener un rastro de paquetes, escriba stop nstrace
  • Recopile entradas en la tabla ARP del sistema ejecutando el comando show arp.

Problemas conocidos

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