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

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 WorkSpaces 指标监控您的CloudWatch

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

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

Prerequisites

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

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，在无法响应这些请求时，标记为 Unhealthy。这些指标以 WorkSpace 为粒度提供，并且对组织中的所有 WorkSpaces 进行汇总。

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

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

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

Amazon WorkSpaces 指标的维度

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

维度 描述
DirectoryId 将指标数据筛选为指定目录中的 WorkSpaces。目录 ID 的形式为 d-XXXXXXXXXX.
WorkspaceId 按照指定的 WorkSpace 筛选指标数据。 工作区 ID 的形式为 ws-XXXXXXXXXX。

监控示例

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

响应 CloudWatch 警报

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

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

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

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

    aws workspaces describe-workspaces --directory-id directory_id

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

  3. 使用 CloudWatchget-metric-statisticsWorkSpace 命令获取目录中每个 的 指标。 

    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"
}