Application Delivery Management

Résoudre les problèmes 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 dans les sections correspondantes pour le dépannage.

  • Configuration de HDX Insight.

  • Connectivité entre Citrix ADC et Citrix ADM.

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

  • Population des 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 Activation d’AppFlow.

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

    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 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 le déploiement d’une passerelle d’accès ou d’un saut unique, assurez-vous que la stratégie HDX Insight AppFlow 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 le paramètre appflowlog dans Citrix 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.

  • Cochez « Connection Chaining » est activé dans Citrix ADC double saut. Pour plus de détails, reportez-vous à la section Configuration des dispositifs 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 de plus amples informations, consultez Comment 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 succès de 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 : connexion ICA d’analyse ignorée - HDX Insight non 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 Citrix Workspace

    Solution : mettez à niveau Citrix Workspace vers une version prise en charge. Pour plus d’informations, consultez l’application Citrix Workspace.

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

    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 : Transition non valide : NS_ICA_ST_FLOW_INIT/NS_ICA_EVT_INVALID -> NS_ICA_ST_UNINIT

    Cause : problème lors de l’analyse de la poignée de main ICA

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

  • Log : RTT EUEM ICA manquant

    Cause : Impossible d’analyser les données de 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 que vous utilisez les versions prises en charge de l’application Citrix Workspace.

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

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

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

  • Log : code d’évitement

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

    Le code d’évitement 0 indique que l’enregistrement a été exporté avec succès depuis Citrix ADC.

Code d’évitement 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 prise de contact 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 le module d’extension V3
104 NS_ICA_ERR_REDUC_PARAM_BYTES Nombre d’octets insuffisant pour affecter 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 Impossible d’étendre les données de canal
111 NS_ICA_ERR_REDUC_BYTES_V3_OOR Erreur d’extension : Octets consommés plus que le nombre d’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 Undefined Expander
114 NS_ICA_ERR_CGP_FILL_HOLE Erreur lors de la gestion des trames CGP séparées
115 NS_ICA_ERR_MEM_NSB_ALLOC Erreur d’allocation de NSB — due à des conditions de mémoire insuffisantes
116 NS_ICA_ERR_MEM_REDUC_CTX_ALLOC Erreur d’allocation de mémoire pour le contexte de l’extension
117 NS_ICA_ERR_ICA_OLD_SERVER Ancien serveur, blocs de fonctionnalités non pris en charge
118 NS_ICA_ERR_PIR_MANY_FRAG La requête Packet Init est fragmentée, impossible à traiter
119 NS_ICA_ERR_INIT_ICA_CAPS Erreur d’initialisation de la capacité ICA
120 NS_ICA_ERR_NO_MSI_SUPPORT L’hôte ne prend pas en charge la fonctionnalité MSI. Indique pour les versions de XenApp inférieures à 6.5 ou les versions de XenDesktop inférieures à 5.0
121 NS_ICA_ERR_CGP_INVALID_CMD Commande CGP non valide détectée
122 NS_ICA_ERR_INSUFFICENT_CHANNEL_BYTES Nombre d’octets insuffisant 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 détectée lors du traitement de données de canal ICA pures
126 NS_ICA_ERR_INVALID_PURE_LEN Longueur non valide détecté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ç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 incorrect 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 SR
132 NS_ICA_ERR_REDUC_NOT_V3 Version du réducteur ICA non prise en charge
133 NS_ICA_ERR_HS_COMPRESSION_DISABLED Compression désactivée, non respecté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 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 remonter correctement le cadre ICA
142 NS_ICA_ERR_UNSUPPORTED_RECEIVER_VERSION Analyse ICA ignorée pour ce récepteur (client) car il n’est 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 du 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 reconnecte le client a manqué la contrainte nécessaire
146 NS_ICA_ERR_INVALID_CLIENT_VERSION Chaîne de version de récepteur 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 une commande transparente
151 NS_ICA_ERR_EUEM_INSUFFBYTE Nombre d’octets insuffisant 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 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 de canal pure
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/déchiffrement RC5
165 NS_ICA_ERR_ADVCRYPT_DEC Erreur dans le chiffrement/déchiffrement RC5
166 NS_ICA_ERR_SERVER_NOT_REDUCER_V3 Le VDA ne prend pas en charge Reducer version 3
167 NS_ICA_ERR_CLIENT_NOT_REDUCER_V3 Receiver ne prend pas en charge Reducer version 3
168 NS_ICA_ERR_ICAP_INSUFFBYTE Nombre d’octets inattendu dans la poignée de main ICA
169 NS_ICA_ERR_HIGHER_RECONSEQ Numéro de séquence de reprise CGP plus élevé à partir des reconnexions de post homologues
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 Insight données du canal
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 Insight données de canal
175 NS_ICA_ERR_NON_NSAP_SN L’analyse ICA sur le nœud de service a été ignorée 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 service reconnecte le ticket 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 supérieur dans le nœud
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

Différents compteurs sont capturés par 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 Motif Catégorie (Statistiques/Erreur/Diagnostics)
hdx_tot_ica_conn Indique le nombre total de connexions Pure ICA détectées par NS. Incrémenté chaque fois qu’une connexion ICA basée sur la signature ICA d’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 d’un PCB client est détectée. Statistiques
hdx_dbgsym tot_udt_conn Indique le nombre total de connexions ICA UDP détectées par NS Statistiques
hdx_dbgsym 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 qui ont été ignorées par l’analyseur en raison d’une signature ICA ou CGP non valide. Statistiques
hdx_dbgsym active_conn Nombre total de connexions EDT/CGP/ICA actives à cet instant. Statistiques
hdx_dbgsym active_nsap_conn Nombre total de connexions EDT/CGP/ICA NSAP actives à cet instant. Statistiques
hdx_dbgsym 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_dbgsym transparent_user Nombre total d’accès utilisateur transparents Statistiques/Diagnostics
hdx_bg_ag_user Nombre total d’accès utilisateur Access Gateway Statistiques/Diagnostics
hdx_bg_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
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 demandes de reconnexion par client Statistiques/Diagnostics
hdx_euem_available Indique le nombre de connexions pour lesquelles le canal de surveillance de l’expérience utilisateur final est disponible. Le canal de surveillance de l’expérience utilisateur final est nécessaire 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. Erreur
hdx_err_skip_no_msi La fonctionnalité MSI du serveur XA/XD est absente. Cela indique une ancienne version du serveur, HDX Insight ignore cette connexion. Error
hdx_err_skip_old_server Ancienne version de serveur non prise en charge Erreur
hdx_err_clnt_not_whitelist Le récepteur client n’est 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_dbgsym 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_db_usb_accept_device Nombre total de périphériques USB acceptés Diagnostics
hdx_dbgsym usb_reject_device Nombre total de périphériques USB rejetés Diagnostics
hdx_dbgsym usb_reset_endpoint Nombre total de points de terminaison USB réinitialisés Diagnostics
hdx_dbgsym usb_reset_device Nombre total de périphériques USB réinitialisés Diagnostics
hdx_db_usb_stop_device Nombre total de périphériques USB arrêtés Diagnostics
hdx_dbgsym usb_stop_device_response Nombre total de réponses provenant de périphériques USB arrêtés Diagnostics
hdx_db_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

nstrace validation

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.
  • Validez que le serveur virtuel Citrix Gateway/VPN est sous licence Citrix ADM.
  • Assurez-vous que le réglage des paramètres multi-sauts est activé pour le double saut.
  • Assurez-vous que Citrix Gateway est autorisé pour le deuxième saut dans le 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 du réseau.

  • Versions de Citrix ADC et de Citrix ADM.
  • Versions du serveur Citrix Virtual Apps and Desktops.
  • Versions de Client Receiver
  • Nombre de sessions ICA actives lorsque le problème s’est produit.
  • Bundle de support technique capturé en exécutant la commande show techsupport à 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 de la table ARP du système en exécutant la commande show arp.

Problèmes connus

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