Service NetScaler Console

Résoudre les problèmes liés à HDX Insight

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

  • Configuration de HDX Insight.

  • Connectivité entre NetScaler et NetScaler Console.
  • Génération d’enregistrements pour le trafic HDX/ICA dans NetScaler.
  • Remplissage des enregistrements dans NetScaler Console.

Liste de contrôle de la configuration de 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 de 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 de HDX Insight. Assurez-vous que le type de liaison est ICA REQUEST. Par exemple :

    bind vpn vserver afsanity -policy afp -priority 100 -type 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 à saut unique/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 configurés.
  • Vérifiez que le paramètre appflowlog dans NetScaler Gateway ou le serveur virtuel VPN est activé pour un 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 de HDX Insight sont ignorés lors de l’analyse, vérifiez que le paramètre ICA « enableSRonHAFailover » est activé. Pour plus de détails, consultez Fiabilité de session sur une paire haute disponibilité NetScaler.

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

  • 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 le collecteur AppFlow.

  • Vérifiez les occurrences de la stratégie AppFlow HDX Insight.

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

    Vous pouvez également accéder à Système > AppFlow > Stratégies dans l’interface graphique pour vérifier les occurrences de la stratégie AppFlow.

  • Validez si un pare-feu bloque 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 non prise en charge de l’application Citrix Workspace

    Solution : Mettez à niveau l’application Citrix Workspace vers une version prise en charge.

  • 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

    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 : Code d’ignorance

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

    Le code d’ignorance 0 indique que l’enregistrement a été 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’expander V3
103 NS_ICA_ERR_REDUC_INIT Impossible d’initialiser correctement l’expander 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’expansion des données du canal
111 NS_ICA_ERR_REDUC_BYTES_V3_OOR Erreur d’expander : 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’expander 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’expander
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 de la 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 une version de XenDesktop inférieure à 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 La récupération de la session reconnectée a échoué
131 NS_ICA_ERR_DISABLE_SR_NON_NS_RECONNECT Erreur lors de la désactivation de la fiabilité de session
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 récepteurs 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 1 460 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 fractionné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 requise
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 inconnu reçu du client
148 NS_ICA_ERR_V3_HDR_CORRUPT_LEN Longueur de canal non valide après l’expansion
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 RC5
163 NS_ICA_ERR_ADVCRYPT_INVALIDCRYPTCMD Commande de chiffrement non valide en chiffrement 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 Le VDA ne prend pas en charge le réducteur version 3
167 NS_ICA_ERR_CLIENT_NOT_REDUCER_V3 L’espace de travail 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 le 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/Diagnostics)
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 UDP ICA détectées par NS Statistiques
hdx_dbg_tot_nsap_conn Indique le nombre total de connexions NSAP prises en charge 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/Diagnostics
hdx_dbg_transparent_user Nombre total d’accès utilisateur transparents Statistiques/Diagnostics
hdx_dbg_ag_user Nombre total d’accès utilisateur Access Gateway Statistiques/Diagnostics
hdx_dbg_lan_user Nombre total d’accès en mode utilisateur LAN Statistiques/Diagnostics
hdx_basic_enc Indique le nombre de connexions ICA utilisant le chiffrement de base Statistiques/Diagnostics
hdx_advanced_enc Indique le nombre de connexions ICA utilisant le chiffrement avancé basé sur RC5 Statistiques/Diagnostics
hdx_dbg_reconnected_session Nombre total de demandes de reconnexion du client sans aucune erreur NetScaler Statistiques/Diagnostics
hdx_dbg_host_rejected_ns_reconnect Nombre total d’hôtes ayant rejeté les demandes de reconnexion par le client Statistiques/Diagnostics
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 l’ICA RTT. Statistiques/Diagnostics
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, 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 Le récepteur 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 Diagnostics
hdx_sm_ica_usb_channel_disabled Nombre total de NS_ICA_USB_CHANNEL désactivés via la stratégie SmartAccess Diagnostics
hdx_sm_ica_clip_channel_disabled Nombre total de NS_ICA_CLIP_CHANNEL désactivés via la stratégie SmartAccess Diagnostics
hdx_sm_ica_ccm_channel_disabled Nombre total de NS_ICA_CCM_CHANNEL désactivés via la stratégie SmartAccess Diagnostics
hdx_sm_ica_cdm_channel_disabled Nombre total de NS_ICA_CDM_CHANNEL désactivés via la stratégie SmartAccess Diagnostics
hdx_sm_ica_com1_channel_disabled Nombre total de NS_ICA_COM1_CHANNEL désactivés via la stratégie SmartAccess Diagnostics
hdx_sm_ica_com2_channel_disabled Nombre total de NS_ICA_COM2_CHANNEL désactivés via la stratégie SmartAccess Diagnostics
hdx_sm_ica_cpm_channel_disabled Nombre total de NS_ICA_CPM_CHANNEL désactivés via la stratégie SmartAccess Diagnostics
hdx_sm_ica_lpt1_channel_disabled Nombre total de NS_ICA_LPT1_CHANNEL désactivés via la stratégie SmartAccess Diagnostics
hdx_sm_ica_lpt2_channel_disabled Nombre total de NS_ICA_LPT2_CHANNEL désactivés via la stratégie SmartAccess Diagnostics
dx_dbg_sm_ica_msi_disabled Nombre total de cas où MSI est désactivé via la stratégie SmartAccess Diagnostics
hdx_sm_ica_file_channel_disabled Nombre total de NS_ICA_FILE_CHANNEL désactivés via la stratégie SmartAccess Diagnostics
hdx_dbg_usb_accept_device Nombre total de périphériques USB acceptés Diagnostics
hdx_dbg_usb_reject_device Nombre total de périphériques USB rejetés Diagnostics
hdx_dbg_usb_reset_endpoint Nombre total de points de terminaison USB réinitialisés Diagnostics
hdx_dbg_usb_reset_device Nombre total de périphériques USB réinitialisés Diagnostics
hdx_dbg_usb_stop_device Nombre total de périphériques USB arrêtés Diagnostics
hdx_dbg_usb_stop_device_response Nombre total de réponses des périphériques USB arrêtés Diagnostics
hdx_dbg_usb_device_gone Nombre total de périphériques USB disparus Diagnostics
hdx_dbg_usb_device_stopped Nombre total de périphériques USB arrêtés Diagnostics

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 Console

  • 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 Console reçoit les enregistrements AppFlow.

  • Confirmez que l’instance NetScaler est ajoutée à NetScaler Console.
  • Validez que le serveur virtuel NetScaler Gateway/VPN est sous licence dans NetScaler Console.
  • Assurez-vous que le paramètre multi-saut est activé pour le double saut.
  • Assurez-vous que NetScaler Gateway est configuré 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 Console.
  • 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 Console.
  • 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

Consultez les notes de publication de NetScaler pour les problèmes connus concernant HDX Insight.