HDX Insight の問題のトラブルシューティング
HDX Insightソリューションが期待どおりに機能しない場合、問題は次のいずれかにある可能性があります。トラブルシューティングについては、各セクションのチェックリストを参照してください。
-
HDX Insightの構成。
-
NetScaler ADCとNetScaler ADM間の接続性。
-
NetScaler ADCでのHDX/ICAトラフィックのレコード生成。
-
NetScaler ADM内のレコードの設定。
HDX Insight 構成チェックリスト
-
NetScaler でAppFlow 機能が有効になっていることを確認します。詳細については、「AppFlowの有効化」を参照してください。
-
NetScaler の実行構成でHDX Insight 構成を確認します。
show running | grep -i <appflow_policy>コマンドを実行して、HDX Insight の設定を確認します。バインドタイプがICA REQUESTであることを確認します。たとえば、bind vpn vserver afsanity -policy afp -priority 100 -type ICA_REQUEST透過モードの場合、バインドタイプはICA_REQ_DEFAULTでなければなりません。たとえば、
bind appflow global afp 100 END -type ICA_REQ_DEFAULT -
シングルホップ/Access Gatewayまたはダブルホップ展開の場合は、HDX/ICAトラフィックが流れているVPN仮想サーバーにHDX Insight AppFlowポリシーがバインドされていることを確認してください。
-
透過モードまたはLANユーザーモードの場合は、ICAポート1494と2598が設定されていることを確認します。
-
Citrix
appflowlogGatewayまたはVPN仮想サーバーのチェックパラメータは、Access Gatewayまたはダブルホップ展開で有効になっています。詳しくは、「仮想サーバーに対する AppFlow の有効化」を参照してください。 -
ダブルホップNetScaler ADC で「接続チェーン」が有効になっていることを確認します。詳しくは、「データをエクスポートするためのNetScaler Gateway アプライアンスの構成」を参照してください。
-
高可用性フェイルオーバー後、HDX Insight の詳細が解析されスキップされている場合は、ICAパラメータ「EnablesronHaFailover」が有効になっていることを確認します。詳しくは、「NetScaler 高可用性ペアのセッション画面の保持」を参照してください。
NetScaler とNetScaler ADM の間の接続チェックリスト
-
NetScaler でAppFlow コレクタのステータスを確認します。詳しくは、「 NetScaler とAppFlow Collector間の接続状態を確認する方法」を参照してください。
-
HDX Insight のAppFlow ポリシーヒットを確認します。
コマンド
show appflow policy <policy_name>を実行して、AppFlow ポリシーのヒットをチェックします。GUI で [ 設定] > [AppFlow] > [ポリシー] に移動して、AppFlow ポリシーヒットを確認することもできます。
-
AppFlow ポート4739または5557をブロックしているファイアウォールを検証します。
NetScaler チェックリストでのHDX/ICAトラフィックのレコード生成
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アプリを使用していることを確認してください。
-
ログ：無効なチャネルヘッダー
原因：チャネルヘッダーを識別できません
解決策：新しいセッションが確立されるまで、この特定のICAセッションのレポートは利用できません。
-
ログ：スキップコード
スキップコードに次の値のいずれかが表示された場合、そのInsight詳細の解析がスキップされます。
スキップコード0は、レコードがNetScaler ADCから正常にエクスポートされたことを示します。
| スキップコード | エラーメッセージ | エラーの原因 |
|---|---|---|
| 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 | Packet Init要求はフラグメント化されており、処理できません |
| 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 | PURE ICAチャネルデータの処理中に無効なコマンドを受け取りました |
| 125 | NS_ICA_ERR_INVALID_PURE_LEN0 | PURE 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 | ストレージリポジトリの無効化中にエラーが発生しました |
| 132 | NS_ICA_ERR_REDUC_NOT_V3 | サポートされていないICAリデューサーバージョン |
| 133 | NS_ICA_ERR_HS_COMPRESSION_DISABLED | 圧縮は無効で、ホストには適用されません |
| 134 | NS_ICA_ERR_IDENT_PROTO | ICAまたはCGPプロトコルを識別できない、誤ったワークスペースで表示される |
| 135 | NS_ICA_ERR_INVALID_SIGNATURE | 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_RECONNECT_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_CLIENT_PRODUCT_ID | クライアントから受け取った製品IDが無効です |
| 148 | NS_ICA_ERR_V3_HDR_CORRUPT_LEN | 拡張後のチャネル長が無効です |
| 149 | NS_ICA_ERR_SPECIAL_THINWIRE | 解凍エラー |
| 150 | NS_ICA_ERR_SEAMLESS_INSUFFBYTE | SEAMLESSコマンドのバイト数が不足しています |
| 151 | NS_ICA_ERR_EUEM_INSUFFBYTE | EUEMコマンドのバイト数が不足しています |
| 152 | NS_ICA_ERR_SEAMLESS_INVALID_EVENT | SEAMLESSチャネル解析のイベントが無効です |
| 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 | PUREチャネル解析のイベントが無効です |
| 157 | NS_ICA_ERR_VCP_INVALID_EVENT | 仮想チャネル解析のイベントが無効です |
| 158 | NS_ICA_ERR_ICAP_INVALID_EVENT | ICAデータ解析のイベントが無効です |
| 159 | NS_ICA_ERR_CGPP_INVALID_EVENT | CGPデータ解析のイベントが無効です |
| 160 | NS_ICA_ERR_BASICCRYPT_INVALIDSTATE | 基本レベルの暗号化のcryptコマンドの状態が無効です |
| 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はリデューサーバージョン3をサポートしていません |
| 167 | NS_ICA_ERR_CLIENT_NOT_REDUCER_V3 | ワークスペースはリデューサーバージョン 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 を無効にしているときにエラーが発生しました |
サンプルログ:
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]"
エラーカウンター
さまざまなカウンターがICA解析でキャプチャされます。次の表に、ICA解析用の各種カウンタを示します。
コマンドnsconmsg –g hdx –d statswt0を実行して、カウンタの詳細を表示します。
| HDX カウンター名 | 目的 | カテゴリ（統計/エラー/診断） |
|---|---|---|
| hdx_tot_ica_conn | NS によって検出されたピュア 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 がサポートする接続の総数を示します | 統計情報 |
| 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接続の数を示します | ステータス/診断 |
| advanced_enc | 高度なRC5ベースの暗号化を使用するICA接続の数を示します | ステータス/診断 |
| reconnected_session | NetScaler ADCエラーのないクライアントからの再接続要求の総数 | ステータス/診断 |
| 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_channel_disabled | SmartAccess ポリシーによって無効化された NS_ICA_COM1_CHANNEL の総数 | 診断 |
| hdx_sm_ica_com2_channel_disabled | SmartAccess ポリシーによって無効化された NS_ICA_COM2_CHANNEL の総数 | 診断 |
| hdx_sm_ica_cpm_channel_disabled | SmartAccess ポリシーによって無効化された NS_ICA_CPM_CHANNEL の総数 | 診断 |
| hdx_sm_ica_lpt1_channel_disabled | SmartAccess ポリシーによって無効にされた NS_ICA_LPT1_CHANNEL の総数 | 診断 |
| hdx_sm_ica_lpt2_channel_disabled | 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デバイスの総数 | 診断 |
nstrace検証
CFLOWプロトコルをチェックして、NetScaler ADCから送信されるすべてのAppFlowレコードを確認します。
NetScaler ADM チェックリスト内のレコードの移入数
-
tail -f /var/mps/log/mps_afdecoder.log | grep -i "Data Record: ica_"コマンドを実行し、ログをチェックして、NetScaler ADMがAppFlow レコードを受信していることを確認します。 - NetScaler インスタンスがNetScaler ADM に追加されていることを確認します。
- NetScaler Gateway/VPN仮想サーバーがNetScaler ADMでライセンスされていることを検証します。
- ダブルホップのマルチホップパラメータ設定が有効になっていることを確認してください。
- ダブルホップ展開では、NetScaler Gatewayがセカンドホップに対してクリアされていることを確認します。
Citrixテクニカルサポートに連絡する前に
迅速に解決するには、Citrixテクニカルサポートに連絡する前に、次の情報があることを確認してください。
-
展開とネットワークトポロジの詳細。
- NetScaler ADCとNetScaler ADM のバージョン。
- Citrix Virtual Apps and Desktopsサーバーのバージョン。
- クライアントワークスペースバージョン。
- 問題が発生したときのアクティブなICAセッションの数。
- Citrix
show techsupportADCコマンドプロンプトでコマンドを実行して取得されたテクニカルサポートバンドル。 - NetScaler ADM 用にキャプチャされた技術サポートバンドル。
- すべてのNetScaler ADCでキャプチャされたパケットトレース。
パケットトレースを開始するには
start nstrace -size 0'、パケットトレースを停止するにはstop nstraceと入力します。 -
show arpコマンドを実行して、システムの ARP テーブル内のエントリを収集します。
既知の問題
HDX Insightの既知の問題については、ADCリリースノートを参照してください。