Solucionar problemas de HDX Insight

Si la solución HDX Insight no funciona como se esperaba, el problema podría deberse a uno de los siguientes. Consulte las listas de comprobación de las secciones correspondientes para la resolución de problemas.

  • Configuración de HDX Insight.

  • Conectividad entre Citrix ADC y Citrix ADM.
  • Generación de registros para el tráfico HDX/ICA en Citrix ADC.
  • Población de registros en Citrix ADM.

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

  • Asegúrese de que la función AppFlow esté habilitada en Citrix ADC. Para obtener información detallada, consulte Activación de AppFlow.

  • Compruebe la configuración de HDX Insight en la configuración de Citrix ADC en ejecución.

    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 es ICA SOLICITUD. 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 la implementación de puerta de enlace de acceso único o de doble salto, asegúrese de que la directiva HDX Insight AppFlow esté vinculada al servidor virtual VPN, donde fluye el tráfico HDX/ICA.
  • Para el modo transparente o el modo de usuario LAN, asegúrese de que los puertos ICA 1494 y 2598 están configurados.
  • Compruebe que el parámetro “appflowlog” en Citrix Gateway o el servidor virtual VPN esté habilitado para Access Gateway o la implementación de doble salto. Para obtener información detallada, consulte Habilitación de AppFlow para servidores virtuales.
  • Compruebe que “Conexión encadenamiento” está activado en Citrix ADC de doble salto. Para obtener información detallada, consulte Configuración de dispositivos Citrix Gateway para exportar datos.
  • Después de la conmutación por error de HA si se analizan los detalles de HDX Insight, compruebe que el parámetro ICA “enableSRonHAFailover” está habilitado. Para obtener información detallada, consulte Fiabilidad de sesión en el par de alta disponibilidad Citrix ADC.

Lista de comprobación de conectividad entre Citrix ADC y Citrix ADM

  • Compruebe el estado del recopilador AppFlow en Citrix ADC. Para obtener información detallada, consulte Cómo comprobar el estado de la conectividad entre Citrix ADC y AppFlow Collector.

  • Compruebe los resultados de las directivas de HDX Insight AppFlow.

    Ejecute el comando show appflow policy <policy_name> para comprobar los aciertos de la directiva AppFlow.

    También puede navegar a Sistema > AppFlow > Directivas en la GUI para comprobar los resultados de la directiva AppFlow.

  • Validar cualquier firewall que bloquee los puertos AppFlow 4739 o 5557.

Generación de registros para el tráfico HDX/ICA en la lista de comprobación de Citrix ADC

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 que se generan, puede utilizar esta información para solucionar problemas.

  • Registro: Conexión ICA de análisis omitido: HDX Insight no compatible con este host

    Causa: Versiones de Citrix Virtual Apps and Desktops no compatibles

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

  • Registro: Tipo de cliente recibido 0x53, NO compatible

    Causa: Versión no compatible de Citrix Workspace App

    Solución: Actualice la aplicación Citrix Workspace a una versión compatible. Para obtener información detallada, consulte Aplicación Citrix Workspace.

  • Log: Error de Expand Packet: Omitir todo el procesamiento hdx para este flujo

    Causa: Problema con la descompresión del tráfico ICA

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

  • Registro: Transición no válida: NS_ICA_ST_FLOW_INIT/NS_ICA_EVT_INVALID -> NS_ICA_ST_UNINIT”

    Causa: Problema con el análisis del protocolo de enlace ICA

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

  • Registro: Falta 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 se haya iniciado en los servidores de Citrix Virtual Apps and Desktops. Asegúrese de utilizar las versiones compatibles de Citrix Workspace App.

  • Registro: Encabezado de canal no válido

    Causa: No se puede identificar el encabezado del canal

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

  • Registro: Omitir código

    Si ve alguno de los siguientes valores para el código de omisión, los detalles de Insight se omiten analizados.

    El código de omisión 0 indica que el registro se ha exportado correctamente desde Citrix ADC.

Omitir código 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 Se recibió un comando de enlace no válido
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 correctamente el expansor V3
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 especificado para un canal no válido
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 Error al expandir los datos del canal
111 NS_ICA_ERR_REDUC_BYTES_V3_OOR Error de expansor: Bytes consumidos más de bytes disponibles
112 NS_ICA_ERR_REDUC_BYTES_OOR Error: Desbordamiento de datos sin comprimir
113 NS_ICA_ERR_REDUC_INVALID_CMD Expansor no definido (comando)
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 memoria baja
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 paquetes está fragmentada, no se puede procesar
119 NS_ICA_ERR_INIT_ICA_CAPS Error de inicialización de la capacidad ICA
120 NS_ICA_ERR_NO_MSI_SUPPORT El host no admite la función MSI. Indica la versión de XenApp inferior a 6.5 o la versión de XenDesktop inferior 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 sobre 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 al procesar datos de canal ICA puros
126 NS_ICA_ERR_INVALID_PURE_LEN Longitud no válida al procesar datos del canal PURE ICA
127 NS_ICA_ERR_INVALID_CLNT_DATA Longitud de datos recibida del cliente no válida
128 NS_ICA_ERR_MSI_GUID_SZ Error en el tamaño del GUID MSI
129 NS_ICA_ERR_INVALID_CHANNEL_HEADER Encabezado de canal no válido detectado
130 NS_ICA_ERR_CGP_PARSE_RECONNECT_ID Error al recuperar la sesión reconectada
131 NS_ICA_ERR_DISABLE_SR_NON_NS_RECONECTAR Error al inhabilitar SR
132 NS_ICA_ERR_REDUC_NOT_V3 Versión de reductor ICA no admitida
133 NS_ICA_ERR_HS_COMPRESSION_DISABLED Compresión inhabilitada, 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 ICA incorrecta o cadena mágica
136 NS_ICA_ERR_PARSE_RAW Error al analizar el paquete 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, supera los 1460 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 soportado
141 NS_ICA_ERR_ASSEMBLE_FRAME No se puede volver a montar el marco ICA correctamente
142 NS_ICA_ERR_UNSUPPORTED_RECEIVER_VERSION Se omitió el análisis ICA para este receptor (cliente) ya que no está en la lista blanca
143 NS_ICA_ERR_LOOKUP_RECONNECT_ID No se puede detectar el estado de análisis de la cookie de reconexión del cliente
144 NS_ICA_ERR_SYNCUP_RECONNECT_ID Longitud de cookie de reconexión no válida detectada tras la reconexión del cliente
145 NS_ICA_ERR_INVALID_RECONNECT_ID La cookie de reconexión del cliente omitió la restricción necesaria
146 NS_ICA_ERR_INVALID_CLIENT_VERSION Cadena de versión de receptor 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 Expansión posterior de longitud de canal no válida
149 NS_ICA_ERR_SPECIAL_THINWIRE Error de descompresión
150 NS_ICA_ERR_SEAMLESS_INSUFFBYTE Se encontraron bytes insuficientes para el comando integrado
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 integrado
153 NS_ICA_ERR_CTRL_INVALID_EVENT Evento no válido para el análisis de 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 de canal puro
157 NS_ICA_ERR_VCP_INVALID_EVENT Evento no válido para el análisis de canales virtuales
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 crypt en cifrado básico
161 NS_ICA_ERR_BASICCRYPT_INVALIDCRYPTCMD Comando crypt no válido en el cifrado básico
162 NS_ICA_ERR_ADVCRYPT_INVALIDSTATE Estado no válido para un comando crypt 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 El VDA no es compatible con Reducer versión 3
167 NS_ICA_ERR_CLIENT_NOT_REDUCER_V3 El receptor 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 Mayor número de secuencia de reanudación de CGP desde la reconexión de post par
170 NS_ICA_ERR_DESCSRINFO_AUSENTE No se puede restaurar el estado de análisis 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 fin de sesión de los datos de canal de Insight
175 NS_ICA_ERR_NON_NSAP_SN Se omitió el análisis ICA en el nodo de servicio debido a la ausencia de soporte de canal Insight
176 NS_ICA_ERR_NON_NSAP_CLIENT NSAP no es compatible con el cliente
177 NS_ICA_ERR_NON_NSAP_SERVER VDA no admite NSAP
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 tíquet de reconexión de servicio en el nodo de servicio
180 NS_ICA_ERR_SN_HIGHER_RECONSEQ Error al recibir mayor número de secuencia de reconexión en el nodo de servicio
181 NS_ICA_ERR_DISABLE_HDXINSIGHT_NONNSAP Error al inhabilitar HDXInsight 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

Varios contadores se capturan análisis ICA. En la siguiente tabla se enumeran los distintos contadores para el análisis ICA. Ejecute el comando nsconmsg –g hdx –d statswt0para ver los detalles del contador.

Nombre del contador HDX Propósito Categoría (Estados/Error/Diagnósticos)
hdx_tot_ica_conn Indica el número total de conexiones ICA puras detectadas por NS.Incrementado cada vez que se detecta una conexión ICA basada en la firma ICA en un PCB cliente. Estadísticas
hdx_tot_cgp_conn Indica el número total de conexiones CGP detectadas por NS (Fiabilidad de la sesión ON). Incrementado cada vez que se detecta una conexión CGP basada en la firma CGP en un PCB cliente. Estadísticas
hdx_dbg_tot_udt_conn Indica el número total de conexiones ICA UDP detectadas por NS Estadísticas
hdx_dbg_tot_nsap_conn Indica el número total de conexiones admitidas por 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 activas EDT/CGP/ICA en ese instante. Estadísticas
hdx_dbg_active_nsap_conn Total de conexiones activas EDT/CGP/ICA NSAP en ese instante. Estadísticas
hdx_dbg_skip_appflow_disabled Número total de instancias en las que AppFlow se ha separado de una sesión debido a la desactivación de AppFlow Estados/Diagnósticos
hdx_dbg_transparent_user Número total de acceso transparente del usuario Estados/Diagnósticos
hdx_dbg_ag_user Número total de acceso de usuario de Access Gateway Estados/Diagnósticos
hdx_dbg_lan_user Número total de acceso en modo de usuario LAN Estados/Diagnósticos
hdx_basic_enc Indica el número de conexiones ICA que utilizan cifrado básico Estados/Diagnósticos
hdx_advanced_enc Indica el número de conexiones ICA que utilizan cifrado avanzado basado en RC5 Estados/Diagnósticos
dx_dbg_wanscaler_on_clientside Número total de conexiones CGP/ICA que tienen Citrix SD-WAN en el lado del cliente Estados/Diagnósticos
hdx_dbg_wanscaler_on_serverside Número total de conexiones CGP/ICA que tienen el lado del servidor de Citrix SD-WAN Estados/Diagnósticos
hdx_dbg_reconnected_session Número total de solicitudes de reconexión del cliente sin ningún error de Citrix ADC Estados/Diagnósticos
hdx_dbg_host_rejected_ns_reconectar Número total de hosts rechazados solicitudes de reconexión por cliente Estados/Diagnósticos
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 experiencia de usuario final es necesario para recopilar estadísticas como ICA RTT. Estados/Diagnósticos
hdx_err_disabled_sr La fiabilidad de la sesión está inhabilitada mediante el botón nsapimgr.La sesión no funciona para esta sesión. Error
hdx_err_skip_no_msi El servidor XA/XD no tiene capacidad MSI. Esto indica una versión anterior del servidor, HDX Insight omite esta conexión. Error
hdx_err_skip_old_server Versión anterior del servidor no compatible Error
hdx_err_clnt_not_whitelist El receptor del cliente no está en la lista blanca, HDX Insight omite esta conexión Error
hdx_sm_ica_cam_channel_disabled Número total de NS_ICA_CAM_CHANNEL inhabilitados a través de la directiva SmartAccess Diagnóstico
hdx_sm_ica_usb_channel_disabled Número total de NS_ICA_USB_CHANNEL inhabilitados a través de la directiva SmartAccess Diagnóstico
hdx_sm_ica_clip_channel_disabled Número total de NS_ICA_CLIP_CHANNEL inhabilitados a través de la directiva SmartAccess Diagnóstico
hdx_sm_ica_ccm_channel_disabled Número total de NS_ICA_CCM_CHANNEL inhabilitados a través de la directiva SmartAccess Diagnóstico
hdx_sm_ica_cdm_channel_disabled Número total de NS_ICA_CDM_CHANNEL inhabilitados a través de la directiva SmartAccess Diagnóstico
hdx_sm_ica_com1_channel_disabled Número total de NS_ICA_COM1_CHANNEL inhabilitados a través de la directiva SmartAccess Diagnóstico
hdx_sm_ica_com2_channel_disabled Número total de NS_ICA_COM2_CHANNEL inhabilitado mediante la directiva SmartAccess Diagnóstico
hdx_sm_ica_cpm_channel_disabled Número total de NS_ICA_CPM_CHANNEL inhabilitados a través de la directiva SmartAccess Diagnóstico
hdx_sm_ica_lpt1_channel_disabled Número total de NS_ICA_LPT1_CHANNEL inhabilitado mediante la directiva SmartAccess Diagnóstico
hdx_sm_ica_lpt2_channel_disabled Número total de NS_ICA_LPT2_CHANNEL inhabilitado mediante la directiva SmartAccess Diagnóstico
dx_dbg_sm_ica_msi_disabled Número total de casos en los que MSI está inhabilitado a través de la directiva SmartAccess Diagnóstico
hdx_sm_ica_file_channel_disabled El número total de NS_ICA_FILE_CHANNEL está inhabilitado mediante la directiva 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 reseteados 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 Citrix ADC.

Población de registros en la lista de comprobación de Citrix ADM

  • Ejecute el comando tail -f /var/mps/log/mps_afdecoder.log | grep -i "Data Record: ica_" y verifique los registros para confirmar que Citrix ADM está recibiendo registros de AppFlow.

  • Confirme que la instancia de Citrix ADC se haya agregado a Citrix ADM.
  • Validar que el servidor virtual Citrix Gateway/VPN tiene licencia en Citrix ADM.
  • Asegúrese de que el parámetro de salto múltiple está habilitado para salto doble.
  • Asegúrese de que Citrix Gateway esté desactivado para el segundo salto en la implementación de doble salto.

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

Para obtener una resolución rápida, asegúrese de que dispone de 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.

  • Citrix ADC y Citrix ADM versiones.
  • Versiones de servidor de Citrix Virtual Apps and Desktops.
  • Versiones de cliente Receiver.
  • Número de sesiones ICA activas cuando se produjo el problema.
  • Paquete de soporte técnico capturado ejecutando el comando show techsupport en el símbolo del sistema de Citrix ADC.
  • Paquete de soporte técnico capturado para Citrix ADM.
  • Rastreos de paquetes capturados en todos los Citrix ADC. Para iniciar un seguimiento de paquete, escriba,start nstrace -size 0' Para detener un seguimiento de paquete, escriba,stop nstrace
  • Recopilar entradas en la tabla ARP del comando show arp.

Problemas conocidos

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