製品ドキュメント
HTML5向けCitrix Workspaceアプリ
PDFを表示

トラブルシューティング

July 14, 2026
寄稿者: 
C C

HTML5のログ

Citrix Workspaceアプリ for HTML5は、ユーザーデバイスによって生成されたログにタイムスタンプを提供します。

注：

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

ログページでは、ユーザーは次のことができます。

  • ログ記録を有効にする： ログ記録を有効にして、HTML5ログを表示します。
  • ログ記録を無効にする： ログ記録を無効にして、セッションでのログ記録を停止します。
  • ログを表示する： セッション用に生成されたログを表示します。
  • ログをクリアする： セッションで生成されたログファイルを削除します。
  • ログファイルをダウンロードする： ログファイルを任意の場所にダウンロードします。

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

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

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

注：

現在のセッションと過去5セッションまでのログを収集できます。

ログの収集方法

Citrix Workspaceアプリ for HTML5クライアントログを収集するには、次の手順を実行します。

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

  2. 次のように、[ログファイル]ページにアクセスします。
    • For Citrix Workspace app versions 1908 and later, open a new tab and navigate to siteurl/Clients/HTML5Client/src/SessionWindow.html#engineType=log, where siteurl is the URL of the Workspace for Web site, for example, https://server.domain/Citrix/StoreWeb.
    • For Citrix Workspace app versions 1907 and earlier, open a new tab and navigate to siteurl/Clients/HTML5Client/src/ViewLog.html, where siteurl is the URL of the Citrix Workspace for Web site, for example, https://server.domain/Citrix/StoreWeb.

  3. [ログファイル]ページで、[ログの開始]をクリックします。

    ログの開始

    ログは次回のセッション起動時に有効になり、現在アクティブなセッション（存在する場合）では有効になりません。

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

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

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

    ログファイル

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

    「ログファイル」(/ja-jp/citrix-workspace-app-for-html5/media/logfiles_arrow.png)

注:

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

「ロギングツールバー」(/ja-jp/citrix-workspace-app-for-html5/media/loggingtoolbar.png)

コンソールログを収集する方法

Citrix Workspaceアプリ for HTML5のコンソールログを収集するには、次の手順を実行します。

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

    「開発者ツール」(/ja-jp/citrix-workspace-app-for-html5/media/developertool.png)

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

  3. 右クリックして [名前を付けて保存] オプションを選択し、すべてのログを保存します。

    「コンソール」(/ja-jp/citrix-workspace-app-for-html5/media/console.png)

USBリダイレクトログを収集する方法

ロギングを有効にし、USBリダイレクト関連の問題のログを収集するには、次の手順を実行します。

ログを有効にする

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

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

ログを収集する

ログを収集するには、「ログの収集方法」(/ja-jp/citrix-workspace-app-for-html5/troubleshoot.html#how-to-collect-logs)を参照してください。

デバイスログ

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

デバイスログ

Microsoft Teams最適化ログの収集方法

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

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

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

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

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

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

  4. Open the MSTeams_Diagnostics Log <date><time>.txt file and search for the shim version under type_script. For example, “version”:{“type_script”:”1.10.0.0”}.

拡張ログ収集

バージョン2411以降、ユーザーはCitrix Workspace™アプリのログをzipファイルでダウンロードできるようになり、ログの取得と分析が簡素化され、トラブルシューティングの改善とユーザーエクスペリエンスの向上が図られます。

この機能の利点は次のとおりです。

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

常時オン追跡 (AOT)

Citrix Workspaceアプリ for HTML5は、Citrixの最新の診断フレームワークであるAlways On Tracing (AOT) をサポートするようになりました。AOTは、Citrix Virtual Apps and Desktops環境全体で関連するログデータを継続的にキャプチャします。この機能により、ユーザーセッションとシステムイベントのログデータが自動的にキャプチャされるため、問題を再現する必要がなくなり、IT管理者とCitrixサポートチームのトラブルシューティングが簡素化されます。

AOTは、エンジニアリングレベルの専門知識がなくてもログに簡単にアクセスして読み取れるようにすることで、セルフサービス診断を可能にし、Citrixサポートへの依存を減らし、平均解決時間を改善します。

利点

AOTは、以下の点でお客様に大きな価値を提供します。

  • 手動での介入なしに、ユーザーセッションとシステムイベントのログデータを自動的にキャプチャする
  • 通常の操作中にログが継続的に収集されるため、問題を再現する必要がなくなる
  • エンジニアリングレベルの専門知識を必要とせずに、ログに簡単にアクセスして読み取れるようにする
  • Citrixサポートへの依存を減らすために、セルフサービス診断を可能にする
  • トラブルシューティングシナリオの平均解決時間を改善する

ユースケース

AOTは、次のシナリオで全体的なエクスペリエンスに適合します。

  • プロアクティブな監視: ユーザーセッションとシステムイベントを継続的に監視し、ユーザーに影響を与える前に潜在的な問題を特定します
  • 迅速なトラブルシューティング: 問題が発生したときに、ログの再現を待つことなく、包括的なログデータにすぐにアクセスします
  • セルフサービスサポート: アクセス可能なログデータを使用して、IT管理者が一般的な問題を独自に診断および解決できるようにします

AOTログを集中AOTログサーバーにアップロードする

AOTログサーバーは、さまざまなCitrix®コンポーネントからAlways On Tracing（AOT）ログを収集および保存するための一元化された宛先として機能します。Dockerテクノロジーを使用してコンテナ化されており、Linuxに展開するのが望ましいですが、Docker Desktopを介してWindows環境もサポートしています。

注：

Citrix Workspaceアプリ for HTML5 2603は、ゲートウェイを含むオンプレミス設定の集中ログサーバーへのAOTログアップロードをサポートするようになりました。

Citrix Workspaceアプリ for HTML5 2603以降、次の構成を追加することでAOT機能を無効にできます。

{
  "aot": {
    "enabled": false
  }
}
<!--NeedCopy-->

前提条件

この機能は、次の方法でセッションを開いた場合にのみ利用できます。

  • Citrix Virtual Apps and Desktops™ version 2507 CU1 or later

  • シトリックス バーチャル アプリケーションズ アンド デスクトップス™ バージョン 2511 以降

制限事項

Mozilla FirefoxおよびApple Safariブラウザを使用している場合、ログサーバーがHTTPを使用しているとAOTログをアップロードできません。

構成方法

構成するには、まずログサーバーをインストールして構成する必要があります。詳細なインストールおよび構成手順については、「ログサーバーのインストールと構成」を参照してください。

ログサーバーをインストールすると、システムは同じ場所にStartLogServerスクリプトを生成します。ファイル名はWindowsではStartLogServer.bat、LinuxではStartLogServer.shです。

Citrix Workspaceアプリ for HTML5とログサーバー間の通信を有効にするには、ログサーバーでクロスオリジンリソース共有 (CORS) を有効にして、StoreFront FQDN URLを受け入れるようにログサーバーを構成する必要があります。

CORSを有効にするには：

  1. ログサーバーが実行中の場合は、次のコマンドを使用して停止します。
   docker stop logserver
   <!--NeedCopy-->
  1. CORS_ORIGINSパラメーターを編集して、次の環境引数をStartLogServer.bat（またはLinuxではStartLogServer.sh）に追加します。
   -e CORS_ORIGINS=""
   <!--NeedCopy-->

単一URLの例：

   -e CORS_ORIGINS="https://xyz.bvt.local;"
   <!--NeedCopy-->

複数URLの例：

   -e CORS_ORIGINS="url1;url2;url3"
   <!--NeedCopy-->

複数のURLを区切るにはセミコロン (;) を使用します。

  1. StartLogServer.bat（またはLinuxではStartLogServer.sh）を使用してログサーバーを再起動します。

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

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

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

詳細については、ログの収集方法を参照してください。

Citrix Directorでエンドポイントテレメトリを表示

この機能により、管理者はCitrix Directorでエンドポイントテレメトリデータを直接表示する能力が向上します。

前提条件

  • シトリックス ワークスペース アプリ for HTML5 2411 以降
  • VDAバージョン2411以降
  • シトリックス ディレクター

セッション起動診断

バージョン2502以降、セッション障害に対するサポートプロセスを改善しました。ヘルプデスク管理者は、障害パスに関する包括的な洞察を得られるようになり、セッション障害に関連するサポートケースの数を効果的にトリアージし、大幅に削減できるようになります。

詳細については、Citrix Monitorのドキュメントのセッション起動診断を参照してください。

エラーダイアログでのCitrix Workspaceアプリのログのダウンロードを無効にする

バージョン2505以降、管理者はCitrix Workspace app for HTML5（クラウドおよびオンプレミス）のアプリセッションとデスクトップセッションの両方で、すべてのエラーダイアログのログのダウンロードボタンを非表示にできます。

注：

この機能はデフォルトで無効になっています。つまり、ユーザーはエラーダイアログからログをダウンロードするオプションがあります。

詳細については、エラーダイアログでのCitrix Workspaceアプリのログのダウンロードを無効にするを参照してください。

Azure AD資格情報設定を使用したVDAのEntra IDシングルサインオンサポートのトラブルシューティングのためのログ

この記事では、SSOが失敗し、セッション起動後にユーザーが予期しない資格情報プロンプトを受け取った場合に収集できるログについて説明します。

ログを収集するには:

  1. 基本的なCitrix Workspaceアプリのログを収集します。詳細については、「ログの収集方法」を参照してください。

  2. Microsoft Authentication Library (MSAL)トークン取得ステータスのネットワークトレースを収集します。

    i. エンドポイントにCharlesまたはFiddlerをインストールします。 ii. 問題が発生しているブラウザでMicrosoft Entra IDストアにログインします。 iii. CharlesまたはFiddlerアプリを起動します。 iv. Citrix Workspaceアプリ for HTML5セッションを開始します。問題を再現した後、File > Save > All sessions をクリックしてFiddlerトレースをエクスポートします。これにより、Citrixと共有するトレースがダウンロードされます。詳細については、次のスクリーンショットを参照してください。

    ディスクへのログ記録を開始

  3. すべてのモジュールと起動トレースについて、VDAからCitrix Diagnostic Facility (CDF)トレースを収集します。Citrix Workspaceアプリからの機能ネゴシエーションが成功した場合でもSSOが失敗する可能性があるため、システム起動時にCDFトレースを収集する手順に従ってください。

よくある質問

新しく追加された機能や機能強化に関する最新情報はどこで確認できますか

Citrix Workspaceアプリ for HTML5に関する最新情報は、製品ドキュメントで確認できます。

テクニカルプレビュー機能にアクセスする方法

テクニカルプレビュー中の機能については、「テクニカルプレビューの機能」を参照してください。

EARに関するフィードバックを提供する方法

EARバージョンに関するフィードバックを提供するには、https://forms.gle/ef3eFFKBk7gvTi1b6をクリックしてください。

Citrix Workspaceアプリセッション内のツールバーをカスタマイズする方法

管理者は、エンドユーザーに表示されるオプションを選択して、ツールバーをカスタマイズできます。管理者は、Global App Configurationサービスを使用してカスタマイズできます。詳細については、製品ドキュメントのツールバーのカスタマイズを参照してください。

Citrix Workspaceアプリ for HTML5でSSL対応VDAの暗号スイートを構成する方法

暗号スイートを構成するには、Citrix Workspaceアプリ for HTML5ドキュメントの暗号スイートの記事を参照してください。

トラブルシューティング
July 14, 2026
寄稿者: 
C C
July 14, 2026
寄稿者: 
C C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.