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

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

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

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

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

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

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

⁷ このメトリクスは、パケットの平均損失を測定します。

PCoIP: クライアントからゲートウェイへの UDP パケットの平均損失を測定します。

注記
これはゲートウェイで測定されます。
DCV: ゲートウェイからクライアントへの UDP パケットの損失を測定します。

注記
これはゲートウェイで測定されます。

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 文字を使うことはできません。アクセント文字: é、à、ö、ñ など。非ラテン文字記号: ©️、®️、€、£、μ、¥ など。

モニタリングの例

次の例は、を使用して 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 によるモニタリング