Application Delivery Management

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 dans les sections respectives 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.

  • Population des enregistrements dans la console NetScaler.

Liste de contrôle de configuration HDX Insight

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

  • Vérifiez la configuration HDX Insight dans la configuration 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;

    lier 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;

    lier appflow global afp 100 END -type ICA_REQ_DEFAULT

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

  • 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 Access Gateway ou le déploiement à double saut. Pour plus de détails, voir Activation d’AppFlow pour les serveurs virtuels.

  • Vérifiez que « Chaînage de connexion » est activé dans NetScaler à double saut. Pour plus de détails, voir Configuration des appliances NetScaler Gateway pour exporter des données.

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

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

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

  • Vérifiez les hits de politique HDX Insight AppFlow.

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

    Vous pouvez également accéder à Paramètres > AppFlow > Politiques dans l’interface graphique pour vérifier les succès de la politique AppFlow.

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

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

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 : Analyse de la connexion ICA 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 de contournement: 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 de détails, voir Application Citrix Workspace.

  • Journal : Erreur de paquet d’extension - 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 jusqu’à ce qu’une nouvelle session soit établie.

  • Journal : Transition non valide : 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 jusqu’à ce qu’une nouvelle session soit établie.

  • Journal : RTT EUEM ICA 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 que vous utilisez 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 du canal

    Solution: Aucun rapport n’est disponible pour cette session ICA particulière jusqu’à ce qu’une nouvelle session soit établie.

  • Journal : Code de saut

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

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

Sauter le code Message d’erreur Cause de l’erreur
100 NS_ICA_ERR_NULL_FRAG Erreur lors de la gestion des fragments ICA, probablement due à des 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’extenseur V3
103 NS_ICA_ERR_REDUC_INIT Impossible d’initialiser correctement l’extenseur V3
104 NS_ICA_ERR_REDUC_PARAM_BYTES Nombre d’octets insuffisant pour attribuer un codeur à un canal
105 NS_ICA_ERR_CANAL_INVALIDE Numéro de canal ICA invalide
106 NS_ICA_ERR_DÉCODEUR_INVALIDE 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 invalide pour le canal Thinwire
109 NS_ICA_ERR_REDUC_NO_DECODER Aucun décodeur défini pour la chaîne
110 NS_ICA_ERR_REDUC_V3_EXPANDER Échec de l’extension des données de la chaîne
111 NS_ICA_ERR_REDUC_BYTES_V3_OOR Erreur d’extension : le nombre d’octets consommés est supérieur au nombre d’octets disponibles
112 NS_ICA_ERR_REDUC_BYTES_OOR Erreur : dépassement de capacité des données non compressées
113 NS_ICA_ERR_REDUC_INVALID_CMD Commande d’extension 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 d’extension
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 du paquet est fragmentée et ne peut pas être traitée.
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 les versions XenApp inférieures à 6.5 ou XenDesktop inférieures à 5.0
121 NS_ICA_ERR_CGP_INVALID_CMD Commande CGP non valide rencontrée
122 NS_ICA_ERR_OCTETS_CANAL_INSUFFISANTS Octets insuffisants sur le canal
123 DONNÉES DU CANAL NS_ICA_ERR_CHANNEL 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 de canal ICA pures
125 NS_ICA_ERR_INVALID_PURE_LEN0 Longueur non valide rencontrée lors du traitement des données de canal ICA pures
126 NS_ICA_ERR_INVALID_PURE_LEN Longueur non valide rencontrée lors du traitement des données du 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_EN-TÊTE_DE_CANAL_INVALIDE En-tête de canal non valide détecté
130 ID de reconnexion d’analyse CGP d’erreur NS_ICA 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 ICA Reducer 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 espaces de travail incorrects
135 NS_ICA_ERR_SIGNATURE_INVALIDE Signature ICA incorrecte ou chaîne magique
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 poignée de main
138 NS_ICA_ERR_ICAFRAME_TROP_LARGE La trame ICA est trop grande, dépasse 1460 octets
139 NS_ICA_ERR_FORWARD Erreur lors de la transmission des données ICA
140 NS_ICA_ERR_MAX_TROLS 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 le cadre ICA
142 NS_ICA_ERR_VERSION_RÉCEPTEUR_NON_PRIS_EN_CHARGE L’analyse ICA a été ignorée pour cet espace de travail (client) car il ne figure pas dans la liste autorisée.
143 ID de reconnexion de recherche d’erreur NS_ICA Impossible de détecter l’état d’analyse du cookie de reconnexion du client
144 ID de reconnexion de synchronisation NS_ICA_ERR_SYNCUP Longueur de cookie de reconnexion non valide détectée après la reconnexion du client
145 NS_ICA_ERR_INVALID_RECONNECT_ID Le client se reconnecte au cookie, la contrainte nécessaire a été manquée
146 NS_ICA_ERR_VERSION_CLIENT_INVALIDE Chaîne de version d’espace de travail non valide reçue du client
147 NS_ICA_ERR_INCONNU_CLIENT_PRODUIT_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_INSUFFYTE_SANS_COUTURE J’ai rencontré un nombre insuffisant d’octets pour une 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 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 pure du canal
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 cryptage dans le cryptage de base
161 NS_ICA_ERR_BASICCRYPT_INVALIDCRYPTCMD Commande de cryptage invalide dans le cryptage de base
162 NS_ICA_ERR_ADVCRYPT_INVALIDSTATE État non valide pour une commande de cryptage dans le cryptage RC5
163 NS_ICA_ERR_ADVCRYPT_INVALIDCRYPTCMD Commande de cryptage non valide dans le cryptage 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 VDA ne prend pas en charge Reducer Version 3
167 NS_ICA_ERR_CLIENT_NOT_REDUCER_V3 L’espace de travail ne prend pas en charge Reducer version 3
168 NS_ICA_ERR_ICAP_INSUFFBYTE Nombre inattendu d’octets dans la négociation ICA
169 NS_ICA_ERR_HIGHER_RECONSEQ Numéro de séquence de reprise CGP supérieur à partir des reconnexions 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 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 du 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 :

9 janv. 22:57:02 <local0.notice> 10.106.40.223 01/09/2020:22:57:02 GMT ns-223 0-PPE-2 : Message ICA par défaut 1234 0 : « Envoi des données de configuration de session : GUID de session [57af35043e624abab409f5e6af7fd22c], IP/port du client [10.105.232.40/52314], IP/port du serveur [10.106.40.215/2598], cookie client MSI [non MSI], heure de configuration de session [01/09/2020:22:56:49 GMT], type de client [0x0052], version du récepteur [19.12.0.23], utilisateur [user1], Client [10.105.232.40], Serveur [WIN2K12-215], Indicateurs Ctx [0x8820220228], Indicateurs de suivi [0x1775010c3fc], Code de saut [0]"

9 janv. 22:55:41 <local0.notice> 10.106.40.223 01/09/2020:22:55:41 GMT ns-223 0-PPE-0 : Message ICA par défaut 156 0 : « Flux ICA ignoré : GUID de session [4e3a91175ebcbe686baf175eec7e0200], IP/port du client [10.105.232.40/60059], IP/port du serveur [10.106.40.219/2598], cookie client MSI [non MSI], heure de configuration de la session [01/09/2020:22:55:39 GMT], type de client [0x0052], version du récepteur [19.12.0.23], utilisateur [user1], Client [10.105.232.40], Serveur [10.106.40.219], Indicateurs Ctx [0x8820220008], Indicateurs de suivi [0x1600010c040], Code de saut [171]"

Compteurs d’erreurs

Différents 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 statswt0pour afficher les détails du compteur.

Nom du compteur HDX But 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 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 UDP ICA 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 Nombre total de connexions EDT/CGP/ICA actives à cet instant. Statistiques
hdx_dbg_active_nsap_conn Nombre total de connexions EDT/CGP/ICA NSAP 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 utilisateurs transparents Statistiques/Diagnostics
hdx_dbg_ag_user Nombre total d’accès utilisateurs à Access Gateway Statistiques/Diagnostics
utilisateur_lan_hdx_dbg Nombre total d’accès en mode utilisateur LAN Statistiques/Diagnostics
hdx_basic_enc Indique le nombre de connexions ICA utilisant le cryptage de base Statistiques/Diagnostics
hdx_advanced_enc Indique le nombre de connexions ICA utilisant un cryptage avancé basé sur RC5 Statistiques/Diagnostics
session_reconnectée_hdx_dbg 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 client Statistiques/Diagnostics
hdx_euem_disponible Indique le nombre de connexions disposant du canal de surveillance de l’expérience utilisateur final. Le canal de surveillance de l’expérience utilisateur final est nécessaire pour collecter des statistiques telles que l’ICA RTT. Statistiques/Diagnostics
hdx_err_disabled_sr La fiabilité de la 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 fonctionnalité MSI. Cela indique une version de serveur plus ancienne et HDX Insight ignore cette connexion. Erreur
hdx_err_skip_old_server Ancienne version du serveur non prise en charge Erreur
hdx_err_clnt_not_whitelist L’espace de travail client ne figure pas dans la liste autorisée, HDX Insight ignore cette connexion Erreur
hdx_sm_ica_cam_channel_disabled Nombre total de NS_ICA_CAM_CHANNEL désactivés via la politique SmartAccess Diagnostic
canal_usb_hdx_sm_ica_désactivé Nombre total de NS_ICA_USB_CHANNEL désactivés via la politique SmartAccess Diagnostic
hdx_sm_ica_clip_channel_disabled Nombre total de NS_ICA_CLIP_CHANNEL désactivés via la politique SmartAccess Diagnostic
hdx_sm_ica_ccm_channel_disabled Nombre total de NS_ICA_CCM_CHANNEL désactivés via la politique SmartAccess Diagnostic
hdx_sm_ica_cdm_channel_disabled Nombre total de NS_ICA_CDM_CHANNEL désactivés via la politique SmartAccess Diagnostic
hdx_sm_ica_com1_channel_disabled Nombre total de NS_ICA_COM1_CHANNEL désactivés via la politique SmartAccess Diagnostic
hdx_sm_ica_com2_channel_disabled Nombre total de NS_ICA_COM2_CHANNEL désactivés via la politique SmartAccess Diagnostic
hdx_sm_ica_cpm_channel_disabled Nombre total de NS_ICA_CPM_CHANNEL désactivés via la politique SmartAccess Diagnostic
hdx_sm_ica_lpt1_channel_disabled Nombre total de NS_ICA_LPT1_CHANNEL désactivés via la politique SmartAccess Diagnostic
hdx_sm_ica_lpt2_channel_disabled Nombre total de NS_ICA_LPT2_CHANNEL désactivés via la politique SmartAccess Diagnostic
dx_dbg_sm_ica_msi_disabled Nombre total de cas où MSI est désactivé via la politique SmartAccess Diagnostic
hdx_sm_ica_file_channel_disabled Le nombre total de NS_ICA_FILE_CHANNEL est désactivé via la politique SmartAccess Diagnostic
hdx_dbg_usb_accept_device Nombre total de périphériques USB acceptés Diagnostic
périphérique de rejet usb hdx_dbg 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
périphérique de réinitialisation hdx_dbg_usb Nombre total de périphériques USB réinitialisés Diagnostic
périphérique d’arrêt hdx_dbg_usb Nombre total de périphériques USB arrêtés Diagnostic
hdx_dbg_usb_stop_device_response Nombre total de réponses provenant de périphériques USB arrêtés Diagnostic
périphérique usb hdx_dbg_disparu Nombre total de périphériques USB disparus Diagnostic
périphérique_usb_hdx_dbg_arrêté 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 de la population des enregistrements dans la console NetScaler

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

  • Confirmez que l’instance NetScaler est ajoutée à la console NetScaler.
  • Validez que le serveur virtuel NetScaler Gateway/VPN est sous licence dans la console NetScaler.
  • Assurez-vous que le paramètre multi-sauts est activé pour le double-saut.
  • Assurez-vous que NetScaler 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 NetScaler et de la console NetScaler.
  • Versions du serveur Citrix Virtual Apps and Desktops.
  • Versions de l’espace de travail client.
  • Nombre de sessions ICA actives lorsque le problème s’est produit.
  • Ensemble de support technique capturé en exécutant la commande show techsupport à l’invite de commande NetScaler.
  • Ensemble de support technique capturé pour la console NetScaler.
  • Traces de paquets capturées sur tous les NetScaler. Pour démarrer un suivi de paquets, tapez, start nstrace -size 0' Pour arrêter un suivi de paquets, tapez, stop nstrace
  • Collectez les entrées dans la table ARP du système en exécutant la commande show arp .

Problèmes connus

Consultez les notes de version de NetScaler pour les problèmes connus sur HDX Insight.