本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 监控您的 WorkSpaces 使用 CloudWatch 指标
WorkSpaces 和亚马逊整 CloudWatch 合在一起，因此您可以收集和分析绩效指标。您可以使用 CloudWatch 控制台、 CloudWatch 命令行界面或使用 CloudWatch API 以编程方式监控这些指标。 CloudWatch 还允许您在达到指标的指定阈值时设置警报。
有关使用 CloudWatch 和警报的更多信息，请参阅[亚马逊 CloudWatch 用户指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/)。
**先决条件**
要获取 CloudWatch 指标，请在该区域`AMAZON`子集的端口 443 上启用访问权限。 `us-east-1` 有关更多信息，请参阅 [WorkSpaces 个人的 IP 地址和端口要求](workspaces-port-requirements.md)。
**Topics**
+ [WorkSpaces 指标](#wsp-metrics)
+ [WorkSpaces 指标的维度](#wsp-metric-dimensions)
+ [监控示例](#monitoring_example)
## 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`1 | 连接尝试次数。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | 计数 |
| `ConnectionSuccess`1 | 成功连接的数量。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | 计数 |
| `ConnectionFailure`1 | 失败连接的数量。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Average、Sum、Maximum、Minimum、Data Samples | 计数 |
| `SessionLaunchTime`1 | 启动 WorkSpaces会话所需的时间。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 平均值、最大值、最小值、数据样本 | 秒 |
| `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`2 | 设备身份验证签名验证尝试次数。 | `DirectoryId` | Average、Sum、Maximum、Minimum、Data Samples | 计数 |
| `TrustedDeviceValidationSuccess`2 | 成功的设备身份验证签名验证次数。 | `DirectoryId` | Average、Sum、Maximum、Minimum、Data Samples | 计数 |
| `TrustedDeviceValidationFailure`2 | 失败的设备身份验证签名验证次数。 | `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` | 平均值、最大值、最小值 | 百分比 |
| `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` | 平均值、最大值、最小值 | 百分比 |
| `GPUUsage` | 上使用的 GPU 资源的百分比 WorkSpace。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 平均值、最大值、最小值 | 百分比 |
| `CPUQueueLength` | 在上等待 CPU 时间的线程数 WorkSpace。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 平均值、最大值、最小值 | 计数 |
| `RootVolumeDiskIOQueueLength` | 等待由根卷磁盘处理的待处理 I/O 请求的数量 WorkSpace。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 平均值、最大值、最小值 | 计数 |
| `UserVolumeDiskIOQueueLength` | 等待用户卷盘处理的待处理 I/O 请求的数量 WorkSpace。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 平均值、最大值、最小值 | 计数 |
| `MemoryPageHardFaults` | 上的硬页错误率 WorkSpace。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 平均值、最大值、最小值 | Count/Second |
| `PagingFileUsage` | 当前在上使用的寻呼文件的百分比。 WorkSpace | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 平均值、最大值、最小值 | 百分比 |
| `UpTime` | 自上次重新启动 a 以来的时间 WorkSpace。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 平均值、最大值、最小值、数据样本 | 秒 |
| `InSessionLatency` | WorkSpaces 客户与... 之间的往返时间 WorkSpace。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 平均值、最大值、最小值、数据样本 | 毫秒 |
| `UDPPacketLossRate`3 | 网关和客户端之间的流量中丢失的 UDP 数据包的百分比。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 平均值、最大值、最小值、数据样本 | 百分比 |
| `TCPRetransmissionRate`4 | 从网关重新传输到客户端的 TCP 分段的百分比。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 平均值、最大值、最小值、数据样本 | 百分比 |
| `Bandwidth`4 | 从网关传输到客户端（出站）的数据速率。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 平均值、最大值、最小值、数据样本 | Kilobits/Second |
| `BandwidthInbound`4 | 从客户端传输到网关（入站）的数据速率。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 平均值、最大值、最小值、数据样本 | Kilobits/Second |
| `CongestionWindow`4 | 流向客户端的流量在网关处的拥塞窗口的大小。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 平均值、最大值、最小值、数据样本 | 字节 |
| `ConnectionDuration`4 | 流媒体连接的持续时间。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 平均值、最大值、最小值、数据样本 | 秒 |
| `FramesPerSecond`4 | 每秒从发送 WorkSpace 到客户端的帧数。 | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 平均值、最大值、最小值 | Count/Second |
1 WorkSpaces 记录了与每个人建立的连接的指标 WorkSpace。这些指标是在用户通过 WorkSpaces 客户端成功进行身份验证后发出的，然后客户端启动会话连接。
2 如果为目录启用了可信设备功能，则亚马逊 WorkSpaces 使用基于证书的身份验证来确定设备是否可信。当用户尝试访问他们的时 WorkSpaces，会发出这些指标以表示可信设备身份验证成功或失败。这些指标仅适用于 Windows 和 macOS 客户端应用程序。
3 测量方向取决于基础协议。
+ **在 PCoIP 上**：测量从客户端到网关的损失。
+ **在 DCV 上**：测量从网关到客户端的损失。
4 仅在 DCV 上可用。
## WorkSpaces 指标的维度
要筛选指标数据，请使用以下维度。
| 维度 | 说明 |
| --- | --- |
| `DirectoryId` | 将指标数据筛选到 WorkSpaces 指定目录中的。目录 ID 的形式为 `d-XXXXXXXXXX`。 |
| `WorkspaceId` | 将指标数据筛选为指定值 WorkSpace。 WorkSpace 身份证的形式是`ws-XXXXXXXXXX`。 |
| `CertificateId` | 针对与该目录关联的指定根证书筛选指标数据。证书 ID 的形式为 `wsc-XXXXXXXXX`。 |
| `RunningMode` | WorkSpaces 按运行模式筛选指标数据。运行模式的形式为 AutoStop 或 AlwaysOn。 |
| `BundleId` | WorkSpaces 按协议筛选指标数据。捆绑包的形式为 `wsb-XXXXXXXXXX`。 |
| `ComputeType` | WorkSpaces 按计算类型将指标数据筛选为。 |
| `Protocol` | WorkSpaces 按协议类型筛选指标数据。 |
| `UserName` | WorkSpaces 按用户名筛选指标数据。 `UserName` 不能由非 ASCII 字符组成，如以下字符： 重音字母：é、à、ö、ñ 等 Non-Latin 字母 符号：©️、®️、€、£、µ、¥ 等 |
| `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. 使用 d [ escribe-w ](https://docs.aws.amazon.com/cli/latest/reference/workspaces/describe-workspaces.html) orkspaces 命令获取指定目录 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"
}
```