监控 WorkSpaces 使用 CloudWatch 指标

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

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

先决条件

要获得 CloudWatch 指标，启用端口 443 的访问权限AMAZON中的子集cn-northwest-1 区域。有关更多信息，请参阅IP 地址和端口要求 WorkSpaces。

WorkSpaces 指标
的维度 WorkSpaces 指标
监控示例

WorkSpaces 指标

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

指标	描述	维度	统计数据	单位
`Available`¹	数量 WorkSpaces 返回了健康状态。	`DirectoryId` `WorkspaceId`	Average、Sum、Maximum、Minimum、Data Samples	计数
`Unhealthy`¹	数量 WorkSpaces 返回了不健康的状态。	`DirectoryId` `WorkspaceId`	Average、Sum、Maximum、Minimum、Data Samples	计数
`ConnectionAttempt`²⁵	连接尝试次数。	`DirectoryId` `WorkspaceId`	Average、Sum、Maximum、Minimum、Data Samples	计数
`ConnectionSuccess`²⁵	成功连接的数量。	`DirectoryId` `WorkspaceId`	Average、Sum、Maximum、Minimum、Data Samples	计数
`ConnectionFailure`²⁵	失败连接的数量。	`DirectoryId` `WorkspaceId`	Average、Sum、Maximum、Minimum、Data Samples	计数
`SessionLaunchTime`²	启动 a 所用时间 WorkSpaces 会话。	`DirectoryId` `WorkspaceId`	Average、Sum、Maximum、Minimum、Data Samples	秒（时间）
`InSessionLatency`²	两者之间的往返时间 WorkSpaces 客户端 WorkSpace.	`DirectoryId` `WorkspaceId`	Average、Sum、Maximum、Minimum、Data Samples	毫秒（时间）
`SessionDisconnect`²	已关闭的连接数，包括用户启动的和失败的连接。	`DirectoryId` `WorkspaceId`	Average、Sum、Maximum、Minimum、Data Samples	计数
`UserConnected`³	数量 WorkSpaces 已连接用户的。	`DirectoryId` `WorkspaceId`	Average、Sum、Maximum、Minimum、Data Samples	计数
`Stopped`	数量 WorkSpaces 已停止。	`DirectoryId` `WorkspaceId`	Average、Sum、Maximum、Minimum、Data Samples	计数
`Maintenance`⁴	数量 WorkSpaces 正在维护中。	`DirectoryId` `WorkspaceId`	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	计数

¹ WorkSpaces 定期向 a 发送状态请求 WorkSpace. 一个 WorkSpace 已标记Available它何时回应这些请求，以及Unhealthy当它未能回应这些请求时。这些指标是按比例提供的WorkSpace 粒度级别，也针对所有粒度进行汇总 WorkSpaces 在组织中。

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

³ WorkSpaces 定期将连接状态请求发送到 WorkSpace. 当用户正在主动使用他们的会话时，他们被报告为已连接。此指标按每比计算WorkSpace 粒度级别，还会针对所有粒度进行聚合 WorkSpaces 在组织中。

⁴此指标适用于 WorkSpaces 配置为 AutoStop 运行模式。如果您为自己启用了维护 WorkSpaces，此指标捕获的数量为 WorkSpaces 目前正在维护中。此指标按每比计算WorkSpace 粒度级别，它描述了何时 WorkSpace 进入维护阶段，何时被拆除。

⁵此指标目前仅针对 PCoIP 发布 WorkSpaces.

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

的维度 WorkSpaces 指标

要筛选指标数据，请使用以下维度。

维度	描述
`DirectoryId`	将指标数据筛选到 WorkSpaces 在指定的目录中。目录 ID 的形式为 `d-XXXXXXXXXX`。
`WorkspaceId`	筛选指标数据以指定的 WorkSpace. 的形式 WorkSpace ID 是`ws-XXXXXXXXXX`.
`CertificateId`	将指标数据筛选到与该目录关联的指定根证书。证书 ID 的形式是`wsc-XXXXXXXXX`.

监控示例

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

响应一个 CloudWatch 警报

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


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

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

获取清单 WorkSpaces 在指定的目录中使用描述workaces命令。


aws workspaces describe-workspaces --directory-id directory_id

{
  "Workspaces": [
    {
      ...
      "WorkspaceId": "workspace1_id",
      ...
    },
    {
      ...
      "WorkspaceId": "workspace2_id",
      ...
    },
    {
      ...
      "WorkspaceId": "workspace3_id",
      ...
    }
  ]
}

获取到 CloudWatch 每个指标的指标 WorkSpace 在目录中使用get-metric-statistics命令。


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。请参阅浏览器的帮助页面以了解相关说明。

监控 WorkSpaces

使用监控 CloudWatch 事件