使用 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`	平均值、總和、最大值、最小值、資料樣本	計數
`Unhealthy`	運作狀態不佳的 WorkSpaces 數量。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均值、總和、最大值、最小值、資料樣本	計數
`Stopped`	已停止的 WorkSpaces 數目。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均值、總和、最大值、最小值、資料樣本	計數
`Maintenance`	正在維護的 WorkSpaces 數目。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均值、總和、最大值、最小值、資料樣本	計數
`ConnectionAttempt`¹	連線嘗試次數。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均值、總和、最大值、最小值、資料樣本	計數
`ConnectionSuccess`¹	成功連線數目。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均值、總和、最大值、最小值、資料樣本	計數
`ConnectionFailure`¹	失敗連線數目。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均值、總和、最大值、最小值、資料樣本	計數
`SessionLaunchTime`¹	起始 WorkSpaces 工作階段所需的時間量。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均、最大值、最小值、資料範例	秒鐘
`SessionDisconnect`	已中斷連線的工作階段數目。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均值、總和、最大值、最小值、資料樣本	計數
`UserConnected`	有使用者連線的 WorkSpaces 數目。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均值、總和、最大值、最小值、資料樣本	計數
`TrustedDeviceValidationAttempt`²	裝置驗證簽章驗證嘗試次數。	`DirectoryId`	平均值、總和、最大值、最小值、資料樣本	計數
`TrustedDeviceValidationSuccess`²	成功的裝置驗證簽章驗證數目。	`DirectoryId`	平均值、總和、最大值、最小值、資料樣本	計數
`TrustedDeviceValidationFailure`²	失敗的裝置驗證簽章驗證數目。	`DirectoryId`	平均值、總和、最大值、最小值、資料樣本	計數
`TrustedDeviceCertificateDaysBeforeExpiration`	與目錄相關聯的根憑證到期前的剩餘天數。	`CertificateId`	平均值、總和、最大值、最小值、資料樣本	計數
`CPUUsage`	使用的 CPU 資源百分比。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均值、最大值、最小值	百分比
`MemoryUsage`	使用的機器記憶體百分比。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均值、最大值、最小值	百分比
`RootVolumeDiskUsage`	使用的根磁碟區百分比。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均值、最大值、最小值	百分比
`UserVolumeDiskUsage`	使用者磁碟區使用的百分比。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均值、最大值、最小值	百分比
`UpTime`	自上次重新啟動 WorkSpace 以來的時間。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均、最大值、最小值、資料範例	秒鐘
`InSessionLatency`	WorkSpaces 用戶端與 WorkSpace 之間的往返時間。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均、最大值、最小值、資料範例	毫秒
`UDPPacketLossRate`³	閘道與用戶端之間流量中遺失的 UDP 封包百分比。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均、最大值、最小值、資料範例	百分比
`TCPRetransmissionRate`⁴	從閘道重新傳輸至用戶端的 TCP 區段百分比。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均、最大值、最小值、資料範例	百分比
`Bandwidth`⁴	從閘道傳輸到用戶端（傳出）的資料速率。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均、最大值、最小值、資料範例	千位元數/秒
`BandwidthInbound`⁴	從用戶端傳輸到閘道（傳入）的資料速率。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均、最大值、最小值、資料範例	千位元數/秒
`CongestionWindow`⁴	流向用戶端之流量的閘道擁塞視窗大小。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均、最大值、最小值、資料範例	位元組
`ConnectionDuration`⁴	串流連線的持續時間。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均、最大值、最小值、資料範例	秒鐘
`FramesPerSecond`⁴	每秒從 WorkSpace 傳送至用戶端的影格數。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均值、最大值、最小值	計數/秒

¹ WorkSpaces 會記錄每個 WorkSpace 連線的指標。這些指標會在使用者透過 WorkSpaces 用戶端成功驗證之後發出，然後用戶端會啟動工作階段連線。

² 如果為目錄啟用信任的裝置功能，Amazon WorkSpaces 會使用憑證型身分驗證來判斷裝置是否受信任。當使用者嘗試存取其 WorkSpaces 時，系統會發出這些指標，指出可信任的裝置驗證成功或失敗。這些指標僅適用於 Windows 和 macOS 用戶端應用程式。

³ 測量方向取決於基礎通訊協定。

在 PCoIP 上：測量從用戶端到閘道的遺失。
在 DCV 上：測量從閘道到用戶端的遺失。

⁴ 僅適用於 DCV。

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 字元，如下所示：重音字母：é、à、ö、ñ 等非拉丁字母符號：©️、®️、€、£、μ、¥ 等。
`ComputerName`	篩選指標資料至指定的 WorkSpace。請參閱 WorkSpaces 電腦名稱的各種格式。

監控範例

下列範例示範如何使用 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 監控