使用 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`	平均值、總和、最大值、最小值、資料樣本	計數
`Unhealthy`¹	傳回不良運作狀態的 WorkSpaces 數目。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	平均值、總和、最大值、最小值、資料樣本	計數
`ConnectionAttempt`²	連線嘗試次數。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	平均值、總和、最大值、最小值、資料樣本	計數
`ConnectionSuccess`²	成功連線數目。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	平均值、總和、最大值、最小值、資料樣本	計數
`ConnectionFailure`²	失敗連線數目。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	平均值、總和、最大值、最小值、資料樣本	計數
`SessionLaunchTime`^2，⁶	起始 WorkSpaces 工作階段所需的時間量。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	平均值、總和、最大值、最小值、資料樣本	秒 (時間)
`InSessionLatency`^2，⁶	WorkSpaces 用戶端與 WorkSpace 之間的往返時間。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	平均值、總和、最大值、最小值、資料樣本	毫秒 (時間)
`SessionDisconnect`^2，⁶	已關閉的連線數目，包括使用者起始和失敗的連線。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	平均值、總和、最大值、最小值、資料樣本	計數
`UserConnected`³	有使用者連線的 WorkSpaces 數目。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	平均值、總和、最大值、最小值、資料樣本	計數
`Stopped`	已停止的 WorkSpaces 數目。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	平均值、總和、最大值、最小值、資料樣本	計數
`Maintenance`⁴	正在維護的 WorkSpaces 數目。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	平均值、總和、最大值、最小值、資料樣本	計數
`TrustedDeviceValidationAttempt`^5，⁶	裝置驗證簽章驗證嘗試次數。	`DirectoryId`	平均值、總和、最大值、最小值、資料樣本	計數
`TrustedDeviceValidationSuccess`^5，⁶	成功的裝置驗證簽章驗證數目。	`DirectoryId`	平均值、總和、最大值、最小值、資料樣本	計數
`TrustedDeviceValidationFailure`^5，⁶	失敗的裝置驗證簽章驗證數目。	`DirectoryId`	平均值、總和、最大值、最小值、資料樣本	計數
`TrustedDeviceCertificateDaysBeforeExpiration`⁶	與目錄相關聯的根憑證到期前的剩餘天數。	`CertificateId`	平均值、總和、最大值、最小值、資料樣本	計數
`CPUUsage`	使用的 CPU 資源百分比。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	平均值、最大值、最小值	百分比
`MemoryUsage`	使用的機器記憶體百分比。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	平均值、最大值、最小值	百分比
`RootVolumeDiskUsage`	使用的根磁碟區百分比。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	平均值、最大值、最小值	百分比
`UserVolumeDiskUsage`	使用者磁碟區使用的百分比。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	平均值、最大值、最小值	百分比
`UDPPacketLossRate`⁷	用戶端與閘道之間捨棄的封包百分比。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	平均、最大值、最小值、資料範例	百分比
`UpTime`	自上次重新啟動 WorkSpace 以來的時間。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	平均、最大值、最小值、資料範例	秒鐘

¹ WorkSpaces 會定期傳送狀態要求給 WorkSpace。WorkSpace 會在回應這些要求時標示為 Available，以及在無法回應這些要求時標示為 Unhealthy。這些指標可在每個 WorkSpace 的精細層級取得，也可針對組織中的所有 WorkSpaces 彙總。

² WorkSpaces 會記錄對每個 WorkSpace 進行之連線的指標。這些指標會在使用者透過 WorkSpaces 用戶端成功驗證，然後用戶端起始工作階段後發出。這些指標可在每個 WorkSpace 的精細層級取得，並且會針對目錄中的所有 WorkSpaces 彙總。

³ WorkSpaces 會定期傳送連線狀態要求給 WorkSpace。當使用者主動使用其工作階段時，系統會回報使用者已連線。這個指標可在每個 WorkSpace 的精細層級取得，也可針對組織中的所有 WorkSpaces 彙總。

⁴ 此指標適用於使用 AutoStop 執行模式設定的 WorkSpaces。如果您已針對 WorkSpaces 啟用維護，此指標會擷取目前正在維護的 WorkSpaces 數目。此指標可在每個 WorkSpace 的精細層級取得，用以說明 WorkSpace 何時進行維護及何時移除。

⁵ 如果目錄已啟用可信任的裝置功能，Amazon WorkSpaces 會使用憑證型驗證來判斷裝置是否可信任。當使用者嘗試存取其 WorkSpaces 時，系統會發出這些指標，指出可信任的裝置驗證成功或失敗。這些指標可在每個目錄的精細層級取得，且僅適用於 Amazon WorkSpaces Windows 和 macOS 用戶端應用程式。

⁶ 不適用於 WorkSpaces Web Access。

⁷ 此指標會測量平均封包遺失。

在 PCoIP 上：測量從用戶端到閘道的平均 UDP 封包遺失。

注意
這是在閘道測量。
在 DCV 上：測量從閘道到用戶端的 UDP 封包遺失。

注意
這是在閘道測量。

WorkSpaces 指標的維度

若要篩選指標資料，請使用下列維度。

維度	描述
`DirectoryId`	篩選指標資料至指定目錄中的 WorkSpaces。目錄 ID 的形式為 `d-XXXXXXXXXX`。
`WorkspaceId`	篩選指標資料至指定的 WorkSpace。WorkSpace ID 的形式為 `ws-XXXXXXXXXX`。
`CertificateId`	篩選指標資料至與目錄相關聯的指定根憑證。憑證 ID 的形式為 `wsc-XXXXXXXXX`。
`RunningMode`	依其執行模式，將指標資料篩選至 WorkSpaces。執行模式的形式為 AutoStop 或 AlwaysOn。
`BundleId`	依通訊協定將指標資料篩選至 WorkSpaces。套件的形式為 `wsb-XXXXXXXXXX`。
`ComputeType`	依運算類型將指標資料篩選至 WorkSpaces。
`Protocol`	依通訊協定類型將指標資料篩選至 WorkSpaces。
`UserName`	依使用者名稱將指標資料篩選至 WorkSpaces。注意 `UserName` 不能包含非 ASCII 字元，例如：重音字母：é、à、ö、ñ 等非拉丁字母符號：©️、®️、€、£、μ、¥ 等。

監控範例

下列範例示範如何使用 AWS CLI 來回應 CloudWatch 警示，並判斷目錄中的哪些 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 命令來取得目錄中每個 WorkSpace 的 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。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

使用 CloudWatch 自動儀表板監控

使用 Amazon EventBridge 監控