Citrix Workspace™ アプリ for ChromeOS

トラブルシューティング

April 20, 2026

寄稿者:

C C

ログの収集方法

ChromeOS向けCitrix Workspaceアプリは、ユーザーデバイスによって生成されるログにタイムスタンプを提供します。Citrix Workspaceアプリは、進行中の仮想デスクトップおよびアプリセッションのログ収集をサポートしています。

エンドユーザーとして、トラブルシューティングを支援するためにログを収集できます。ログは、ユーザーデバイスとマシンの両方で生成できます。ログはデスクトップとアプリケーション用です。

以前は、進行中のセッション中にログの開始を選択した後に起動されたセッションのログのみを収集できました。現在は、ログの停止を選択するまで、進行中のセッションおよびそれ以降のセッションのログが収集されます。

ユーザーデバイスでのログ記録

ログ記録を有効にするには：

ユーザーデバイスでCitrix Workspaceアプリを起動し、ログインページに移動します。
右下隅にある設定（歯車）アイコンをクリックします。
設定ダイアログで、ログ記録 > ログの開始を選択します。

収集されたログファイルの詳細が設定ダイアログに表示されます。
ユーザーデバイスでのログ収集を終了するには、ログの停止を選択します。

クライアントログ

クライアントログを収集するには：

Citrix Workspaceアプリのサインイン画面の右下にある設定（歯車）アイコンをクリックします。
ログ記録 > ログの開始をクリックして、ログ収集を有効にします。
ログの開始フィールドがログの停止に変わります。この変更は、ログの収集が有効になっていることを示します。

アカウントダイアログボックスを閉じます。

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

問題が再現されたら、セッションを閉じます。
設定を再度クリックして、アカウントダイアログボックスを開きます。
ログ記録タブを選択します。
ログ記録ダイアログボックスに、キャプチャされたログファイルのリストが表示されます。
いずれかのログファイルの上にマウスを移動します。右側に小さな矢印が表示されます。
矢印をクリックして、いくつかのログファイルをダウンロードして保存します。
すべてのログをダウンロードをクリックし、管理者またはCitrix®サポートエンジニアと共有します。
ログの停止をクリックします。

注：

キオスクモードでは、ファイルをUSBリムーバブルデバイスに保存できます。

拡張ログ収集

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

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

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

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

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

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

コンソールログ

コンソールログを収集するには：

1. Citrix WorkspaceアプリのGoogle Chromeブラウザーで、chrome://inspect/#appsページを開きます。

アプリタブで、Citrix Workspace関連のすべてのウィンドウ（SessionWindow.html、Main.html、およびその子ノード）に対してinspectをクリックします。
開いている各開発者ツールウィンドウで、コンソールをクリックします。次に、右クリックして名前を付けて保存オプションを選択し、ログ全体を保存します。

USBリダイレクトログ
USBリダイレクトログを収集するには：

ChromeOSのWeb.configの使用の手順に従い、以下のようにUSBのmoreLogsを有効にします。

StoreFrontのweb.configファイルにあるchromeAppPreferencesにmoreLogs構成値を追加します。
chromeAppPreferences ='{"moreLogs":{"usb":true}}'

次に、Google Chromeブラウザで新しいタブを開き、chrome://device-logと入力してログを共有します。

ファイル転送ログ

ファイル転送ログは、クライアントとサーバーの両方から取得できます。

クライアントからファイル転送ログを取得するには：

ブラウザを起動します。
ログの記録を開始するには、次のURLにアクセスします。 <storefronturl>/clients/html5client/src/viewlog.html ここで、<storefronturl> は、ストアが構成されているStoreFrontサーバーのFQDNまたはIPアドレスです。

ファイル転送の詳細については、「HTML5およびChromeのファイル転送について」を参照してください。

Microsoft Teams最適化ログ

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

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

Microsoft Teamsアプリケーションを起動し、いずれかのユーザーと通話を開始します。
通話が確立されたら、Microsoft Teamsウィンドウを最大化します。
セッション内でオンスクリーンキーボードを開き、Ctrl + Alt + Shift + 1キーをクリックします。ダウンロードフォルダーでログファイルを表示できるようになります。
MSTeams Diagnostics Log <date><time>_vdi partner.txtファイルを開き、type_scriptの下でshimバージョンを検索します。 shimバージョンを1.8.0.12と比較します。
（オプション）shimバージョンが1.8.0.12でない場合は、管理者に連絡して最新バージョンにアップグレードしてください。

キオスクモードでのクライアントログ

キオスクモードでログを収集するには：

リムーバブルUSBデバイスをChromebookに接続します。
ログファイルをダウンロードします。
ログファイルを接続されたUSBデバイスに保存します。

ログファイルはUSBデバイスに転送されます。

ショートカット

仮想デスクトップ内の最適化されたMicrosoft Teamsでは、キーボードショートカットのCtrl+ Alt + Shift +1が機能しない場合があります。回避策として、オンスクリーンキーボードを開いてショートカットを使用してください。[RFHTMCRM-5441]

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

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

前提条件

Citrix Workspaceアプリ for ChromeOS 2411以降
VDAバージョン2411以降
Citrix Director

セッション起動診断

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

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

Always On Tracing (AOT)

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

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

利点

AOTは、以下の方法で顧客に大きな価値を提供します。

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

ユースケース

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

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

AOTログの集中AOTログサーバーへのアップロード

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

注：

Citrix Workspaceアプリ for ChromeOS 2511リリースでは、AOTログはパスにゲートウェイがないオンプレミス設定でのみキャプチャされます。

Citrix Workspaceアプリ for ChromeOS 2603では、集中ログサーバーへのAOTログのアップロードは、ゲートウェイのないオンプレミス設定と、パスにゲートウェイがあるオンプレミス設定の両方をサポートします。

構成

Citrix Workspaceアプリ for ChromeOS 2603以降、次の構成を追加することでAOT機能を無効にできます。管理対象デバイスおよびユーザーの場合、管理者はGoogle管理ポリシーを使用してAOTを次のように無効にできます。

Google 管理ポリシーにサインインします。
デバイス管理 > Chrome 管理 > ユーザー設定 に移動します。
注:

この構成は、以下にも適用できます。
- デバイス > Chrome > アプリと拡張機能 > ユーザーとブラウザ > 拡張機能を検索 > 拡張機能のポリシー。
- デバイス > Chrome > アプリと拡張機能 > キオスク > 拡張機能を検索 > 拡張機能のポリシー。
- デバイス > Chrome > アプリと拡張機能 > 管理対象ゲストセッション > 拡張機能を検索 > 拡張機能のポリシー。
engine_settings キーの下にある policy.txt ファイルに次の文字列を追加します。

aot オブジェクトの下で "enabled": false を設定していることを確認してください。以下は JSON データの例です。
```
{
"settings": {
"Value": {
"settings_version": "1.0",
"engine_settings": {
    "aot": {
        "enabled": false
            }
        }
    }
    }
}

```

前提条件

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

Citrix Virtual Apps and Desktops™ バージョン 2507 CU1 以降
Citrix Virtual Apps and Desktops™ バージョン 2511 以降

構成方法

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

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

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

CORS を有効にするには:

ログサーバーが実行中の場合は、次のコマンドを使用して停止します。

   docker stop logserver
   <!--NeedCopy-->

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 を区切るにはセミコロン (;) を使用します。

StartLogServer.bat (または Linux の StartLogServer.sh) コマンドを使用してログサーバーを再起動します。

Azure AD 資格情報設定による VDA の Entra ID シングルサインオンサポートのトラブルシューティングログ

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

ログを収集するには:

基本的な Citrix Workspace アプリのログを収集します。詳細については、「ログの収集方法」を参照してください。
MSAL トークンフェッチステータスのネットワークトレースを収集します。

i. Chrome ブラウザを開き、chrome://net-export/ に移動します。 ii. 次のスクリーンショットに示すように、[ディスクへのログ記録を開始] を選択し、[生バイトを含める (Cookie と資格情報を含む)] オプションを選択します。ファイルの場所を選択します。

iii. Citrix Workspace app for ChromeOS セッションを開始して問題を再現し、トレースを収集します。chrome://net-export/ で [ログ記録を停止] を選択します。
すべてのモジュールと起動トレースについて、VDA から Citrix Diagnostic Facility (CDF) トレースを収集します。Citrix Workspace アプリからの機能ネゴシエーションが成功した場合でも SSO が失敗する可能性があるため、システム起動時に CDF トレースを収集する手順に従ってください。

既知の制限事項

Citrix Workspace app for ChromeOS は、インメモリ ICA サポートがないため、ハイブリッド起動の SSO をサポートしていません。
セッション起動に 30 秒以上かかる場合、AAD SSO ログインが失敗し、ユーザーに資格情報の入力を求めるプロンプトが表示されることがあります。

よくある質問

新しく追加された機能や機能強化に関する最新情報

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

テクニカルプレビュー機能へのアクセス方法

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

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

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

Chrome Web Store から Citrix Workspace app for ChromeOS をインストールする方法

エンドユーザーは、Chrome Web Store から Citrix Workspace app for ChromeOS をインストールできます。詳細については、製品ドキュメントの「Chrome Web Store からのインストール」を参照してください。

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

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

USB リダイレクトの構成方法

Citrix Workspace app for ChromeOS は、幅広い USB 周辺機器をサポートしています。この追加機能により、Google ポリシーを作成してデバイスの PID/VID を識別し、Citrix Workspace アプリでの使用を有効にできます。このサポートは新しい USB デバイスにも拡張されます。この機能を構成するには、製品ドキュメントの「USB 構成」を参照してください。

このコンテンツの正式なバージョンは英語で提供されています。Cloud Software Groupドキュメントのコンテンツの一部は、お客様の利便性のみを目的として機械翻訳されています。Cloud Software Groupは機械翻訳されたコンテンツを管理していないため、誤り、不正確な情報、不適切な用語が含まれる場合があります。英語の原文から他言語への翻訳について、精度、信頼性、適合性、正確性、またはお使いのCloud Software Group製品またはサービスと機械翻訳されたコンテンツとの整合性に関する保証、該当するライセンス契約書またはサービス利用規約、あるいはCloud Software Groupとのその他すべての契約に基づき提供される保証、および製品またはサービスのドキュメントとの一致に関する保証は、明示的か黙示的かを問わず、かかるドキュメントの機械翻訳された範囲には適用されないものとします。機械翻訳されたコンテンツの使用に起因する損害または問題について、Cloud Software Groupは責任を負わないものとします。

この情報は役に立ちましたか?

トラブルシューティング

April 20, 2026

寄稿者:

C C

April 20, 2026

寄稿者:

C C

この記事の概要

ログの収集方法
クライアントログ
コンソールログ
USBリダイレクトログ
ファイル転送ログ
Microsoft Teams最適化ログ
キオスクモードでのクライアントログ
ショートカット
Citrix Directorでのエンドポイントテレメトリの表示
セッション起動診断
Always On Tracing (AOT)
Azure AD 資格情報設定による VDA の Entra ID シングルサインオンサポートのトラブルシューティングログ
よくある質問

この情報は役に立ちましたか?

トラブルシューティング

ログの収集方法

ユーザーデバイスでのログ記録

クライアントログ

拡張ログ収集

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

コンソールログ

USBリダイレクトログ

ファイル転送ログ

Microsoft Teams最適化ログ

キオスクモードでのクライアントログ

ショートカット

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

前提条件

セッション起動診断

Always On Tracing (AOT)

利点

ユースケース

AOTログの集中AOTログサーバーへのアップロード

構成

前提条件

構成方法

Azure AD 資格情報設定による VDA の Entra ID シングルサインオンサポートのトラブルシューティングログ

既知の制限事項

よくある質問

新しく追加された機能や機能強化に関する最新情報

テクニカルプレビュー機能へのアクセス方法

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

Chrome Web Store から Citrix Workspace app for ChromeOS をインストールする方法

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

USB リダイレクトの構成方法

この記事の概要