翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# デバッグ用の WorkSpaces サポートログバンドルの収集
<a name="collecting-a-workspaces-support-log-bundle-for-debugging"></a>

 WorkSpaces 問題をトラブルシューティングする場合は、影響を受けた WorkSpace と WorkSpaces クライアントがインストールされているホストからログバンドルを収集する必要があります。ログには 2 つの基本的なカテゴリがあります。
+  **サーバー側のログ：** WorkSpace はこのシナリオではサーバーであるため、これらは WorkSpace それ自体に格納されているログです。
+  **クライアント側のログ: **エンドユーザーが への接続に使用しているデバイスのログ WorkSpace。
+  Windows クライアントと macOS クライアントのみがローカルにログを書き込みます。
+  ゼロクライアントと iOS クライアントはログを記録しません。
+  Android ログはローカルストレージで暗号化され、 WorkSpaces クライアントエンジニアリングチームに自動的にアップロードされます。Android デバイスのログを確認できるのは、そのチームのみです。

## WSP サーバー側のログ
<a name="wsp-server-side-logs"></a>

すべての WSP コンポーネントは、ログファイルを 2 つのフォルダのいずれかに書き込みます。
+ **プライマリロケーション：** `C:\ProgramData\Amazon\WSP\`および `C:\ProgramData\NICE\dcv\log\`
+ **アーカイブの場所：** `C:\ProgramData\Amazon\WSP\TRANSMITTED\`

### Windows でのログファイルの詳細度の変更
<a name="changing-log-file-verbosity-windows"></a>

 ログの詳細レベル[グループポリシー設定 を設定することで、WSP Windows のログファイルの詳細レベル](https://docs.aws.amazon.com/workspaces/latest/adminguide/group_policy.html#log_verbosity)を WorkSpaces **大規模に**設定できます。

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

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

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

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

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

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

1.  新しい `h_log_verbosity_options` **DWORD** をクリックし、必要な詳細レベルに応じて、**値を**次のいずれかの数値に変更します。
   +  0 — エラー 
   +  1 — 警告 
   +  2 — 情報 
   +  3 — デバッグ 

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

1.  を再起動します WorkSpace。

## PCoIP サーバー側のログ
<a name="pcoip-server-side-logs"></a>

 すべての 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`

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

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

 参考までに、これらはこの DWORD で定義できるログしきい値です。
+  0 — (CRITICAL) 
+  1 — (エラー） 
+  2 — (INFO) 
+  3 — (デバッグ） 

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

## WebAccess サーバー側のログ
<a name="webaccess-server-side-logs"></a>

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\`。

## クライアント側のログ
<a name="client-side-logs"></a>

 これらのログはユーザーが接続する 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 クライアントの[高度なログ記録を有効にする](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-troubleshooting.html#advanced-logging)必要があります。

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

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

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

## Windows 用のサーバー側のログバンドルの自動収集
<a name="automated-server-side-log-bundle-collection-for-windows"></a>

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

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

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

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

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

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

    このスクリプトは、次のフォルダを含む zip ファイルを作成します。
   +  **C** — Skylight、EC2Config ProgramData、Teradici、イベントビューワー、および Windows ログ (Panther など) に関連するプログラムファイル、プログラムファイル (x86)、および Windows からのファイルが含まれます。
   +  **CliXML** — インタラクティブフィルタリング`Import-CliXML`に を使用して Powershell にインポートできる XML ファイルが含まれています。「[Import-Clixml](https://msdn.microsoft.com/en-us/powershell/reference/5.1/microsoft.powershell.utility/import-clixml)」を参照してください。
   +  **Config** — 実行される各チェックの詳細ログ 
   +  **ScriptLogs** - スクリプトの実行に関するログを記録します (調査には関係ありませんが、スクリプトの動作をデバッグするのに役立ちます）。
   +  **tmp** — 一時フォルダ (空である必要があります）。
   +  **トレース** — ログ収集中にパケットキャプチャが実行されます。