翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# CloudWatch メトリクスを使用した WorkSpaces のモニタリング
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 メトリクス
`AWS/WorkSpaces` 名前空間には、次のメトリクスが含まれます。
| メトリクス | 説明 | ディメンション | 統計 | 単位 |
| --- | --- | --- | --- | --- |
| `Available` | 正常な WorkSpaces の数。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント |
| `Unhealthy` | 異常な WorkSpaces の数。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント |
| `Stopped` | 停止中の WorkSpaces の数。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント |
| `Maintenance` | メンテナンス中の WorkSpaces の数。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント |
| `ConnectionAttempt`1 | 接続試行の数。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント |
| `ConnectionSuccess`1 | 成功した接続の数。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント |
| `ConnectionFailure`1 | 失敗した接続の数。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント |
| `SessionLaunchTime`1 | WorkSpaces セッションを開始するためにかかる時間。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum、Data Samples | 秒 |
| `SessionDisconnect` | 切断されたセッションの数。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント |
| `UserConnected` | ユーザーが接続されている WorkSpaces の数。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | カウント |
| `TrustedDeviceValidationAttempt`2 | デバイス認証シグニチャ検証の試行回数。 | `DirectoryId` | Average、Sum、Maximum、Minimum、Data Samples | カウント |
| `TrustedDeviceValidationSuccess`2 | 成功したデバイス認証シグニチャ検証の数。 | `DirectoryId` | Average、Sum、Maximum、Minimum、Data Samples | カウント |
| `TrustedDeviceValidationFailure`2 | 失敗したデバイス認証シグニチャ検証の数。 | `DirectoryId` | Average、Sum、Maximum、Minimum、Data Samples | カウント |
| `TrustedDeviceCertificateDaysBeforeExpiration` | ディレクトリに関連付けられたルート証明書の有効期限が切れるまでの日数。 | `CertificateId` | Average、Sum、Maximum、Minimum、Data Samples | カウント |
| `CPUUsage` | 使用された CPU リソースの割合。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum | パーセンテージ |
| `MemoryUsage` | マシンのメモリの使用率。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum | パーセンテージ |
| `RootVolumeDiskUsage` | ルートディスクボリュームの使用率。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum | パーセンテージ |
| `UserVolumeDiskUsage` | ユーザーディスクボリュームの使用率。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum | パーセンテージ |
| `GPUUsage` | WorkSpace で使用されている GPU リソースの割合。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum | パーセンテージ |
| `CPUQueueLength` | WorkSpace で CPU 時間を待機しているスレッドの数。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum | カウント |
| `RootVolumeDiskIOQueueLength` | WorkSpace のルートボリュームディスクによって処理されるのを待っている保留中の I/O リクエストの数。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum | カウント |
| `UserVolumeDiskIOQueueLength` | WorkSpace のユーザーボリュームディスクによって処理されるのを待っている保留中の I/O リクエストの数。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum | カウント |
| `MemoryPageHardFaults` | WorkSpace でのハードページ障害のレート。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum | Count/Second |
| `PagingFileUsage` | WorkSpace で現在使用されているページングファイルの割合。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum | パーセンテージ |
| `UpTime` | WorkSpace の最後の再起動からの時間。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum、Data Samples | 秒 |
| `InSessionLatency` | WorkSpaces クライアントと WorkSpaces 間のラウンドトリップ時間。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum、Data Samples | ミリ秒 |
| `UDPPacketLossRate`3 | ゲートウェイとクライアント間のトラフィックで失われた UDP パケットの割合。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum、Data Samples | パーセンテージ |
| `TCPRetransmissionRate`4 | ゲートウェイからクライアントに再送信された TCP セグメントの割合。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum、Data Samples | パーセンテージ |
| `Bandwidth`4 | ゲートウェイからクライアントに転送されるデータのレート (アウトバウンド）。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum、Data Samples | Kilobits/Second |
| `BandwidthInbound`4 | クライアントからゲートウェイに転送されるデータのレート (インバウンド）。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum、Data Samples | Kilobits/Second |
| `CongestionWindow`4 | クライアントに流れるトラフィックのゲートウェイの輻輳ウィンドウのサイズ。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum、Data Samples | バイト |
| `ConnectionDuration`4 | ストリーミング接続の期間。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum、Data Samples | 秒 |
| `FramesPerSecond`4 | WorkSpace からクライアントに送信された 1 秒あたりのフレーム数。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Maximum、Minimum | Count/Second |
1 WorkSpaces は、各 WorkSpace への接続に関するメトリクスを記録します。これらのメトリクスは、ユーザーが WorkSpaces クライアントを介して正常に認証され、クライアントがセッション接続を開始した後に出力されます。
2 ディレクトリで信頼されたデバイス機能が有効になっている場合、Amazon WorkSpaces は証明書ベースの認証を使用して、デバイスが信頼されているかどうかを判断します。ユーザーが自分の WorkSpaces にアクセスしようとすると、これらのメトリクスが出力され、信頼されたデバイスの認証が成功したか失敗したかが示されます。これらのメトリクスは、Windows および macOS クライアントアプリケーションにのみ適用されます。
3 測定方向は、基盤となるプロトコルによって異なります。
+ **PCoIP の場合**: クライアントからゲートウェイへの損失を測定します。
+ **DCV の場合**: ゲートウェイからクライアントへの損失を測定します。
4 DCV でのみ使用できます。
## WorkSpaces メトリックスのディメンション
メトリクスデータをフィルタリングするために以下のディメンションを使用します。
| ディメンション | 説明 |
| --- | --- |
| `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)の各種形式をご確認ください。 |
## モニタリングの例
次の例は、 を使用して CloudWatch アラームに AWS CLI 応答し、ディレクトリ内のどの 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"
}
```