本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用 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`1 | 傳回良好運作狀態的 WorkSpaces 數目。 | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 平均值、總和、最大值、最小值、資料樣本 | 計數 | | `Unhealthy`1 | 傳回不良運作狀態的 WorkSpaces 數目。 | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 平均值、總和、最大值、最小值、資料樣本 | 計數 | | `ConnectionAttempt`2 | 連線嘗試次數。 | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 平均值、總和、最大值、最小值、資料樣本 | 計數 | | `ConnectionSuccess`2 | 成功連線數目。 | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 平均值、總和、最大值、最小值、資料樣本 | 計數 | | `ConnectionFailure`2 | 失敗連線數目。 | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 平均值、總和、最大值、最小值、資料樣本 | 計數 | | `SessionLaunchTime`2，6 | 起始 WorkSpaces 工作階段所需的時間量。 | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 平均值、總和、最大值、最小值、資料樣本 | 秒 (時間) | | `InSessionLatency`2，6 | WorkSpaces 用戶端與 WorkSpace 之間的往返時間。 | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 平均值、總和、最大值、最小值、資料樣本 | 毫秒 (時間) | | `SessionDisconnect`2，6 | 已關閉的連線數目，包括使用者起始和失敗的連線。 | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 平均值、總和、最大值、最小值、資料樣本 | 計數 | | `UserConnected`3 | 有使用者連線的 WorkSpaces 數目。 | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 平均值、總和、最大值、最小值、資料樣本 | 計數 | | `Stopped` | 已停止的 WorkSpaces 數目。 | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 平均值、總和、最大值、最小值、資料樣本 | 計數 | | `Maintenance`4 | 正在維護的 WorkSpaces 數目。 | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 平均值、總和、最大值、最小值、資料樣本 | 計數 | | `TrustedDeviceValidationAttempt`5，6 | 裝置驗證簽章驗證嘗試次數。 | `DirectoryId` | 平均值、總和、最大值、最小值、資料樣本 | 計數 | | `TrustedDeviceValidationSuccess`5，6 | 成功的裝置驗證簽章驗證數目。 | `DirectoryId` | 平均值、總和、最大值、最小值、資料樣本 | 計數 | | `TrustedDeviceValidationFailure`5，6 | 失敗的裝置驗證簽章驗證數目。 | `DirectoryId` | 平均值、總和、最大值、最小值、資料樣本 | 計數 | | `TrustedDeviceCertificateDaysBeforeExpiration`6 | 與目錄相關聯的根憑證到期前的剩餘天數。 | `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` | 平均值、最大值、最小值 | 百分比 | | `UDPPacketLossRate`7 | 用戶端與閘道之間捨棄的封包百分比。 | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 平均、最大值、最小值、資料範例 | 百分比 | | `UpTime` | 自上次重新啟動 WorkSpace 以來的時間。 | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 平均、最大值、最小值、資料範例 | 秒鐘 | 1 WorkSpaces 會定期傳送狀態要求給 WorkSpace。WorkSpace 會在回應這些要求時標示為 `Available`，以及在無法回應這些要求時標示為 `Unhealthy`。這些指標可在每個 WorkSpace 的精細層級取得，也可針對組織中的所有 WorkSpaces 彙總。 2 WorkSpaces 會記錄對每個 WorkSpace 進行之連線的指標。這些指標會在使用者透過 WorkSpaces 用戶端成功驗證，然後用戶端起始工作階段後發出。這些指標可在每個 WorkSpace 的精細層級取得，並且會針對目錄中的所有 WorkSpaces 彙總。 3 WorkSpaces 會定期傳送連線狀態要求給 WorkSpace。當使用者主動使用其工作階段時，系統會回報使用者已連線。這個指標可在每個 WorkSpace 的精細層級取得，也可針對組織中的所有 WorkSpaces 彙總。 4 此指標適用於使用 AutoStop 執行模式設定的 WorkSpaces。如果您已針對 WorkSpaces 啟用維護，此指標會擷取目前正在維護的 WorkSpaces 數目。此指標可在每個 WorkSpace 的精細層級取得，用以說明 WorkSpace 何時進行維護及何時移除。 5 如果目錄已啟用可信任的裝置功能，Amazon WorkSpaces 會使用憑證型驗證來判斷裝置是否可信任。當使用者嘗試存取其 WorkSpaces 時，系統會發出這些指標，指出可信任的裝置驗證成功或失敗。這些指標可在每個目錄的精細層級取得，且僅適用於 Amazon WorkSpaces Windows 和 macOS 用戶端應用程式。 6 不適用於 WorkSpaces Web Access。 7 此指標會測量平均封包遺失。 + **在 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 字元，如下所示： 重音字母：é、à、ö、ñ 等 非拉丁字母 符號：©️、®️、€、£、μ、¥ 等。 | | `ComputerName` | 篩選指標資料至指定的 WorkSpace。請參閱 [WorkSpaces 電腦名稱]( https://docs.aws.amazon.com/workspaces/latest/adminguide/wsp-directory-identify-computer.html)的各種格式。 | ## 監控範例 下列範例示範如何使用 AWS CLI 來回應 CloudWatch 警示，並判斷目錄中的哪些 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) 命令來取得目錄中每個 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" } ```