NetScaler Console サービス

HDX Insight の問題のトラブルシューティング

HDX Insight ソリューションが期待どおりに機能しない場合は、次のいずれかの問題が考えられます。トラブルシューティングについては、各セクションのチェックリストを参照してください。

  • HDX Insight の構成
  • NetScaler と NetScaler Console 間の接続
  • NetScaler での HDX/ICA トラフィックのレコード生成
  • NetScaler Console でのレコードの入力

HDX Insight 構成チェックリスト

  • NetScaler で AppFlow 機能が有効になっていることを確認します。詳細については、「AppFlow の有効化」を参照してください。

  • NetScaler の実行中の構成で HDX Insight の構成を確認します。

    HDX Insight の構成を確認するには、show running | grep -i <appflow_policy> コマンドを実行します。バインドタイプが ICA REQUEST であることを確認します。例:

    bind vpn vserver afsanity -policy afp -priority 100 -type 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 が設定されていることを確認します。
  • Access Gateway またはダブルホップ展開の場合、NetScaler Gateway または VPN 仮想サーバーで appflowlog パラメーターが有効になっていることを確認します。詳細については、「仮想サーバーの AppFlow の有効化」を参照してください。
  • ダブルホップ NetScaler で「接続チェーン」が有効になっていることを確認します。詳細については、「NetScaler Gateway アプライアンスのデータエクスポートの構成」を参照してください。
  • HA フェールオーバー後に HDX Insight の詳細がスキップ解析される場合は、ICA パラメーター「enableSRonHAFailover」が有効になっていることを確認します。詳細については、「NetScaler 高可用性ペアでのセッションの信頼性」を参照してください。

NetScaler と NetScaler Console 間の接続チェックリスト

  • NetScaler で AppFlow コレクターのステータスを確認します。詳細については、「NetScaler と AppFlow コレクター間の接続ステータスを確認する方法」を参照してください。

  • HDX Insight AppFlow ポリシーのヒットを確認します。

    AppFlow ポリシーのヒットを確認するには、show appflow policy <policy_name> コマンドを実行します。

    GUI で [System] > [AppFlow] > [Policies] に移動して、AppFlow ポリシーのヒットを確認することもできます。

  • AppFlow ポート 4739 または 5557 をブロックしているファイアウォールがないことを確認します。

NetScaler での HDX/ICA トラフィックのレコード生成チェックリスト

ログの検証には、tail -f /var/log/ns.log | grep -i "default ICA Message" コマンドを実行します。生成されたログに基づいて、この情報をトラブルシューティングに利用できます。

  • ログ: Skipped parsing ICA connection - HDX Insight not supported for this host

    原因: サポートされていない Citrix Virtual Apps and Desktops のバージョン

    回避策: Citrix Virtual Apps and Desktops サーバーをサポートされているバージョンにアップグレードします。

  • ログ: Client type received 0x53, NOT SUPPORTED

    原因: サポートされていない Citrix Workspace アプリのバージョン

    解決策: Citrix Workspace アプリをサポートされているバージョンにアップグレードします。

  • ログ: Error from Expand Packet - Skipping all hdx processing for this flow

    原因: ICA トラフィックの解凍に関する問題

    解決策: 新しいセッションが確立されるまで、この ICA セッションのレポートは利用できません。

  • ログ: Invalid transition: NS_ICA_ST_FLOW_INIT/NS_ICA_EVT_INVALID -> NS_ICA_ST_UNINIT”

    原因: ICA ハンドシェイクの解析に関する問題

    解決策: 新しいセッションが確立されるまで、この特定の ICA セッションのレポートは利用できません。

  • ログ: Missing EUEM ICA RTT

    原因: エンドユーザーエクスペリエンス監視チャネルデータを解析できません。

    解決策: Citrix Virtual Apps and Desktops サーバーでエンドユーザーエクスペリエンス監視サービスが開始されていることを確認します。サポートされているバージョンの Citrix Workspace アプリを使用していることを確認します。

  • ログ: Invalid Channel Header

    原因: チャネルヘッダーを識別できません。

    解決策: 新しいセッションが確立されるまで、この特定の 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 純粋な 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_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 フレームが大きすぎます (1,460 バイトを超えています)。
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 クライアント再接続クッキーの解析状態を検出できません。
144 NS_ICA_ERR_SYNCUP_RECONNECT_ID クライアント再接続後に無効な再接続クッキー長が検出されました。
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 シームレスコマンドに十分なバイトがありません。
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_INVALID_EVENT CGP データ解析のイベントが無効です。
160 NS_ICA_ERR_BASICCRYPT_INVALIDSTATE 基本暗号化における暗号化コマンドの無効な状態。
161 NS_ICA_ERR_BASICCRYPT_INVALIDCRYPTCMD 基本暗号化における無効な暗号化コマンド。
162 NS_ICA_ERR_ADVCRYPT_INVALIDSTATE RC5 暗号化における暗号化コマンドの無効な状態。
163 NS_ICA_ERR_ADVCRYPT_INVALIDCRYPTCMD RC5 暗号化における無効な暗号化コマンド。
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 を無効にしているときにエラーが発生しました。

サンプルログ:

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 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 接続の総数を示します (セッションの信頼性が ON の場合)。クライアント 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 Access Gateway ユーザーアクセスの総数。 統計/診断
hdx_dbg_lan_user LAN ユーザーモードアクセスの総数。 統計/診断
hdx_basic_enc 基本暗号化を使用している ICA 接続の数を示します。 統計/診断
hdx_advanced_enc 高度な RC5 ベースの暗号化を使用している ICA 接続の数を示します。 統計/診断
hdx_dbg_reconnected_session 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_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 SmartAccess ポリシーによって NS_ICA_FILE_CHANNEL が無効にされた総数。 診断
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 の検証

NetScaler から出力されるすべての AppFlow レコードを確認するには、CFLOW プロトコルを確認します。

NetScaler Console でのレコードの入力チェックリスト

  • tail -f /var/mps/log/mps_afdecoder.log | grep -i "Data Record: ica_" コマンドを実行し、ログを確認して NetScaler Console が AppFlow レコードを受信していることを確認します。

  • NetScaler インスタンスが NetScaler Console に追加されていることを確認します。
  • NetScaler Gateway/VPN 仮想サーバーが NetScaler Console でライセンスされていることを確認します。
  • ダブルホップの場合、マルチホップパラメーター設定が有効になっていることを確認します。
  • ダブルホップ展開の場合、NetScaler Gateway がセカンドホップでクリアされていることを確認します。

シトリックステクニカルサポートに問い合わせる前に

迅速な解決のために、シトリックステクニカルサポートに問い合わせる前に、次の情報を用意してください。

  • 展開とネットワークトポロジの詳細
  • NetScaler および NetScaler Console のバージョン
  • Citrix Virtual Apps and Desktops サーバーのバージョン
  • クライアントワークスペースのバージョン
  • 問題発生時のアクティブな ICA セッション数
  • NetScaler コマンドプロンプトで show techsupport コマンドを実行してキャプチャされたテクニカルサポートバンドル
  • NetScaler Console 用にキャプチャされたテクニカルサポートバンドル
  • すべての NetScaler でキャプチャされたパケットトレース パケットトレースを開始するには、start nstrace -size 0' と入力します。 パケットトレースを停止するには、stop nstrace と入力します。
  • show arp コマンドを実行して、システムの ARP テーブルのエントリを収集します。

既知の問題

HDX Insight の既知の問題については、NetScaler のリリースノートを参照してください。