トラブルシューティング

HTML5ログ

HTML5向けCitrix Workspaceアプリは、ユーザーデバイスが生成したログにタイムスタンプを付けます。

  • 問題のトラブルシューティングに役立てるため、HTML5向けCitrix Workspaceアプリセッションログを表示できます。

ログページでは、以下の機能が使用できます:

  • ログの有効化: HMTL5のログを有効にし、表示します。
  • ログの無効化: セッションでログを無効にし、停止します。
  • ログの表示: セッションに対して生成されたログを表示します。
  • ログをクリア: セッションで生成されたログファイルを削除します。
  • ログ ファイルのダウンロード: ログファイルを目的の場所にダウンロードします。

Citrix Workspaceアプリは、進行中の仮想デスクトップおよび仮想アプリのセッションのログ収集をサポートします。 以前は、進行中のセッションで [ログの開始] を選択した後に起動されたセッションのログのみを収集できました。 これによって、[ログの停止] を選択するまで、進行中および次のセッションのログが収集されます。

モバイルデバイスのトラブルシューティングの機能強化

[ログを取得する] オプションをタップすると、セッションログファイルにすばやくアクセスできます。 ログ作成オプションは、[ログ] から [ログを取得する] に変更されました。 セカンダリメニューから [ログを取得する] を選択すると、ログファイルがブラウザーの新しいタブにではなくデバイスにダウンロードされます。

進行中のセッションと最大5つ前までのセッションのログを収集できます。

ログを収集する方法

HTML5向けCitrix Workspaceアプリのクライアントログを収集するには、以下を実行します:

  1. HTML5向けCitrix Workspaceアプリにサインインします。

  2. 次のように[ログファイル]ページにアクセスします:
    • Citrix Workspaceアプリバージョン1908以降の場合、新しいタブを開いて、siteurl/Clients/HTML5Client/src/SessionWindow.html#engineType=logに移動します。ここで、siteurlはWorkspace for WebサイトのURL(https://server.domain/Citrix/StoreWeb)です。
    • Citrix Workspaceアプリバージョン1907以前の場合、新しいタブを開いて、siteurl/Clients/HTML5Client/src/ViewLog.htmlに移動します。ここで、siteurlはCitrix Workspace for WebサイトのURL(例:https://server.domain/Citrix/StoreWeb)です。
  3. [ログファイル] ページで [ログの開始] をクリックします。

    ログの開始

    ログの作成は、現在アクティブなセッション(存在する場合)ではなく、次回のセッション起動で有効になります。

  4. Citrix Workspaceアプリにサインインして仮想アプリセッションを開始し、問題を再現してログを収集します。 問題を再現するために、セッションで作業を続けます。

  5. 問題が再現されたら、セッションを閉じます。

  6. HTML5向けCitrix Workspaceアプリセッションで生成されたログファイルは、ログページに表示されます。

    ログファイル

  7. 矢印ボタンをクリックして、ログファイルをダウンロードして保存します。

    ログファイル

  • HTML5向けCitrix Workspaceアプリのログを有効にして表示するには、セッションツールバーメニューの [ ログ ] オプションを使用できます。

ログツールバー

コンソールログ

HTML5向けCitrix Workspaceアプリのコンソールログを収集するには、以下を実行します:

  1. セッション実行中のWebブラウザーのタブで、開発者ツールを開きます。 たとえば、Google Chromeブラウザーでは、[その他のツール] オプションの下に[デベロッパーツール]があります。

    デベロッパーツール

  2. 開発者ツールを開いて [Console] をクリックします。

  3. 右クリックして [Save as] オプションを選択し、ログ全体を保存します。

    コンソール

USBリダイレクトログ

ログを有効にしてUSBリダイレクト関連の問題のログを収集するには、以下の手順を実行します:

ログの有効化

  1. configuration.jsファイルを編集して、HTML5_CONFIGセクションに移動します。

  2. moreLogs{‘usb’: true}を追加します。 この設定はStoreFrontに関係します。 configuration.jsファイルはC:\program Files\Citrix <actual path>\HTML5Clientにあります。

ログの収集

ログを収集するには、「ログを収集する方法」を参照してください。

デバイスログ

デバイスログを収集するには、Google Chromeブラウザーで新しいタブを開き、chrome://device-logを入力して ログを共有します。

デバイスログ

Microsoft Teamsの最適化ログ

Microsoft Teamsの最適化は、最新のshimライブラリバージョン1.10.0.0をサポートします。

使用している現在のshimバージョンを確認するには:

  1. Microsoft Teamsアプリケーションを開き、ユーザーの1人との通話を開始します。

  2. 通話が確立されたら、Microsoft Teamsウィンドウを最大化します。

  3. セッション内の スクリーンキーボード を開き、Ctrl + Alt + Shift + 1 キーをクリックします。

    これで、VDAのダウンロードフォルダーにあるログファイルを表示できます。

  4. MSTeams_Diagnostics Log <date><time>.txtファイルを開いて、type_scriptでshimバージョンを検索します。 例:”version”:{“type_script”:”1.10.0.0”}。

ログ収集の強化

バージョン2411以降では、Citrix Workspaceアプリのログをzipファイルでダウンロードできるようになり、ログの取得と分析がシンプルになったためトラブルシューティングが容易になり、ユーザーエクスペリエンスが向上します。

この機能のメリットは次のとおりです:

  • ユーザーは個々のログファイルを手動で収集する必要がなくなりました。
  • 合理化されたプロセスにより、ログへのアクセスがより効率的になります。
  • 包括的なログに簡単にアクセスできるため、デバッグがより迅速かつ効果的になります。

エンドユーザーエクスペリエンス

[ログファイル]画面で、[すべてのログをダウンロードする]をクリックします。 アプリは関連するすべてのログファイルを収集し、zipアーカイブに圧縮します。 ダウンロードしたファイルは、CWA_HTML5_LOGS_[timestamp].zipなどの標準化された命名規則を使用して、明確かつ識別しやすいようにします。

すべてのログをダウンロードする

詳しくは、「ログを収集する方法」を参照してください。

Citrix Directorのエンドポイントテレメトリによるトラブルシューティングの強化

この機能により、Citrix Directorで詳細なエンドポイントのテレメトリデータを直接分析できるため、管理者がCitrixセッションの問題をトラブルシューティングして解決する能力が大幅に向上します。

前提条件

  • HTML5向けCitrix Workspaceアプリ2411以降
  • VDAバージョン2411以降
  • Citrix Director
トラブルシューティング