Citrix Application Delivery Management service

Résoudre les problèmes HDX Insight

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 Citrix ADC et Citrix ADM.
  • Génération d’enregistrements pour le trafic HDX/ICA dans Citrix ADC.
  • Population d’enregistrements dans Citrix ADM.

Liste de contrôle de configuration HDX Insight

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

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

    Exécutez la show running | grep -i <appflow_policy> commande 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 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 de passerelle à guichet unique 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érifier le paramètre « appflowlog » dans Citrix Gateway ou le serveur virtuel VPN est activé pour Access Gateway ou le déploiement à double saut. Pour plus de détails, consultez la section Activation d’AppFlow pour les serveurs virtuels.
  • La case « Chaîne de connexion » est activée dans Citrix ADC à double saut. Pour plus de détails, voir Configuration des appliances Citrix Gateway pour exporter des données.
  • Après le basculement HA si les détails HDX Insight sont analysés, cochez le paramètre ICA « EnableSronHafailover » est activé. Pour plus de détails, consultez la section Fiabilité de session sur la paire haute disponibilité Citrix ADC.

Liste de contrôle de la connectivité entre Citrix ADC et Citrix ADM

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

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

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

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

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

Génération d’enregistrement pour le trafic HDX/ICA dans Citrix ADC

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

  • Journal : ICA d’analyse ignorée - HDX Insight n’est pas pris en charge pour cet hôte

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

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

  • Journal : Type de client reçu 0x53, NON pris en charge

    Cause : Version non prise en charge de l’application Citrix Workspace

    Solution : mettez à niveau l’application Citrix Workspace vers une version prise en charge. Pour plus de détails, consultez la section Application Citrix Workspace.

  • Journal : Erreur de Expand Packet - Ignorer tout le traitement hdx pour ce flux

    Cause : Problème avec la 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 : Transition non valide : NS_ICA_ST_FLOW_INIT/NS_ICA_EVT_INVALID -> NS_ICA_ST_UNINIT »

    Cause : Problème avec l’analyse de la poignée de main ICA

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

  • Journal : EUEM ICA RTT manquant

    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 Citrix Workspace App.

  • Journal : En-tête de canal non valide

    Cause : impossible d’identifier l’en-tête de canal

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

  • Journal : Ignorer le code

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

    Ignorer le code 0 indique que l’enregistrement est exporté à partir de Citrix ADC.

Ignorer le code Message d’erreur Cause de l’erreur
100 NS_ICA_ERR_NULL_FRAG Erreur lors de la gestion des fragments ICA, probablement en raison de conditions de mémoire
101 NS_ICA_ERR_INVALID_HS_CMD Commande de poignée de main non valide reçue
102 NS_ICA_ERR_REDUC_PARAM_CNT Paramètre non valide spécifié pour l’initialisation de l’expandeur V3
103 NS_ICA_ERR_REDUC_INIT Impossible d’initialiser correctement l’expandeur 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 de canal
111 NS_ICA_ERR_REDUC_BYTES_V3_OOR Erreur de l’expanseur : octets consommés plus que les 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 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 — en raison de conditions de mémoire insuffisantes
116 NS_ICA_ERR_MEM_REDUC_CTX_ALLOC Erreur d’allocation de mémoire pour le contexte de l’expandeur
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 requête d’initialisation de paquets est fragmentée, impossible à traiter
119 NS_ICA_ERR_INIT_ICA_CAPS Erreur d’initialisation de capacité ICA
120 NS_ICA_ERR_NO_MSI_SUPPORT Hôte ne prend pas en charge la fonctionnalité MSI. Indique pour la version XenApp inférieure à 6.5 ou les versions 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 de données de canal ICA pures
125 NS_ICA_ERR_INVALID_PURE_LEN0 Longueur non valide rencontrée lors du traitement de données de canal ICA pures
126 NS_ICA_ERR_INVALID_PURE_LEN Longueur non valide rencontrée lors du traitement des données de canal PURE ICA
127 NS_ICA_ERR_INVALID_CLNT_DATA Longueur de données non valide reçues 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 ICA Reducer 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, vu avec des récepteurs incorrects
135 NS_ICA_ERR_INVALID_SIGNATURE Signature ICA incorrecte ou chaîne magique
136 NS_ICA_ERR_PARSE_RAW Erreur lors de l’analyse du paquet de poignée de main ICA
137 NS_ICA_ERR_INCOMPLETE_PKT Paquet incomplet reçu en poignée de main
138 NS_ICA_ERR_ICAFRAME_TOO_LARGE Le cadre ICA est trop grand, 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 le cadre ICA correctement
142 NS_ICA_ERR_UNSUPPORTED_RECEIVER_VERSION Analyse ICA ignorée pour ce récepteur (client) car il n’est pas dans la liste blanche
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 du client
145 NS_ICA_ERR_INVALID_RECONNECT_ID Le cookie de reconnexion du client a manqué la contrainte nécessaire
146 NS_ICA_ERR_INVALID_CLIENT_VERSION Chaîne de version du récepteur non valide reçue du client
147 NS_ICA_ERR_UNKNOWN_CLIENT_PRODUCT_ID ID 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 transparente des canaux
153 NS_ICA_ERR_CTRL_INVALID_EVENT Événement non valide pour l’analyse des canaux CTRL
154 NS_ICA_ERR_EUEM_INVALID_EVENT Événement non valide pour l’analyse des canaux EUEM
155 NS_ICA_ERR_USB_INVALID_EVENT Événement non valide pour l’analyse des canaux USB
156 NS_ICA_ERR_PURE_INVALID_EVENT Événement non valide pour l’analyse des canaux purs
157 NS_ICA_ERR_VCP_INVALID_EVENT Événement non valide pour l’analyse des canaux virtuels
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 crypt dans le chiffrement de base
161 NS_ICA_ERR_BASICCRYPT_INVALIDCRYPTCMD Commande crypt non valide dans le chiffrement de base
162 NS_ICA_ERR_ADVCRYPT_INVALIDSTATE État non valide pour une commande crypt dans le chiffrement RC5
163 NS_ICA_ERR_ADVCRYPT_INVALIDCRYPTCMD Commande crypt non valide dans le chiffrement RC5
164 NS_ICA_ERR_ADVCRYPT_ENC Erreur dans le chiffrement ou le déchiffrement RC5
165 NS_ICA_ERR_ADVCRYPT_DEC Erreur dans le chiffrement ou le déchiffrement RC5
166 NS_ICA_ERR_SERVER_NOT_REDUCER_V3 VDA ne prend pas en charge Reducer Version 3
167 NS_ICA_ERR_CLIENT_NOT_REDUCER_V3 Le récepteur ne prend pas en charge le réducteur version 3
168 NS_ICA_ERR_ICAP_INSUFFBYTE Nombre inattendu d’octets dans ICA handshake
169 NS_ICA_ERR_HIGHER_RECONSEQ Numéro de séquence de reprise CGP supérieur à partir de la reconnexion post-homologue
170 NS_ICA_ERR_DESCSRINFO_ABSENT Impossible de restaurer l’état d’analyse ICA après 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 du service dans le nœud de service
180 NS_ICA_ERR_SN_HIGHER_RECONSEQ Erreur lors de la réception du numéro de séquence de reconnexion supérieur dans le nœud de service
181 NS_ICA_ERR_DISABLE_HDXINSIGHT_NONNSAP Erreur lors de la désactivation de HDXInsight 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

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

Nom du compteur HDX Objectif Catégorie (Stats/Erreur/Diagnostics)
hdx_tot_ica_conn Indique le nombre total de connexions ICA Pure 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 (Session Reliability ON). 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 NSAP prises en charge détectées par NS Statistiques
hdx_tot_skip_conn Indique combien de connexions ICA ont été 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 transparent 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 au mode utilisateur LAN Statistiques/Diagnostics
hdx_basic_enc Indique le nombre de connexions ICA utilisant le chiffrement de base Statistiques/Diagnostics
hdx_advanced_frc Indique le nombre de connexions ICA utilisant le chiffrement avancé basé sur RC5 Statistiques/Diagnostics
dx_dbg_wanscaler_on_clientside Nombre total de connexions CGP/ICA avec Citrix SD-WAN côté client Statistiques/Diagnostics
hdx_dbg_wanscaler_on_serverside Nombre total de connexions CGP/ICA avec Citrix SD-WAN côté serveur Statistiques/Diagnostics
hdx_dbg_reconnected_session Nombre total de demandes de reconnexion du client sans erreur Citrix ADC Statistiques/Diagnostics
hdx_dbg_host_rejected_ns_reconnect Nombre total d’hôtes rejetés de demandes de reconnexion par client Statistiques/Diagnostics
hdx_euem_available Indique le nombre de connexions dont le canal de surveillance de l’expérience utilisateur final est disponible.Le canal de surveillance de l’expérience utilisateur final est requis pour collecter des statistiques telles que 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. Error
hdx_err_skip_no_msi Le serveur XA/XD est manquant de capacité MSI. Cela indique une version antérieure du serveur, HDX Insight ignore cette connexion. Error
hdx_err_skip_old_server Ancienne version de serveur non prise en charge Error
hdx_err_clnt_not_whitelist Récepteur client non dans la liste blanche, HDX Insight ignore cette connexion Error
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é via la stratégie SmartAccess Diagnostics
hdx_sm_ica_lpt2_channel_disabled Nombre total de NS_ICA_LPT2_CHANNEL désactivé 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 Le nombre total de NS_ICA_FILE_CHANNEL est désactivé 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 provenant de 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_stoppé 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 Citrix ADC.

Population d’enregistrements dans Citrix ADM liste de contrôle

  • 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 Citrix ADM reçoit des enregistrements AppFlow.

  • Confirmez que l’instance Citrix ADC est ajoutée à Citrix ADM.
  • Valider le serveur virtuel Citrix Gateway/VPN est sous licence dans Citrix ADM.
  • Assurez-vous que le paramètre multi-saut est activé pour le double saut.
  • Assurez-vous que Citrix Gateway est désactivée pour le second saut dans le déploiement à double saut.

Avant de contacter le support technique Citrix

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

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

  • Versions Citrix ADC et Citrix ADM.
  • Versions du serveur Citrix Virtual Apps and Desktops.
  • Versions client Receiver.
  • Nombre de sessions ICA actives lorsque le problème s’est produit.
  • Pack de support technique capturé en exécutant la show techsupport commande à l’invite de commande Citrix ADC.
  • Pack de support technique capturé pour Citrix ADM.
  • Traces de paquets capturées sur tous les Citrix ADC. 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 dans la table ARP du système en exécutant la show arp commande.

Problèmes connus

Reportez-vous aux notes de mise à jour de Citrix ADC pour connaître les problèmes connus sur HDX Insight.