监控您的 WorkSpaces 使用 CloudWatch 指标

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

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

先决条件

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

WorkSpaces 指标

AWS/WorkSpaces 命名空间包括以下指标。

指标	描述	维度	统计信息	单位
`Available`¹	其中的数字返回 WorkSpaces 了健康状态。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	Average、Sum、Maximum、Minimum、Data Samples	计数
`Unhealthy`¹	其中的数字返回 WorkSpaces 了不健康的状态。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	Average、Sum、Maximum、Minimum、Data Samples	计数
`ConnectionAttempt`²	连接尝试次数。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	Average、Sum、Maximum、Minimum、Data Samples	计数
`ConnectionSuccess`²	成功连接的数量。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	Average、Sum、Maximum、Minimum、Data Samples	计数
`ConnectionFailure`²	失败连接的数量。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	Average、Sum、Maximum、Minimum、Data Samples	计数
`SessionLaunchTime`^2、 ⁶	启动 WorkSpaces会话所需的时间。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	Average、Sum、Maximum、Minimum、Data Samples	秒（时间）
`InSessionLatency`^2、 ⁶	WorkSpaces 客户端与之间的往返时间 WorkSpace。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	Average、Sum、Maximum、Minimum、Data Samples	毫秒（时间）
`SessionDisconnect`^2、 ⁶	已关闭的连接数，包括用户启动的和失败的连接。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	Average、Sum、Maximum、Minimum、Data Samples	计数
`UserConnected`³	WorkSpaces 已连接用户的数量。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	Average、Sum、Maximum、Minimum、Data Samples	计数
`Stopped`	其中的数量 WorkSpaces 已停止。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	Average、Sum、Maximum、Minimum、Data Samples	计数
`Maintenance`⁴	其数量 WorkSpaces 正在维护中。	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName`	Average、Sum、Maximum、Minimum、Data Samples	计数
`TrustedDeviceValidationAttempt`^5、 ⁶	设备身份验证签名验证尝试次数。	`DirectoryId`	Average、Sum、Maximum、Minimum、Data Samples	计数
`TrustedDeviceValidationSuccess`^5、 ⁶	成功的设备身份验证签名验证次数。	`DirectoryId`	Average、Sum、Maximum、Minimum、Data Samples	计数
`TrustedDeviceValidationFailure`^5、 ⁶	失败的设备身份验证签名验证次数。	`DirectoryId`	Average、Sum、Maximum、Minimum、Data Samples	计数
`TrustedDeviceCertificateDaysBeforeExpiration`⁶	与该目录关联的根证书过期前所剩的天数。	`CertificateId`	Average、Sum、Maximum、Minimum、Data Samples	计数
`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 定期向 a 发送状态请求 WorkSpace。A WorkSpace Available 在响应这些请求以及未能响应这些请求Unhealthy时被标记。这些指标是按粒度WorkSpace 级别提供的，也可以汇总组织 WorkSpaces 中的所有指标。

² WorkSpaces 记录了与每个连接的指标 WorkSpace。这些指标是在用户成功通过客户端进行身份验证并且 WorkSpaces 客户端启动会话之后发出的。这些指标按粒度WorkSpace 级别提供，也可以在目录 WorkSpaces 中汇总所有指标。

³ WorkSpaces 定期向 a 发送连接状态请求 WorkSpace。当用户正在主动使用他们的会话时，他们被报告为已连接。该指标按粒度WorkSpace 级别提供，也针对组织 WorkSpaces 中的所有人进行汇总。

⁴ 此指标适用于配置 WorkSpaces 了 AutoStop 运行模式的指标。如果您启用了维护功能 WorkSpaces，则此指标会捕获当前处于维护状态的 WorkSpaces 数量。该指标按粒度提供，它描述了何时 WorkSpace 进入维护状态以及何时被移除。WorkSpace

⁵ 如果目录启用了可信设备功能，Amazon 将 WorkSpaces 使用基于证书的身份验证来确定设备是否可信。当用户尝试访问其时 WorkSpaces，系统会发出这些指标以指示可信设备身份验证成功或失败。这些指标在每个目录的粒度级别上可用，并且仅适用于亚马逊 WorkSpaces Windows 和 macOS 客户端应用程序。

⁶ 在 WorkSpaces Web 访问上不可用。

⁷ 该指标测量平均数据包丢失率。

在 PCo IP 上：测量从客户端到网关的平均 UDP 数据包丢失。

注意
这是在网关上测量的。
在 DCV 上：测量从网关到客户端的 UDP 数据包丢失率。

注意
这是在网关上测量的。

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 字符组成，如以下字符：重音字母：é、à、ö、ñ 等非拉丁字母符号：©️、®️、€、£、µ、¥ 等

监控示例

以下示例演示了如何使用 Amazon CLI 来响应 CloudWatch警报并确定目录 WorkSpaces 中哪个出现了连接故障。

回应 CloudWatch 警报

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


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

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

使用 desc ribe- 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 在您的浏览器中被禁用或不可用。

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

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

使用 Amazon 进行监控 EventBridge