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

# CloudWatch メトリクスを使用した WorkSpaces のモニタリング
<a name="cloudwatch-metrics"></a>

WorkSpaces と Amazon CloudWatch が統合され、パフォーマンスメトリクスを収集して分析できるようになりました。これらのメトリクスは、CloudWatch コンソールまたは CloudWatch コマンドラインインターフェイスを使用して、あるいはプログラムによって CloudWatch API を使用してモニタリングできます。CloudWatch では、メトリックスの指定したしきい値に到達したときのアラームを設定することもできます。

CloudWatchとアラームの使用の詳細については、[Amazon CloudWatch ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/)を参照してください。

**前提条件**  
CloudWatch メトリクスを取得するには、`us-east-1` リージョンにある `AMAZON` サブセットのポート 443 へのアクセスを有効にします。詳細については、「」を参照してください[WorkSpaces Personal の IP アドレスとポートの要件](workspaces-port-requirements.md)

**Topics**
+ [WorkSpaces メトリクス](#wsp-metrics)
+ [WorkSpaces メトリックスのディメンション](#wsp-metric-dimensions)
+ [モニタリングの例](#monitoring_example)

## WorkSpaces メトリクス
<a name="wsp-metrics"></a>

`AWS/WorkSpaces` 名前空間には、次のメトリクスが含まれます。


| メトリクス | 説明 | ディメンション | 統計 | 単位 | 
| --- | --- | --- | --- | --- | 
| `Available`1 | 正常な状態を返した WorkSpaces の数。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント | 
| `Unhealthy`1 | 正常でない状態を返した WorkSpaces の数。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント | 
| `ConnectionAttempt`2 | 接続試行の数。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント | 
| `ConnectionSuccess`2 | 成功した接続の数。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント | 
| `ConnectionFailure`2 | 失敗した接続の数。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント | 
| `SessionLaunchTime`2,6 | WorkSpaces セッションを開始するためにかかる時間。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | 秒 (時間) | 
| `InSessionLatency`2,6 | WorkSpaces クライアントと WorkSpaces 間のラウンドトリップ時間。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | ミリ秒 (時間) | 
| `SessionDisconnect`2,6 | ユーザーが開始して失敗した接続を含む、閉じられた接続の数。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント | 
| `UserConnected`3 | ユーザーが接続されている WorkSpaces の数。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント | 
| `Stopped` | 停止中の WorkSpaces の数。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント | 
| `Maintenance`4 | メンテナンス中の WorkSpaces の数。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント | 
| `TrustedDeviceValidationAttempt`5,6 | デバイス認証シグニチャ検証の試行回数。 | `DirectoryId` | Average、Sum、Maximum、Minimum、Data Samples | カウント | 
| `TrustedDeviceValidationSuccess`5,6 | 成功したデバイス認証シグニチャ検証の数。 | `DirectoryId` | Average、Sum、Maximum、Minimum、Data Samples | カウント | 
| `TrustedDeviceValidationFailure`5,6 | 失敗したデバイス認証シグニチャ検証の数。 | `DirectoryId` | Average、Sum、Maximum、Minimum、Data Samples | カウント | 
| `TrustedDeviceCertificateDaysBeforeExpiration`6 | ディレクトリに関連付けられたルート証明書の有効期限が切れるまでの日数。 | `CertificateId` | Average、Sum、Maximum、Minimum、Data Samples | カウント | 
| `CPUUsage` | 使用された CPU リソースの割合。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Maximum、Minimum | 割合 (%) | 
| `MemoryUsage` | マシンのメモリの使用率。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Maximum、Minimum | 割合 (%) | 
| `RootVolumeDiskUsage` | ルートディスクボリュームの使用率。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Maximum、Minimum | 割合 (%) | 
| `UserVolumeDiskUsage` | ユーザーディスクボリュームの使用率。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Maximum、Minimum | 割合 (%) | 
| `UDPPacketLossRate`7 | クライアントとゲートウェイの間でドロップしたパケットの割合。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Maximum、Minimum、Data Samples | 割合 (%) | 
| `UpTime` | WorkSpace の最後の再起動からの時間。 | `DirectoryId`<br />`WorkspaceId`<br />`RunningMode`<br />`Protocol`<br />`ComputeType`<br />`BundleId`<br />`UserName`<br />`ComputerName` | Average、Maximum、Minimum、Data Samples | [秒] | 

1 WorkSpacesは定期的にステータスリクエストを WorkSpaces に送信します。WorkSpaces は、これらのリクエストに応答すると `Available` とマークされ、リクエストに応答できないと `Unhealthy` とマークされます。これらのメトリクスは WorkSpaces レベルの粒度で利用でき、組織のすべての WorkSpaces で集計されます。

2 WorkSpaces は、各 WorkSpaces に対して行われた接続のメトリクスを記録します。これらのメトリクスは、ユーザーが WorkSpaces クライアント経由で正常に認証され、クライアントがセッションを開始した後で出力されます。メトリクスは WorkSpaces レベルの粒度で利用でき、ディレクトリのすべての WorkSpaces で集計されます。

 3WorkSpaces は定期的に接続ステータスのリクエストを WorkSpaces に送信します。ユーザーは、能動的にセッションを使用している場合、接続済みとしてレポートされます。このメトリクスは WorkSpaces レベルの粒度で利用でき、組織のすべての WorkSpaces で集計されます。

4 このメトリクスは、AutoStop 実行モードで設定された WorkSpaces に適用されます。WorkSpaces のメンテナンスを有効にしている場合、このメトリクスは、現在メンテナンス中の WorkSpaces の数を記録します。このメトリクスは、WorkSpaces レベルの粒度で利用でき、WorkSpaces がメンテナンスに入った時期と削除された時期を示します。

5 ディレクトリに対して信頼されたデバイスの機能が有効になっている場合、Amazon WorkSpaces は証明書ベースの認証を使用して、デバイスが信頼されているかどうかを判断します。ユーザーが自分の WorkSpaces にアクセスしようとすると、これらのメトリクスが出力され、信頼されたデバイスの認証が成功したか失敗したかが示されます。これらのメトリクスは、Amazon WorkSpaces の Windows と MacOS クライアントアプリケーションでのみ、ディレクトリレベルの粒度で使用できます。

6 WorkSpaces Web Access ではご利用いただけません。

7 このメトリクスは、パケットの平均損失を測定します。
+ **PCoIP**: クライアントからゲートウェイへの UDP パケットの平均損失を測定します。
**注記**  
これはゲートウェイで測定されます。
+ **DCV**: ゲートウェイからクライアントへの UDP パケットの損失を測定します。
**注記**  
これはゲートウェイで測定されます。

## WorkSpaces メトリックスのディメンション
<a name="wsp-metric-dimensions"></a>

メトリクスデータをフィルタリングするために以下のディメンションを使用します。


| ディメンション | 説明 | 
| --- | --- | 
| `DirectoryId` | 指定したディレクトリの WorkSpaces に、メトリクスデータをフィルタリングします。ディレクトリ ID の形式は `d-XXXXXXXXXX` です。 | 
| `WorkspaceId` | 指定した WorkSpaces に対してメトリクスデータをフィルタリングします。WorkSpaces ID の形式は `ws-XXXXXXXXXX` です。 | 
| `CertificateId` | メトリクスデータをフィルタリングして、ディレクトリに関連付けられている指定されたルート証明書にします。証明書 ID の形式は `wsc-XXXXXXXXX` です。 | 
| `RunningMode` | メトリクスデータを WorkSpaces の実行モード別にフィルタリングします。実行モードの形式は AutoStop または AlwaysOn です。 | 
| `BundleId` | メトリクスデータを WorkSpaces のプロトコル別にフィルタリングします。バンドルの形式は `wsb-XXXXXXXXXX` です。 | 
| `ComputeType` | メトリクスデータを WorkSpaces のコンピューティングタイプ別にフィルタリングします。 | 
| `Protocol` | メトリクスデータを WorkSpaces のプロトコルタイプ別にフィルタリングします。 | 
| `UserName` | メトリクスデータを WorkSpaces のユーザー名別にフィルタリングします。 `UserName` に次のような非 ASCII 文字を使うことはできません。  アクセント文字: é、à、ö、ñ など。 非ラテン文字 記号: ©️、®️、€、£、μ、¥ など。   | 
| `ComputerName` | 指定した WorkSpaces に対してメトリクスデータをフィルタリングします。[WorkSpaces コンピュータ名]( https://docs.aws.amazon.com/workspaces/latest/adminguide/wsp-directory-identify-computer.html)の各種形式をご確認ください。 | 

## モニタリングの例
<a name="monitoring_example"></a>

次の例では、AWS CLI を使用して CloudWatch アラームに応答し、ディレクトリ内で接続障害を起こした WorkSpaces を特定する方法を示します。

**CloudWatch アラームに応答するには**

1. [describe-alarms](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/describe-alarms.html) コマンドを使用して、アラームの対象になっているディレクトリを特定します。

   ```
   aws cloudwatch describe-alarms --state-value "ALARM"
   
   {
     "MetricAlarms": [
       {
         ...
         "Dimensions": [
           {
             "Name": "DirectoryId",
             "Value": "{{directory_id}}"
           }
         ],
         ...
       }
     ]
   }
   ```

1. [describe-WorkSpaces](https://docs.aws.amazon.com/cli/latest/reference/workspaces/describe-workspaces.html) コマンドを使用して、指定したディレクトリの WorkSpaces のリストを取得します。

   ```
   aws workspaces describe-workspaces --directory-id {{directory_id}}
   
   {
     "Workspaces": [
       {
         ...
         "WorkspaceId": "{{workspace1_id}}",
         ...
       },
       {
         ...
         "WorkspaceId": "{{workspace2_id}}",
         ...
       },
       {
         ...
         "WorkspaceId": "{{workspace3_id}}",
         ...
       }
     ]
   }
   ```

1. [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html) コマンドを使用して、ディレクトリ内の各 WorkSpaces の CloudWatch メトリクスを取得します。

   ```
   aws cloudwatch get-metric-statistics \
   --namespace AWS/WorkSpaces \
   --metric-name ConnectionFailure \
   --start-time 2015-04-27T00:00:00Z \
   --end-time 2015-04-28T00:00:00Z \
   --period 3600 \
   --statistics Sum \
   --dimensions "Name=WorkspaceId,Value={{workspace_id}}"
   
   {
     "Datapoints" : [
       {
         "Timestamp": "2015-04-27T00:18:00Z",
         "Sum": 1.0,
         "Unit": "Count"
       },
       {
         "Timestamp": "2014-04-27T01:18:00Z",
         "Sum": 0.0,
         "Unit": "Count"
       }
     ],
     "Label" : "ConnectionFailure"
   }
   ```