デバッグ用の WorkSpaces サポートログバンドルの収集

WorkSpaces 問題をトラブルシューティングする場合は、影響を受けた WorkSpace と WorkSpaces クライアントがインストールされているホストからログバンドルを収集する必要があります。ログには 2 つの基本的なカテゴリがあります。

• サーバー側のログ： WorkSpace はこのシナリオではサーバーであるため、これらは WorkSpace それ自体に格納されているログです。

• クライアント側のログ: エンドユーザーが への接続に使用しているデバイスのログ WorkSpace。

• Windows クライアントと macOS クライアントのみがローカルにログを書き込みます。

• ゼロクライアントと iOS クライアントはログを記録しません。

• Android ログはローカルストレージで暗号化され、 WorkSpaces クライアントエンジニアリングチームに自動的にアップロードされます。Android デバイスのログを確認できるのは、そのチームのみです。

WSP サーバー側のログ

すべての WSP コンポーネントは、ログファイルを 2 つのフォルダのいずれかに書き込みます。

• プライマリロケーション： C:\ProgramData\Amazon\WSP\および C:\ProgramData\NICE\dcv\log\

• アーカイブの場所： C:\ProgramData\Amazon\WSP\TRANSMITTED\

Windows でのログファイルの詳細度の変更

ログの詳細レベルグループポリシー設定 を設定することで、WSP Windows のログファイルの詳細レベルを WorkSpaces 大規模に設定できます。

個々の のログファイルの詳細度を変更するには WorkSpaces、Windows レジストリエディタを使用して h_log_verbosity_options キーを設定します。

1. 管理者として Windows レジストリエディタを開きます。

2. \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon に移動します。

3. WSP キーが存在しない場合は、右クリックして新規 > キーを選択し、 と名前を付けますWSP。

4. \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon\WSP に移動します。

5. h_log_verbosity_options 値が存在しない場合は、右クリックして新規 > DWORD を選択し、 と名前を付けますh_log_verbosity_options。

6. 新しい h_log_verbosity_options DWORD をクリックし、必要な詳細レベルに応じて、値を次のいずれかの数値に変更します。

   • 0 — エラー

   • 1 — 警告

   • 2 — 情報

   • 3 — デバッグ

7. [OK] を選択して Windows レジストリエディタを閉じます。

8. を再起動します WorkSpace。

PCoIP サーバー側のログ

すべての PCoIP コンポーネントは、ログファイルを 2 つのフォルダのいずれかに書き込みます。

• プライマリロケーション： C:\ProgramData\Teradici\PCoIPAgent\logs

• アーカイブの場所： C:\ProgramData\Teradici\logs

複雑な問題 AWS サポート で作業する場合、PCoIP Server エージェントを詳細なログ記録モードにする必要がある場合があります。これを有効にするには：

1. 次のレジストリキーを開きます。 HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Teradici\PCoIP\pcoip_admin_defaults

2. pcoip_admin_defaults キーで、次の 32 ビット DWORD を作成します。 pcoip.event_filter_mode

3. の値を3「」(12 月または 16 進数) pcoip.event_filter_modeに設定します。

参考までに、これらはこの DWORD で定義できるログしきい値です。

• 0 — (CRITICAL)

• 1 — (エラー）

• 2 — (INFO)

• 3 — (デバッグ）

pcoip_admin_default DWORD が存在しない場合、ログレベルは2デフォルトで になります。詳細なログが不要になったら、 の値を DWORD 2に復元することをお勧めします。これは、はるかに大きく、ディスク容量を不必要に消費するためです。

WebAccess サーバー側のログ

PCoIP および WSP (バージョン 1.0 以降) の場合 WorkSpaces、 WorkSpaces Web Access クライアントは STXHD サービスを使用します。 WorkSpaces Web Access のログは に保存されますC:\ProgramData\Amazon\Stxhd\Logs。

WSP (バージョン 2.0 以降) の場合 WorkSpaces、 WorkSpaces Web Access のログは に保存されますC:\ProgramData\Amazon\WSP\。

クライアント側のログ

これらのログはユーザーが接続する WorkSpaces クライアントから取得されるため、ログはエンドユーザーのコンピュータ上にあります。Windows と Mac のログファイルの場所は次のとおりです。

• Windows: "%LOCALAPPDATA%\Amazon Web Services\Amazon WorkSpaces\Logs"

• macOS ~/Library/"Application Support"/"Amazon Web Services"/"Amazon WorkSpaces"/logs：

• Linux: ~/.local/share/Amazon Web Services/Amazon WorkSpaces/logs

ユーザーが遭遇する可能性のある問題をトラブルシューティングするには、任意の Amazon WorkSpaces クライアントで使用できる高度なログ記録を有効にします。高度なログ記録は、無効化されるまで、後続のすべてのクライアントセッションで有効になります。

1. に接続する前に WorkSpace、エンドユーザーは WorkSpaces クライアントの高度なログ記録を有効にする必要があります。

2. エンドユーザーは、通常どおり接続し、 を使用して WorkSpace、問題を再現する必要があります。

3. 高度なログ記録では、診断情報とデバッグレベルの詳細 (詳細なパフォーマンスデータなど) を含むログファイルが生成されます。

この設定は、明示的にオフになるまで保持されます。ユーザーが冗長ログ記録に関する問題を正常に再現したら、大きなログファイルが生成されるため、この設定は無効にする必要があります。

Windows 用のサーバー側のログバンドルの自動収集

このGet-WorkSpaceLogs.ps1スクリプトは、 のサーバー側のログバンドルをすばやく収集するのに役立ちます AWS サポート。スクリプトは、サポートケースでリクエスト AWS サポート することで、 からリクエストできます。

1. WorkSpace クライアントまたはリモートデスクトッププロトコル (RDP) を使用して に接続します。

2. 管理コマンドプロンプトを起動します (管理者として実行）。

3. 次のコマンドを使用して、コマンドプロンプトからスクリプトを起動します。

   powershell.exe -NoLogo -ExecutionPolicy RemoteSigned -NoProfile -File "C:\Program Files\Amazon\WorkSpacesConfig\Scripts\Get-WorkSpaceLogs.ps1"
         

4. このスクリプトは、ユーザーのデスクトップにログバンドルを作成します。

   このスクリプトは、次のフォルダを含む zip ファイルを作成します。

   • C — Skylight、EC2Config ProgramData、Teradici、イベントビューワー、および Windows ログ (Panther など) に関連するプログラムファイル、プログラムファイル (x86)、および Windows からのファイルが含まれます。

   • CliXML — インタラクティブフィルタリングImport-CliXMLに を使用して Powershell にインポートできる XML ファイルが含まれています。「Import-Clixml」を参照してください。

   • Config — 実行される各チェックの詳細ログ

   • ScriptLogs - スクリプトの実行に関するログを記録します (調査には関係ありませんが、スクリプトの動作をデバッグするのに役立ちます）。

   • tmp — 一時フォルダ (空である必要があります）。

   • トレース — ログ収集中にパケットキャプチャが実行されます。