使用 CloudWatch 指标监控您的 WorkSpaces - Amazon WorkSpaces
Amazon WorkSpaces 指标Amazon WorkSpaces 指标的维度监控示例
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

使用 CloudWatch 指标监控您的 WorkSpaces

Amazon WorkSpaces 和 Amazon CloudWatch 均为集成式，因此您可收集并分析性能指标。您可以使用 CloudWatch 控制台、CloudWatch 命令行界面或者以编程方式使用 CloudWatch API 来监控这些指标。您还可以使用 CloudWatch 设置警报，让系统在达到某指标的指定阈值时提醒您。

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

先决条件

要获取 CloudWatch 指标，请在 cn-northwest-1 区域的 AMAZON 子网的端口 443 上启用访问。有关更多信息，请参阅 Amazon WorkSpaces 的 IP 地址和端口要求。

Amazon WorkSpaces 指标

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

指标 描述 维度 可用统计数据 单位
Available1

返回正常运行状态的 WorkSpaces 的数量。

DirectoryId

WorkspaceId

 Average、Sum、Maximum、Minimum、Data Samples 计数
Unhealthy1

返回不正常运行状态的 WorkSpaces 的数量。

DirectoryId

WorkspaceId

 Average、Sum、Maximum、Minimum、Data Samples 计数
ConnectionAttempt2

连接尝试次数。

DirectoryId

WorkspaceId

 Average、Sum、Maximum、Minimum、Data Samples 计数
ConnectionSuccess2

成功连接的数量。

DirectoryId

WorkspaceId

 Average、Sum、Maximum、Minimum、Data Samples 计数
ConnectionFailure2

失败连接的数量。

DirectoryId

WorkspaceId

 Average、Sum、Maximum、Minimum、Data Samples 计数
SessionLaunchTime2

发起 WorkSpaces 会话所用的时间量。

DirectoryID

WorkspaceID

Average、Sum、Maximum、Minimum、Data Samples

秒（时间）
InSessionLatency2

WorkSpaces 客户端和 WorkSpace 之间的往返操作时间。

DirectoryID

WorkspaceID

Average、Sum、Maximum、Minimum、Data Samples

毫秒（时间）
SessionDisconnect2

已关闭的连接数，包括用户启动的和失败的连接。

DirectoryID

WorkspaceID

Average、Sum、Maximum、Minimum、Data Samples

计数
UserConnected3

用户已连接的 WorkSpaces 数量。

DirectoryID

WorkspaceID

Average、Sum、Maximum、Minimum、Data Samples

计数
Stopped

已停止的 WorkSpaces 的数量。

DirectoryID

WorkspaceID

Average、Sum、Maximum、Minimum、Data Samples

计数
Maintenance4

正在维护的 WorkSpaces 的数量。

DirectoryID

WorkspaceID

Average、Sum、Maximum、Minimum、Data Samples

计数

1 Amazon WorkSpaces 定期向 WorkSpace 发送状态请求。响应这些请求的 WorkSpace 标记为 Available，不响应这些请求的 WorkSpace 标记为 Unhealthy。这些指标以 WorkSpace 为粒度提供，并且对一个组织内的所有 WorkSpace 进行汇总。

2 Amazon WorkSpaces 记录针对每个 WorkSpace 进行的连接的指标。在用户成功通过 WorkSpaces 客户端进行身份验证并且客户端启动会话后，会发出这些指标。这些指标以 WorkSpace 为粒度提供，并且对一个目录内的所有 WorkSpaces 进行汇总。

3 Amazon WorkSpaces 定期向 WorkSpace 发送连接状态请求。当用户正在主动使用他们的会话时，他们被报告为已连接。此指标以 WorkSpace 为粒度提供，并且对组织内的所有 WorkSpaces 进行汇总。

4 此指标适用于以 AutoStop 运行模式配置的 WorkSpaces。如果您已为您的 WorkSpaces 启用了维护，则此指标捕获当前正在维护的 WorkSpaces 数量。此指标以 WorkSpace 为粒度提供，描述 WorkSpace 何时进入维护，以及何时移除。

Amazon WorkSpaces 指标的维度

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

维度 说明
DirectoryId 筛选指标数据，限定为指定目录中的 WorkSpaces。目录 ID 的形式为 d-XXXXXXXXXX。
WorkspaceId 筛选指标数据，限定为指定的 WorkSpace。Workspace ID 的形式为 ws-XXXXXXXXXX。

监控示例

以下示例展示了如何使用 AWS CLI 响应 CloudWatch 警报，以及如何确定目录中的哪些 WorkSpace 遇到了连接故障。

响应 CloudWatch 警报

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

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

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

  2. 使用 describe-workspaces 命令获取指定目录中的 WorkSpace 列表。 

    aws workspaces describe-workspaces --directory-id directory_id

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

  3. 使用 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"
}