监控您的 WorkSpaces 使用 CloudWatch 指标

WorkSpaces 和亚马逊整 CloudWatch 合在一起，因此您可以收集和分析绩效指标。您可以使用 CloudWatch 控制台、 CloudWatch 命令行界面或使用 CloudWatch API 以编程方式监控这些指标。 CloudWatch 还允许您在达到指标的指定阈值时设置警报。

有关使用 CloudWatch 和警报的更多信息，请参阅亚马逊 CloudWatch 用户指南。

先决条件

要获取 CloudWatch 指标，请在该区域AMAZON子集的端口 443 上启用访问权限。 us-east-1 有关更多信息，请参阅 WorkSpaces 个人的 IP 地址和端口要求。

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`¹	连接尝试次数。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Average、Sum、Maximum、Minimum、Data Samples	计数
`ConnectionSuccess`¹	成功连接的数量。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Average、Sum、Maximum、Minimum、Data Samples	计数
`ConnectionFailure`¹	失败连接的数量。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Average、Sum、Maximum、Minimum、Data Samples	计数
`SessionLaunchTime`¹	启动 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`²	设备身份验证签名验证尝试次数。	`DirectoryId`	Average、Sum、Maximum、Minimum、Data Samples	计数
`TrustedDeviceValidationSuccess`²	成功的设备身份验证签名验证次数。	`DirectoryId`	Average、Sum、Maximum、Minimum、Data Samples	计数
`TrustedDeviceValidationFailure`²	失败的设备身份验证签名验证次数。	`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`³	网关和客户端之间的流量中丢失的 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`	平均值、最大值、最小值、数据样本	Kilobits/Second
`BandwidthInbound`⁴	从客户端传输到网关（入站）的数据速率。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	平均值、最大值、最小值、数据样本	Kilobits/Second
`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`	平均值、最大值、最小值	Count/Second

¹ WorkSpaces 记录了与每个人建立的连接的指标 WorkSpace。这些指标是在用户通过 WorkSpaces 客户端成功进行身份验证后发出的，然后客户端启动会话连接。

² 如果为目录启用了可信设备功能，则亚马逊 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 计算机名称” 的各种格式。

监控示例

以下示例演示如何使用 AWS CLI 来响应 CloudWatch警报并确定目录 WorkSpaces 中哪些人遇到了连接故障。

回应 CloudWatch 警报

使用 describe-alarms 命令确定警报适用于哪个目录。


aws cloudwatch describe-alarms --state-value "ALARM"

{
  "MetricAlarms": [
    {
      ...
      "Dimensions": [
        {
          "Name": "DirectoryId",
          "Value": "directory_id"
        }
      ],
      ...
    }
  ]
}

使用 d escribe-w orkspaces 命令获取指定目录 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 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

使用 CloudWatch 自动仪表板进行监控

使用 Amazon 进行监控 EventBridge