WorkSpaces メトリクス WorkSpaces メトリックスのディメンションモニタリングの例

CloudWatch メトリクスを使用した WorkSpaces のモニタリング

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

CloudWatchとアラームの使用の詳細については、Amazon CloudWatch ユーザーガイドを参照してください。

前提条件

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

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`¹	接続試行の数。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Average、Sum、Maximum、Minimum、Data Samples	カウント
`ConnectionSuccess`¹	成功した接続の数。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Average、Sum、Maximum、Minimum、Data Samples	カウント
`ConnectionFailure`¹	失敗した接続の数。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Average、Sum、Maximum、Minimum、Data Samples	カウント
`SessionLaunchTime`¹	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`²	デバイス認証シグニチャ検証の試行回数。	`DirectoryId`	Average、Sum、Maximum、Minimum、Data Samples	カウント
`TrustedDeviceValidationSuccess`²	成功したデバイス認証シグニチャ検証の数。	`DirectoryId`	Average、Sum、Maximum、Minimum、Data Samples	カウント
`TrustedDeviceValidationFailure`²	失敗したデバイス認証シグニチャ検証の数。	`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	パーセンテージ
`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`³	ゲートウェイとクライアント間のトラフィックで失われた UDP パケットの割合。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Average、Maximum、Minimum、Data Samples	パーセンテージ
`TCPRetransmissionRate`⁴	ゲートウェイからクライアントに再送信された TCP セグメントの割合。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Average、Maximum、Minimum、Data Samples	パーセンテージ
`Bandwidth`⁴	ゲートウェイからクライアントに転送されるデータのレート (アウトバウンド）。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Average、Maximum、Minimum、Data Samples	Kilobits/Second
`BandwidthInbound`⁴	クライアントからゲートウェイに転送されるデータのレート (インバウンド）。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Average、Maximum、Minimum、Data Samples	Kilobits/Second
`CongestionWindow`⁴	クライアントに流れるトラフィックのゲートウェイの輻輳ウィンドウのサイズ。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Average、Maximum、Minimum、Data Samples	バイト
`ConnectionDuration`⁴	ストリーミング接続の期間。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Average、Maximum、Minimum、Data Samples	秒
`FramesPerSecond`⁴	WorkSpace からクライアントに送信された 1 秒あたりのフレーム数。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Average、Maximum、Minimum	Count/Second

¹ WorkSpaces は、各 WorkSpace への接続に関するメトリクスを記録します。これらのメトリクスは、ユーザーが WorkSpaces クライアントを介して正常に認証され、クライアントがセッション接続を開始した後に出力されます。

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

³ 測定方向は、基盤となるプロトコルによって異なります。

PCoIP の場合: クライアントからゲートウェイへの損失を測定します。
DCV の場合: ゲートウェイからクライアントへの損失を測定します。

⁴ 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 コンピュータ名の各種形式をご確認ください。

モニタリングの例

次の例は、を使用して CloudWatch アラームに AWS CLI 応答し、ディレクトリ内のどの WorkSpaces で接続障害が発生したかを判断する方法を示しています。

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

describe-alarms コマンドを使用して、アラームの対象になっているディレクトリを特定します。


aws cloudwatch describe-alarms --state-value "ALARM"

{
  "MetricAlarms": [
    {
      ...
      "Dimensions": [
        {
          "Name": "DirectoryId",
          "Value": "directory_id"
        }
      ],
      ...
    }
  ]
}

describe-WorkSpaces コマンドを使用して、指定したディレクトリの WorkSpaces のリストを取得します。


aws workspaces describe-workspaces --directory-id directory_id

{
  "Workspaces": [
    {
      ...
      "WorkspaceId": "workspace1_id",
      ...
    },
    {
      ...
      "WorkspaceId": "workspace2_id",
      ...
    },
    {
      ...
      "WorkspaceId": "workspace3_id",
      ...
    }
  ]
}

get-metric-statistics コマンドを使用して、ディレクトリ内の各 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"
}

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

CloudWatch 自動ダッシュボードによるモニタリング

Amazon EventBridge によるモニタリング