Documentation Produit
Application Delivery Management
14.1 - Current Release 13.1 13.0
Voir PDF

Dépannage des problèmes HDX™ Insight

December 12, 2025
Contributeur: 
C

Si la solution HDX Insight ne fonctionne pas comme prévu, le problème peut être lié à l’un des éléments suivants. Reportez-vous aux listes de contrôle des sections respectives pour le dépannage.

  • Configuration HDX Insight.

  • Connectivité entre NetScaler et NetScaler ADM.

  • Génération d’enregistrements pour le trafic HDX/ICA dans NetScaler.

  • Remplissage des enregistrements dans NetScaler® ADM.

Liste de contrôle de la configuration HDX Insight

  • Assurez-vous que la fonctionnalité AppFlow est activée dans NetScaler. Pour plus de détails, consultez Activation d’AppFlow.

  • Vérifiez la configuration HDX Insight dans la configuration en cours d’exécution de NetScaler.

    Exécutez la commande show running | grep -i <appflow_policy> pour vérifier la configuration HDX Insight. Assurez-vous que le type de liaison est ICA REQUEST. Par exemple :

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

    Pour le mode transparent, le type de liaison doit être ICA_REQ_DEFAULT. Par exemple :

    bind appflow global afp 100 END -type ICA_REQ_DEFAULT

  • Pour un déploiement à un seul saut/Access Gateway ou à double saut, assurez-vous que la stratégie AppFlow HDX Insight est liée au serveur virtuel VPN, où le trafic HDX/ICA circule.

  • Pour le mode transparent ou le mode utilisateur LAN, assurez-vous que les ports ICA® 1494 et 2598 sont définis.

  • Vérifiez que le paramètre appflowlog dans NetScaler Gateway ou le serveur virtuel VPN est activé pour le déploiement Access Gateway ou à double saut. Pour plus de détails, consultez Activation d’AppFlow pour les serveurs virtuels.

  • Vérifiez que la « chaîne de connexion » est activée dans NetScaler à double saut. Pour plus de détails, consultez Configuration des appliances NetScaler Gateway pour exporter des données.

  • Après un basculement HA, si les détails HDX Insight sont ignorés, vérifiez que le paramètre ICA « enableSRonHAFailover » est activé. Pour plus de détails, consultez Fiabilité de session sur la paire haute disponibilité NetScaler.

Liste de contrôle de la connectivité entre NetScaler et NetScaler ADM

  • Vérifiez l’état du collecteur AppFlow dans NetScaler. Pour plus de détails, consultez Comment vérifier l’état de la connectivité entre NetScaler et AppFlow Collector.

  • Vérifiez les accès de la stratégie AppFlow® HDX Insight.

    Exécutez la commande show appflow policy <policy_name> pour vérifier les accès de la stratégie AppFlow.

    Vous pouvez également naviguer vers Paramètres > AppFlow > Stratégies dans l’interface graphique pour vérifier les accès de la stratégie AppFlow.

  • Validez tout pare-feu bloquant les ports AppFlow 4739 ou 5557.

Liste de contrôle de la génération d’enregistrements pour le trafic HDX/ICA dans NetScaler

Exécutez la commande tail -f /var/log/ns.log | grep -i "default ICA Message" pour la validation des journaux. En fonction des journaux générés, vous pouvez utiliser ces informations pour le dépannage.

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

    Cause : Versions de Citrix Virtual Apps and Desktops non prises en charge

    Solution de contournement : Mettez à niveau les serveurs Citrix Virtual Apps and Desktops vers une version prise en charge.

  • Journal : Client type received 0x53, NOT SUPPORTED

    Cause : Version de Citrix Workspace non prise en charge

    Solution : Mettez à niveau Citrix Workspace vers une version prise en charge. Pour plus de détails, consultez application Citrix Workspace.

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

    Cause : Problème de décompression du trafic ICA

    Solution : Aucun rapport n’est disponible pour cette session ICA tant qu’une nouvelle session n’est pas établie.

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

    Cause : Problème d’analyse de la négociation ICA

    Solution : Aucun rapport n’est disponible pour cette session ICA particulière tant qu’une nouvelle session n’est pas établie.

  • Journal : Missing EUEM ICA RTT

    Cause : Impossible d’analyser les données du canal de surveillance de l’expérience utilisateur final (EUEM)

    Solution : Assurez-vous que le service de surveillance de l’expérience utilisateur final est démarré sur les serveurs Citrix Virtual Apps and Desktops. Assurez-vous d’utiliser les versions prises en charge de l’application Citrix Workspace.

  • Journal : Invalid Channel Header

    Cause : Impossible d’identifier l’en-tête du canal

    Solution : Aucun rapport n’est disponible pour cette session ICA particulière tant qu’une nouvelle session n’est pas établie.

  • Journal : Skip code

    Si vous voyez l’une des valeurs suivantes pour le code d’ignorance, les détails Insight sont ignorés.

    Le code d’ignorance 0 indique que l’enregistrement est exporté avec succès depuis NetScaler.

Code d’ignorance Message d’erreur Cause de l’erreur
100 NS_ICA_ERR_NULL_FRAG Erreur de gestion des fragments ICA, probablement due à des conditions de mémoire
101 NS_ICA_ERR_INVALID_HS_CMD Commande de négociation non valide reçue
102 NS_ICA_ERR_REDUC_PARAM_CNT Paramètre non valide spécifié pour l’initialisation de l’extenseur V3
103 NS_ICA_ERR_REDUC_INIT Impossible d’initialiser correctement l’extenseur V3
104 NS_ICA_ERR_REDUC_PARAM_BYTES Octets insuffisants pour attribuer un codeur à un canal
105 NS_ICA_ERR_INVALID_CHANNEL Numéro de canal ICA non valide
106 NS_ICA_ERR_INVALID_DECODER Décodeur non valide spécifié pour un canal
107 NS_ICA_ERR_INVALID_TW_PARAM Nombre de paramètres non valide spécifié sur le canal Thinwire
108 NS_ICA_ERR_INVALID_TW_DECODER Décodeur non valide pour le canal Thinwire
109 NS_ICA_ERR_REDUC_NO_DECODER Aucun décodeur défini pour le canal
110 NS_ICA_ERR_REDUC_V3_EXPANDER Échec de l’extension des données du canal
111 NS_ICA_ERR_REDUC_BYTES_V3_OOR Erreur de l’extenseur : Octets consommés supérieurs aux octets disponibles
112 NS_ICA_ERR_REDUC_BYTES_OOR Erreur : Dépassement de données non compressées
113 NS_ICA_ERR_REDUC_INVALID_CMD Commande d’extenseur non définie
114 NS_ICA_ERR_CGP_FILL_HOLE Erreur lors de la gestion des trames CGP fractionnées
115 NS_ICA_ERR_MEM_NSB_ALLOC Erreur d’allocation NSB – due à des conditions de mémoire faible
116 NS_ICA_ERR_MEM_REDUC_CTX_ALLOC Erreur d’allocation de mémoire pour le contexte de l’extenseur
117 NS_ICA_ERR_ICA_OLD_SERVER Ancien serveur, blocs de capacités non pris en charge
118 NS_ICA_ERR_PIR_MANY_FRAG La demande d’initialisation de paquet est fragmentée, impossible à traiter
119 NS_ICA_ERR_INIT_ICA_CAPS Erreur d’initialisation des capacités ICA
120 NS_ICA_ERR_NO_MSI_SUPPORT L’hôte ne prend pas en charge la fonctionnalité MSI. Indique une version de XenApp inférieure à 6.5 ou des versions de XenDesktop inférieures à 5.0
121 NS_ICA_ERR_CGP_INVALID_CMD Commande CGP non valide rencontrée
122 NS_ICA_ERR_INSUFFICENT_CHANNEL_BYTES Octets insuffisants sur le canal
123 NS_ICA_ERR_CHANNEL_DATA Données incorrectes sur le canal EUEM, CONTROL ou SEAMLESS
124 NS_ICA_ERR_INVALID_PURE_CMD Commande non valide reçue lors du traitement des données du canal ICA pur
125 NS_ICA_ERR_INVALID_PURE_LEN0 Longueur non valide rencontrée lors du traitement des données du canal ICA pur
126 NS_ICA_ERR_INVALID_PURE_LEN Longueur non valide rencontrée lors du traitement des données du canal ICA PUR
127 NS_ICA_ERR_INVALID_CLNT_DATA Longueur de données non valide reçue du client
128 NS_ICA_ERR_MSI_GUID_SZ Erreur dans la taille du GUID MSI
129 NS_ICA_ERR_INVALID_CHANNEL_HEADER En-tête de canal non valide détecté
130 NS_ICA_ERR_CGP_PARSE_RECONNECT_ID Échec de la récupération de la session reconnectée
131 NS_ICA_ERR_DISABLE_SR_NON_NS_RECONNECT Erreur lors de la désactivation de SR
132 NS_ICA_ERR_REDUC_NOT_V3 Version de réducteur ICA non prise en charge
133 NS_ICA_ERR_HS_COMPRESSION_DISABLED Compression désactivée, non honorée par l’hôte
134 NS_ICA_ERR_IDENT_PROTO Impossible d’identifier le protocole ICA ou CGP, observé avec des espaces de travail incorrects
135 NS_ICA_ERR_INVALID_SIGNATURE Signature ICA ou chaîne magique incorrecte
136 NS_ICA_ERR_PARSE_RAW Erreur lors de l’analyse du paquet de négociation ICA
137 NS_ICA_ERR_INCOMPLETE_PKT Paquet incomplet reçu lors de la négociation
138 NS_ICA_ERR_ICAFRAME_TOO_LARGE La trame ICA est trop grande, dépasse 1460 octets
139 NS_ICA_ERR_FORWARD Erreur lors du transfert des données ICA
140 NS_ICA_ERR_MAX_HOLES Impossible de traiter la commande CGP car elle est divisée au-delà de la limite prise en charge
141 NS_ICA_ERR_ASSEMBLE_FRAME Impossible de réassembler correctement la trame ICA
142 NS_ICA_ERR_UNSUPPORTED_RECEIVER_VERSION Analyse ICA ignorée pour cet espace de travail (client) car il ne figure pas dans la liste d’autorisation
143 NS_ICA_ERR_LOOKUP_RECONNECT_ID Impossible de détecter l’état d’analyse pour le cookie de reconnexion client
144 NS_ICA_ERR_SYNCUP_RECONNECT_ID Longueur de cookie de reconnexion non valide détectée après la reconnexion client
145 NS_ICA_ERR_INVALID_RECONNECT_ID Le cookie de reconnexion client n’a pas respecté la contrainte nécessaire
146 NS_ICA_ERR_INVALID_CLIENT_VERSION Chaîne de version de l’espace de travail non valide reçue du client
147 NS_ICA_ERR_UNKNOWN_CLIENT_PRODUCT_ID ID de produit non valide reçu du client
148 NS_ICA_ERR_V3_HDR_CORRUPT_LEN Longueur de canal non valide après l’extension
149 NS_ICA_ERR_SPECIAL_THINWIRE Erreur de décompression
150 NS_ICA_ERR_SEAMLESS_INSUFFBYTE Octets insuffisants rencontrés pour la commande transparente
151 NS_ICA_ERR_EUEM_INSUFFBYTE Octets insuffisants rencontrés pour la commande EUEM
152 NS_ICA_ERR_SEAMLESS_INVALID_EVENT Événement non valide pour l’analyse du canal transparent
153 NS_ICA_ERR_CTRL_INVALID_EVENT Événement non valide pour l’analyse du canal CTRL
154 NS_ICA_ERR_EUEM_INVALID_EVENT Événement non valide pour l’analyse du canal EUEM
155 NS_ICA_ERR_USB_INVALID_EVENT Événement non valide pour l’analyse du canal USB
156 NS_ICA_ERR_PURE_INVALID_EVENT Événement non valide pour l’analyse du canal pur
157 NS_ICA_ERR_VCP_INVALID_EVENT Événement non valide pour l’analyse du canal virtuel
158 NS_ICA_ERR_ICAP_INVALID_EVENT Événement non valide pour l’analyse des données ICA
159 NS_ICA_ERR_CGPP_INVALID_EVENT Événement non valide pour l’analyse des données CGP
160 NS_ICA_ERR_BASICCRYPT_INVALIDSTATE État non valide pour une commande de chiffrement en chiffrement de base
161 NS_ICA_ERR_BASICCRYPT_INVALIDCRYPTCMD Commande de chiffrement non valide en chiffrement de base
162 NS_ICA_ERR_ADVCRYPT_INVALIDSTATE État non valide pour une commande de chiffrement en chiffrement basé sur RC5
163 NS_ICA_ERR_ADVCRYPT_INVALIDCRYPTCMD Commande de chiffrement non valide en chiffrement basé sur RC5
164 NS_ICA_ERR_ADVCRYPT_ENC Erreur de chiffrement/déchiffrement RC5
165 NS_ICA_ERR_ADVCRYPT_DEC Erreur de chiffrement/déchiffrement RC5
166 NS_ICA_ERR_SERVER_NOT_REDUCER_V3 VDA ne prend pas en charge le réducteur version 3
167 NS_ICA_ERR_CLIENT_NOT_REDUCER_V3 Workspace ne prend pas en charge le réducteur version 3
168 NS_ICA_ERR_ICAP_INSUFFBYTE Nombre d’octets inattendu dans la négociation ICA
169 NS_ICA_ERR_HIGHER_RECONSEQ Numéro de séquence de reprise CGP plus élevé du pair après les reconnexions
170 NS_ICA_ERR_DESCSRINFO_ABSENT Impossible de restaurer l’état d’analyse ICA après la reconnexion
171 NS_ICA_ERR_NSAP_PARSING Erreur lors de l’analyse des données du canal Insight
172 NS_ICA_ERR_NSAP_APP Erreur lors de l’analyse des détails de l’application à partir des données du canal Insight
173 NS_ICA_ERR_NSAP_ACR Erreur lors de l’analyse des détails ACR à partir des données du canal Insight
174 NS_ICA_ERR_NSAP_SESSION_END Erreur lors de l’analyse des détails de fin de session à partir des données du canal Insight
175 NS_ICA_ERR_NON_NSAP_SN Analyse ICA ignorée sur le nœud de service en raison de l’absence de prise en charge du canal Insight
176 NS_ICA_ERR_NON_NSAP_CLIENT NSAP n’est pas pris en charge par le client
177 NS_ICA_ERR_NON_NSAP_SERVER NSAP n’est pas pris en charge par VDA
178 NS_ICA_ERR_NSAP_NEG_FAIL Erreur lors de la négociation des données NSAP
179 NS_ICA_ERR_SN_RECONNECT_TKT_FETCH Erreur lors de la récupération du ticket de reconnexion de service dans le nœud de service
180 NS_ICA_ERR_SN_HIGHER_RECONSEQ Erreur lors de la réception d’un numéro de séquence de reconnexion plus élevé dans le nœud de service
181 NS_ICA_ERR_DISABLE_HDXINSIGHT_NONNSAP Erreur lors de la désactivation de HDX Insight pour les connexions non-NSAP

Exemples de journaux :

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]"

Compteurs d’erreurs

Divers compteurs sont capturés lors de l’analyse ICA. Le tableau suivant répertorie les différents compteurs pour l’analyse ICA. Exécutez la commande nsconmsg –g hdx –d statswt0 pour afficher les détails du compteur.

Nom du compteur HDX Objectif Catégorie (Statistiques/Erreur/Diagnostic)
hdx_tot_ica_conn Indique le nombre total de connexions ICA pures détectées par NS. Incrémenté chaque fois qu’une connexion ICA basée sur la signature ICA sur un PCB client est détectée. Statistiques
hdx_tot_cgp_conn Indique le nombre total de connexions CGP détectées par NS (fiabilité de session activée). Incrémenté chaque fois qu’une connexion CGP basée sur la signature CGP sur un PCB client est détectée. Statistiques
hdx_dbg_tot_udt_conn Indique le nombre total de connexions ICA UDP détectées par NS Statistiques
hdx_dbg_tot_nsap_conn Indique le nombre total de connexions prises en charge par NSAP détectées par NS Statistiques
hdx_tot_skip_conn Indique le nombre de connexions ICA ignorées par l’analyseur en raison d’une signature ICA ou CGP non valide. Statistiques
hdx_dbg_active_conn Total des connexions EDT/CGP/ICA actives à cet instant. Statistiques
hdx_dbg_active_nsap_conn Total des connexions NSAP EDT/CGP/ICA actives à cet instant. Statistiques
hdx_dbg_skip_appflow_disabled Nombre total d’instances où AppFlow a été détaché d’une session en raison de la désactivation d’AppFlow Statistiques/Diagnostic
hdx_dbg_transparent_user Nombre total d’accès utilisateur transparents Statistiques/Diagnostic
hdx_dbg_ag_user Nombre total d’accès utilisateur Access Gateway Statistiques/Diagnostic
hdx_dbg_lan_user Nombre total d’accès en mode utilisateur LAN Statistiques/Diagnostic
hdx_basic_enc Indique le nombre de connexions ICA utilisant le chiffrement de base Statistiques/Diagnostic
hdx_advanced_enc Indique le nombre de connexions ICA utilisant le chiffrement avancé basé sur RC5 Statistiques/Diagnostic
hdx_dbg_reconnected_session Nombre total de demandes de reconnexion du client sans erreur NetScaler Statistiques/Diagnostic
hdx_dbg_host_rejected_ns_reconnect Nombre total d’hôtes ayant rejeté les demandes de reconnexion par le client Statistiques/Diagnostic
hdx_euem_available Indique le nombre de connexions ayant le canal de surveillance de l’expérience utilisateur final disponible. Le canal de surveillance de l’expérience utilisateur final est requis pour collecter des statistiques telles que le RTT ICA. Statistiques/Diagnostic
hdx_err_disabled_sr La fiabilité de session est désactivée à l’aide du bouton nsapimgr. La session ne fonctionne pas pour cette session. Erreur
hdx_err_skip_no_msi Le serveur XA/XD ne dispose pas de la capacité MSI. Cela indique une version de serveur plus ancienne et HDX Insight ignore cette connexion. Erreur
hdx_err_skip_old_server Ancienne version de serveur non prise en charge Erreur
hdx_err_clnt_not_whitelist L’espace de travail client ne figure pas dans la liste d’autorisation, HDX Insight ignore cette connexion Erreur
hdx_sm_ica_cam_channel_disabled Nombre total de NS_ICA_CAM_CHANNEL désactivés via la stratégie SmartAccess Diagnostic
hdx_sm_ica_usb_channel_disabled Nombre total de NS_ICA_USB_CHANNEL désactivés via la stratégie SmartAccess Diagnostic
hdx_sm_ica_clip_channel_disabled Nombre total de NS_ICA_CLIP_CHANNEL désactivés via la stratégie SmartAccess Diagnostic
hdx_sm_ica_ccm_channel_disabled Nombre total de NS_ICA_CCM_CHANNEL désactivés via la stratégie SmartAccess Diagnostic
hdx_sm_ica_cdm_channel_disabled Nombre total de NS_ICA_CDM_CHANNEL désactivés via la stratégie SmartAccess Diagnostic
hdx_sm_ica_com1_channel_disabled Nombre total de NS_ICA_COM1_CHANNEL désactivés via la stratégie SmartAccess Diagnostic
hdx_sm_ica_com2_channel_disabled Nombre total de NS_ICA_COM2_CHANNEL désactivés via la stratégie SmartAccess Diagnostic
hdx_sm_ica_cpm_channel_disabled Nombre total de NS_ICA_CPM_CHANNEL désactivés via la stratégie SmartAccess Diagnostic
hdx_sm_ica_lpt1_channel_disabled Nombre total de NS_ICA_LPT1_CHANNEL désactivés via la stratégie SmartAccess Diagnostic
hdx_sm_ica_lpt2_channel_disabled Nombre total de NS_ICA_LPT2_CHANNEL désactivés via la stratégie SmartAccess Diagnostic
dx_dbg_sm_ica_msi_disabled Nombre total de cas où MSI est désactivé via la stratégie SmartAccess Diagnostic
hdx_sm_ica_file_channel_disabled Nombre total de NS_ICA_FILE_CHANNEL désactivés via la stratégie SmartAccess Diagnostic
hdx_dbg_usb_accept_device Nombre total de périphériques USB acceptés Diagnostic
hdx_dbg_usb_reject_device Nombre total de périphériques USB rejetés Diagnostic
hdx_dbg_usb_reset_endpoint Nombre total de points de terminaison USB réinitialisés Diagnostic
hdx_dbg_usb_reset_device Nombre total de périphériques USB réinitialisés Diagnostic
hdx_dbg_usb_stop_device Nombre total de périphériques USB arrêtés Diagnostic
hdx_dbg_usb_stop_device_response Nombre total de réponses des périphériques USB arrêtés Diagnostic
hdx_dbg_usb_device_gone Nombre total de périphériques USB disparus Diagnostic
hdx_dbg_usb_device_stopped Nombre total de périphériques USB arrêtés Diagnostic

Validation nstrace

Vérifiez le protocole CFLOW pour voir tous les enregistrements AppFlow sortant de NetScaler.

Liste de contrôle du remplissage des enregistrements dans NetScaler ADM

  • Exécutez la commande tail -f /var/mps/log/mps_afdecoder.log | grep -i "Data Record: ica_" et vérifiez les journaux pour confirmer que NetScaler ADM reçoit les enregistrements AppFlow.

  • Confirmez que l’instance NetScaler est ajoutée à NetScaler ADM.
  • Validez que le serveur virtuel NetScaler Gateway/VPN est sous licence dans NetScaler ADM.
  • Assurez-vous que le paramètre multi-sauts est activé pour le double saut.
  • Assurez-vous que NetScaler Gateway est effacé pour le deuxième saut dans un déploiement à double saut.

Avant de contacter le support technique Citrix

Pour une résolution rapide, assurez-vous de disposer des informations suivantes avant de contacter le support technique Citrix :

  • Détails du déploiement et de la topologie réseau.

  • Versions de NetScaler et NetScaler ADM.
  • Versions des serveurs Citrix Virtual Apps and Desktops.
  • Versions de l’espace de travail client.
  • Nombre de sessions ICA actives au moment où le problème est survenu.
  • Bundle de support technique capturé en exécutant la commande show techsupport à l’invite de commande NetScaler.
  • Bundle de support technique capturé pour NetScaler ADM.
  • Traces de paquets capturées sur tous les NetScaler. Pour démarrer une trace de paquets, tapez start nstrace -size 0' Pour arrêter une trace de paquets, tapez stop nstrace
  • Collectez les entrées de la table ARP du système en exécutant la commande show arp.

Problèmes connus

Reportez-vous aux notes de publication d’ADC pour les problèmes connus concernant HDX Insight.

Dépannage des problèmes HDX™ Insight
December 12, 2025
Contributeur: 
C
December 12, 2025
Contributeur: 
C

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.