HDX Insight ソリューションが期待どおりに機能しない場合は、次のいずれかの問題が発生している可能性があります。 トラブルシューティングについては、それぞれのセクションのチェックリストを参照してください。
HDX Insight の構成。
NetScaler と NetScaler Console 間の接続。
NetScaler での HDX/ICA トラフィックのレコード生成。
NetScaler コンソールのレコードの入力。
NetScaler で AppFlow 機能が有効になっていることを確認します。 詳細については、「 AppFlow の有効化」を参照してください。
NetScaler の実行構成で HDX Insight 構成を確認します。
show running | grep -i <appflow_policy>
コマンドを実行して、HDX Insight の構成を確認します。 バインド タイプが ICA REQUEST であることを確認します。 例えば;
バインドVPN vserver afsanity -ポリシー afp -優先度 100 -タイプ ICA_REQUEST
透過モードの場合、バインド タイプは ICA_REQ_DEFAULT である必要があります。 例えば;
バインド appflow グローバル afp 100 END -type ICA_REQ_DEFAULT
シングルホップ/アクセス ゲートウェイまたはダブルホップの展開の場合、HDX/ICA トラフィックが流れる VPN 仮想サーバーに HDX Insight AppFlow ポリシーがバインドされていることを確認します。
透過モードまたは LAN ユーザー モードの場合は、ICA ポート 1494 と 2598 が設定されていることを確認してください。
NetScaler Gateway または VPN 仮想サーバーの appflowlog
パラメータが Access Gateway またはダブルホップ展開に対して有効になっていることを確認します。 詳細については、「 仮想サーバーの AppFlow の有効化」を参照してください。
ダブルホップ NetScaler で「接続チェーン」が有効になっていることを確認します。 詳細については、「 データをエクスポートするための NetScaler Gateway アプライアンスの構成」を参照してください。
HA フェイルオーバー後に HDX Insight の詳細が解析をスキップされる場合は、ICA パラメータ「enableSRonHAFailover」が有効になっていることを確認します。 詳細については、「 NetScaler 高可用性ペアのセッション信頼性」を参照してください。
NetScaler で AppFlow コレクターのステータスを確認します。 詳細については、「 NetScaler と AppFlow Collector 間の接続ステータスを確認する方法」を参照してください。
HDX Insight AppFlow ポリシーのヒットを確認します。
AppFlow ポリシーのヒットを確認するには、コマンド show appflow policy <policy_name>
を実行します。
また、GUI で 設定 > AppFlow > ポリシー に移動して、AppFlow ポリシーのヒットを確認することもできます。
AppFlow ポート 4739 または 5557 をブロックしているファイアウォールを検証します。
ログ検証のために、コマンド tail -f /var/log/ns.log | grep -i "default ICA Message"
を実行します。 生成されたログに基づいて、この情報をトラブルシューティングに使用できます。
ログ: ICA 接続の解析をスキップしました - このホストでは HDX Insight はサポートされていません
原因: サポートされていない Citrix Virtual Apps and Desktops のバージョン
回避策: Citrix Virtual Apps and Desktops サーバーをサポートされているバージョンにアップグレードします。
ログ: クライアントタイプが 0x53 を受信しました。サポートされていません
原因: Citrix Workspace のバージョンがサポートされていません
解決策: Citrix Workspace をサポートされているバージョンにアップグレードします。 詳細については、「 Citrix Workspace アプリ」を参照してください。
ログ: 拡張パケットからのエラー - このフローのすべての HDX 処理をスキップします
原因: ICAトラフィックの解凍に関する問題
解決策: 新しいセッションが確立されるまで、この ICA セッションのレポートは利用できません。
ログ: 無効な遷移: NS_ICA_ST_FLOW_INIT/NS_ICA_EVT_INVALID -> NS_ICA_ST_UNINIT”
原因: ICAハンドシェイクの解析に関する問題
解決策: 新しいセッションが確立されるまで、この特定の ICA セッションに関するレポートは利用できません。
ログ: EUEM ICA RTT がありません
原因: エンドユーザーエクスペリエンスモニタリングチャネルデータを解析できません
解決策: Citrix Virtual Apps and Desktops サーバーでエンドユーザー エクスペリエンス監視サービスが開始されていることを確認します。 Citrix Workspace App のサポートされているバージョンを使用していることを確認してください。
ログ: 無効なチャネルヘッダー
原因: チャンネルヘッダーを識別できません
解決策: 新しいセッションが確立されるまで、この特定の ICA セッションに関するレポートは利用できません。
ログ: スキップコード
スキップ コードに次のいずれかの値が表示されている場合は、Insight の詳細はスキップ解析されます。
スキップ コード 0 は、レコードが NetScaler から正常にエクスポートされたことを示します。
スキップコード | エラーメッセージ | エラーの原因 |
---|---|---|
100 | NS_ICA_ERR_NULL_FRAG | ICAフラグメントの処理中にエラーが発生しました。メモリ条件によるものと考えられます。 |
101 | NS_ICA_ERR_INVALID_HS_CMD | 無効なハンドシェイクコマンドを受信しました |
102 | NS_ICA_ERR_REDUC_PARAM_CNT | V3エクスパンダーの初期化に無効なパラメータが指定されました |
103 | NS_ICA_ERR_REDUC_INIT | V3エクスパンダーを正しく初期化できません |
104 | NS_ICA_ERR_REDUC_PARAM_BYTES | コーダをチャネルに割り当てるためのバイト数が不足しています |
105 | NS_ICA_ERR_INVALID_CHANNEL | 無効なICAチャネル番号 |
106 | NS_ICA_ERR_INVALID_DECODER | チャネルに無効なデコーダーが指定されました |
107 | NS_ICA_ERR_INVALID_TW_PARAM | Thinwire チャネルに無効なパラメータ数が指定されました |
108 | NS_ICA_ERR_INVALID_TW_DECODER | Thinwire チャネルの無効なデコーダー |
109 | NS_ICA_ERR_REDUC_NO_DECODER | チャネルにデコーダーが定義されていません |
110 | NS_ICA_ERR_REDUC_V3_EXPANDER | チャンネルデータの拡張に失敗しました |
111 | NS_ICA_ERR_REDUC_BYTES_V3_OOR | エクスパンダーエラー: 消費バイト数が利用可能なバイト数を超えています |
112 | NS_ICA_ERR_REDUC_BYTES_OOR | エラー: 非圧縮データのオーバーラン |
113 | NS_ICA_ERR_REDUC_INVALID_CMD | 未定義のエクスパンダーコマンド |
114 | NS_ICA_ERR_CGP_FILL_HOLE | 分割された CGP フレームの処理中にエラーが発生しました |
115 | NS_ICA_ERR_MEM_NSB_ALLOC | NSB割り当てエラー - メモリ不足のため |
116 | NS_ICA_ERR_MEM_REDUC_CTX_ALLOC | エクスパンダコンテキストのメモリ割り当てエラー |
117 | NS_ICA_ERR_ICA_OLD_SERVER | 古いサーバー、機能ブロックはサポートされていません |
118 | NS_ICA_ERR_PIR_MANY_FRAG | パケット初期化要求が断片化されており、処理できません |
119 | NS_ICA_ERR_INIT_ICA_CAPS | ICA機能初期化エラー |
120 | NS_ICA_ERR_NO_MSI_SUPPORT | ホストは MSI 機能をサポートしていません。 XenApp バージョン 6.5 未満または XenDesktop バージョン 5.0 未満を示します |
121 | NS_ICA_ERR_CGP_INVALID_CMD | 無効なCGPコマンドが検出されました |
122 | NS_ICA_ERR_INSUFFICENT_CHANNEL_BYTES | チャネル上のバイト数が不足しています |
123 | NS_ICA_ERR_CHANNEL_DATA | EUEM、CONTROL、またはSEAMLESSチャネルのデータが不正確です |
124 | NS_ICA_ERR_INVALID_PURE_CMD | 純粋なICAチャネルデータを処理中に無効なコマンドを受信しました |
125 | NS_ICA_ERR_INVALID_PURE_LEN0 | 純粋なICAチャネルデータを処理中に無効な長さが検出されました |
126 | NS_ICA_ERR_INVALID_PURE_LEN | PURE ICA チャネルデータの処理中に無効な長さが検出されました |
127 | NS_ICA_ERR_INVALID_CLNT_DATA | クライアントから受信したデータ長が無効です |
128 | NS_ICA_ERR_MSI_GUID_SZ | MSI GUID サイズのエラー |
129 | NS_ICA_ERR_INVALID_CHANNEL_HEADER | 無効なチャンネルヘッダーが検出されました |
130 | NS_ICA_ERR_CGP_PARSE_RECONNECT_ID | 再接続されたセッションの取得に失敗しました |
131 | NS_ICA_ERR_DISABLE_SR_NON_NS_RECONNECT | SRを無効にする際にエラーが発生しました |
132 | NS_ICA_ERR_REDUC_NOT_V3 | サポートされていない ICA Reducer バージョン |
133 | NS_ICA_ERR_HS_圧縮無効 | 圧縮が無効です。ホストによって無視されます。 |
134 | NS_ICA_ERR_IDENT_PROTO | ICA または CGP プロトコルを識別できません。ワークスペースが正しくありません。 |
135 | NS_ICA_ERR_無効な署名 | ICA 署名またはマジックストリングが正しくありません |
136 | NS_ICA_ERR_PARSE_RAW | ICAハンドシェイクパケットの解析中にエラーが発生しました |
137 | NS_ICA_ERR_INCOMPLETE_PKT | ハンドシェイクで不完全なパケットを受信 |
138 | NS_ICA_ERR_ICAFRAME_TOO_LARGE | ICA フレームが大きすぎます。1460 バイトを超えています。 |
139 | NS_ICA_ERR_FORWARD | ICAデータの転送中にエラーが発生しました |
140 | NS_ICA_ERR_MAX_HOLES | CGP コマンドはサポートされている制限を超えて分割されているため、処理できません |
141 | NS_ICA_ERR_ASSEMBLE_FRAME | ICAフレームを正しく再構成できません |
142 | NS_ICA_ERR_UNSUPPORTED_RECEIVER_VERSION | このワークスペース(クライアント)は許可リストにないため、ICA 解析をスキップしました |
143 | NS_ICA_ERR_LOOKUP_再接続ID | クライアント再接続 Cookie の解析状態を検出できません |
144 | NS_ICA_ERR_SYNCUP_RECONNECT_ID | クライアントの再接続後に無効な再接続 Cookie の長さが検出されました |
145 | NS_ICA_ERR_INVALID_RECONNECT_ID | クライアントはクッキーを再接続しましたが、必要な制約がありませんでした |
146 | NS_ICA_ERR_INVALID_CLIENT_VERSION | クライアントから無効なワークスペース バージョン文字列を受信しました |
147 | NS_ICA_ERR_UNKNOWN_クライアント製品ID | クライアントから無効な製品IDを受け取りました |
148 | NS_ICA_ERR_V3_HDR_CORRUPT_LEN | 拡張後のチャネル長が無効です |
149 | NS_ICA_ERR_SPECIAL_THINWIRE | 減圧エラー |
150 | NS_ICA_ERR_シームレス_INSUFFBYTE | シームレスコマンドのバイト数が不足しています |
151 | NS_ICA_ERR_EUEM_INSUFFBYTE | EUEMコマンドのバイト数が不足しています |
152 | NS_ICA_ERR_SEAMLESS_INVALID_EVENT | シームレス チャネル解析の無効なイベント |
153 | NS_ICA_ERR_CTRL_INVALID_EVENT | CTRL チャネル解析の無効なイベント |
154 | NS_ICA_ERR_EUEM_INVALID_EVENT | EUEM チャネル解析の無効なイベント |
155 | NS_ICA_ERR_USB_INVALID_EVENT | USBチャネル解析の無効なイベント |
156 | NS_ICA_ERR_PURE_INVALID_EVENT | 純粋なチャネル解析では無効なイベントです |
157 | NS_ICA_ERR_VCP_INVALID_EVENT | 仮想チャネル解析の無効なイベント |
158 | NS_ICA_ERR_ICAP_INVALID_EVENT | ICAデータ解析の無効なイベント |
159 | NS_ICA_ERR_CGPP_無効なイベント | CGPデータ解析の無効なイベント |
160 | NS_ICA_ERR_BASICCRYPT_INVALIDSTATE | 基本暗号化における暗号化コマンドの状態が無効です |
161 | NS_ICA_ERR_BASICCRYPT_INVALIDCRYPTCMD | 基本暗号化における無効なcryptコマンド |
162 | NS_ICA_ERR_ADVCRYPT_INVALIDSTATE | RC5暗号化のcryptコマンドの状態が無効です |
163 | NS_ICA_ERR_ADVCRYPT_INVALIDCRYPTCMD | RC5暗号化における無効なcryptコマンド |
164 | NS_ICA_ERR_ADVCRYPT_ENC | RC5暗号化/復号化エラー |
165 | NS_ICA_ERR_ADVCRYPT_DEC | RC5暗号化/復号化エラー |
166 | NS_ICA_ERR_SERVER_NOT_REDUCER_V3 | VDAはReducerバージョン3をサポートしていません |
167 | NS_ICA_ERR_CLIENT_NOT_REDUCER_V3 | ワークスペースはReducerバージョン3をサポートしていません |
168 | NS_ICA_ERR_ICAP_INSUFFBYTE | ICAハンドシェイクで予期しないバイト数が発生しました |
169 | NS_ICA_ERR_HIGHER_RECONSEQ | ピアポスト再接続からの CGP 再開シーケンス番号の増加 |
170 | NS_ICA_ERR_DESCSRINFO_ABSENT | 再接続後にICA解析状態を復元できません |
171 | NS_ICA_ERR_NSAP_PARSING | Insight チャネル データの解析中にエラーが発生しました |
172 | NS_ICA_ERR_NSAP_APP | Insight チャネル データからアプリの詳細を解析中にエラーが発生しました |
173 | NS_ICA_ERR_NSAP_ACR | Insight チャネル データから ACR の詳細を解析中にエラーが発生しました |
174 | NS_ICA_ERR_NSAP_SESSION_END | Insight チャネル データからセッション終了の詳細を解析中にエラーが発生しました |
175 | NS_ICA_ERR_NON_NSAP_SN | Insight チャネルのサポートがないため、サービス ノードでの ICA 解析をスキップしました |
176 | NS_ICA_ERR_NON_NSAP_CLIENT | NSAPはクライアントでサポートされていません |
177 | NS_ICA_ERR_NON_NSAP_SERVER | NSAPはVDAではサポートされていません |
178 | NS_ICA_ERR_NSAP_NEG_FAIL | NSAPデータネゴシエーション中にエラーが発生しました |
179 | NS_ICA_ERR_SN_RECONNECT_TKT_FETCH | サービス ノードでサービス再接続チケットの取得中にエラーが発生しました |
180 | NS_ICA_ERR_SN_HIGHER_RECONSEQ | サービスノードでより高い再接続シーケンス番号を受信するとエラーが発生します |
181 | NS_ICA_ERR_DISABLE_HDXINSIGHT_NONNSAP | 非NSAP接続でHDX Insightを無効にする際にエラーが発生しました |
サンプルログ:
1月9日 22:57:02 <local0.notice> 10.106.40.223 2020年1月9日:22:57:02 GMT ns-223 0-PPE-2: デフォルトICAメッセージ1234 0: 「セッションセットアップデータ送信: セッションGUID [57af35043e624abab409f5e6af7fd22c]、クライアントIP/ポート[10.105.232.40/52314]、サーバーIP/ポート[10.106.40.215/2598]、MSIクライアントCookie [非MSI]、セッションセットアップ時刻[2020年1月9日:22:56:49 GMT]、クライアントタイプ[0x0052]、レシーバーバージョン[19.12.0.23]、ユーザー [user1]、クライアント [10.105.232.40]、サーバー [WIN2K12-215]、Ctxフラグ [0x8820220228]、トラックフラグ [0x1775010c3fc]、スキップコード [0]
1月9日 22:55:41 <local0.notice> 10.106.40.223 2020年1月9日:22:55:41 GMT ns-223 0-PPE-0: デフォルトICAメッセージ156 0: 「ICAフローをスキップしています: セッションGUID [4e3a91175ebcbe686baf175eec7e0200]、クライアントIP/ポート[10.105.232.40/60059]、サーバーIP/ポート[10.106.40.219/2598]、MSIクライアントCookie [非MSI]、セッションセットアップ時間[2020年1月9日:22:55:39 GMT]、クライアントタイプ[0x0052]、レシーバーバージョン[19.12.0.23]、ユーザー [user1]、クライアント [10.105.232.40]、サーバー [10.106.40.219]、Ctxフラグ [0x8820220008]、トラックフラグ [0x1600010c040]、スキップコード [171]
さまざまなカウンターが ICA 解析によってキャプチャされます。 次の表は、ICA 解析のさまざまなカウンターを示しています。 カウンターの詳細を表示するには、コマンド nsconmsg –g hdx –d statswt0
を実行します。
HDXカウンター名 | 目的 | カテゴリ(統計/エラー/診断) |
---|---|---|
hdx_tot_ica_conn | NS によって検出された Pure ICA 接続の合計数を示します。 クライアント PCB 上の ICA 署名に基づく ICA 接続が検出されるたびに増加します。 | 統計 |
hdx_tot_cgp_conn | NS (セッション信頼性オン) によって検出された CGP 接続の合計数を示します。 クライアント PCB 上の CGP 署名に基づく CGP 接続が検出されるたびに増加します。 | 統計 |
hdx_dbg_tot_udt_conn | NSによって検出されたUDP ICA接続の合計数を示します | 統計 |
hdx_dbg_tot_nsap_conn | NSによって検出されたNSAP対応接続の合計数を示します。 | 統計 |
hdx_tot_skip_conn | 無効な ICA または CGP 署名のためにパーサーによってスキップされた ICA 接続の数を示します。 | 統計 |
hdx_dbg_active_conn | その瞬間のアクティブな EDT/CGP/ICA 接続の合計数。 | 統計 |
hdx_dbg_active_nsap_conn | その瞬間のアクティブな EDT/CGP/ICA NSAP 接続の合計数。 | 統計 |
hdx_dbg_skip_appflow_disabled | AppFlow を無効にしたためにセッションから AppFlow が切断されたインスタンスの合計数 | 統計/診断 |
hdx_dbg_transparent_user | 透過的なユーザーアクセスの総数 | 統計/診断 |
hdx_dbg_ag_user | アクセスゲートウェイユーザーアクセスの総数 | 統計/診断 |
hdx_dbg_lan_user | LANユーザーモードアクセスの総数 | 統計/診断 |
hdx_basic_enc | 基本暗号化を使用した ICA 接続の数を示します | 統計/診断 |
hdx_advanced_enc | 高度なRC5ベースの暗号化を使用したICA接続の数を示します | 統計/診断 |
hdx_dbg_再接続セッション | NetScaler エラーのないクライアントからの再接続要求の合計数 | 統計/診断 |
hdx_dbg_host_rejected_ns_reconnect | クライアントによる再接続要求を拒否したホストの総数 | 統計/診断 |
hdx_euem_available | エンド ユーザー エクスペリエンス モニタリング チャネルが利用可能な接続の数を示します。 ICA RTT などの統計情報を収集するには、エンド ユーザー エクスペリエンス モニタリング チャネルが必要です。 | 統計/診断 |
hdx_err_disabled_sr | セッションの信頼性は、 nsapimgr ノブを使用して無効になっています。 このセッションではセッションは機能しません。 |
エラー |
hdx_err_skip_no_msi | XA/XD サーバーに MSI 機能がありません。 これは古いサーバー バージョンを示しており、HDX Insight はこの接続をスキップします。 | エラー |
hdx_err_skip_old_server | サポートされていない古いサーバーバージョン | エラー |
hdx_err_clnt_not_whitelist | クライアントワークスペースが許可リストにないため、HDX Insight はこの接続をスキップします | エラー |
hdx_sm_ica_cam_channel_disabled | SmartAccessポリシーによって無効にされたNS_ICA_CAM_CHANNELの合計数 | 診断 |
hdx_sm_ica_usb_channel_disabled | SmartAccess ポリシーによって無効にされた NS_ICA_USB_CHANNEL の合計数 | 診断 |
hdx_sm_ica_clip_channel_disabled | SmartAccessポリシーによって無効にされたNS_ICA_CLIP_CHANNELの合計数 | 診断 |
hdx_sm_ica_ccm_channel_disabled | SmartAccess ポリシーによって無効にされた NS_ICA_CCM_CHANNEL の合計数 | 診断 |
hdx_sm_ica_cdm_channel_disabled | SmartAccess ポリシーによって無効にされた NS_ICA_CDM_CHANNEL の合計数 | 診断 |
hdx_sm_ica_com1_チャネルが無効 | SmartAccessポリシーによって無効にされたNS_ICA_COM1_CHANNELの合計数 | 診断 |
hdx_sm_ica_com2_チャネルが無効 | SmartAccessポリシーによって無効にされたNS_ICA_COM2_CHANNELの合計数 | 診断 |
hdx_sm_ica_cpm_channel_disabled | SmartAccess ポリシーによって無効にされた NS_ICA_CPM_CHANNEL の合計数 | 診断 |
hdx_sm_ica_lpt1_チャネルが無効 | SmartAccessポリシーによって無効にされたNS_ICA_LPT1_CHANNELの合計数 | 診断 |
hdx_sm_ica_lpt2_チャネルが無効 | SmartAccessポリシーによって無効にされたNS_ICA_LPT2_CHANNELの合計数 | 診断 |
dx_dbg_sm_ica_msi_disabled | SmartAccessポリシーによってMSIが無効にされたケースの総数 | 診断 |
hdx_sm_ica_file_channel_disabled | NS_ICA_FILE_CHANNEL の合計数が SmartAccess ポリシーにより無効になっています | 診断 |
hdx_dbg_usb_accept_device | 受け入れられるUSBデバイスの総数 | 診断 |
hdx_dbg_usb_reject_device | 拒否されたUSBデバイスの総数 | 診断 |
hdx_dbg_usb_reset_endpoint | リセットされたUSBエンドポイントの合計数 | 診断 |
hdx_dbg_usb_reset_device | リセットされたUSBデバイスの合計数 | 診断 |
hdx_dbg_usb_stop_device | 停止したUSBデバイスの合計数 | 診断 |
hdx_dbg_usb_stop_device_response | 停止したUSBデバイスからの応答の総数 | 診断 |
hdx_dbg_usb_device_gone | 紛失したUSBデバイスの総数 | 診断 |
hdx_dbg_usb_device_stopped | 停止したUSBデバイスの合計数 | 診断 |
NetScaler から送信されるすべての AppFlow レコードを確認するには、CFLOW プロトコルをチェックします。
コマンド tail -f /var/mps/log/mps_afdecoder.log | grep -i "Data Record: ica_"
を実行し、ログをチェックして、NetScaler コンソールが AppFlow レコードを受信していることを確認します。
迅速な解決のために、Citrix テクニカル サポートに連絡する前に、次の情報を用意してください。
展開とネットワーク トポロジの詳細。
show techsupport
コマンドを実行してキャプチャされたテクニカル サポート バンドル。start nstrace -size 0'
パケット トレースを停止するには、次のように入力します。 stop nstrace
show arp
コマンドを実行して、システムの ARP テーブル内のエントリを収集します。HDX Insight の既知の問題については、NetScaler のリリース ノートを参照してください。