CloudWatch 지표를 사용하여 WorkSpaces 모니터링

WorkSpaces 및 Amazon CloudWatch가 통합되어 성능 지표를 수집하고 분석할 수 있습니다. CloudWatch 콘솔, CloudWatch의 명령줄 인터페이스를 사용하거나 프로그래밍 방식으로 CloudWatch API를 사용하여 이러한 지표를 모니터링할 수 있습니다. CloudWatch에서는 지표에 지정된 임계값에 도달할 때 경보를 설정할 수 있습니다.

CloudWatch와 경보 사용에 대한 자세한 내용은 Amazon CloudWatch 사용 설명서를 참조하세요.

사전 조건

CloudWatch 지표를 가져오려면 us-east-1 리전의 AMAZON 하위 세트에서 포트 443에서의 액세스를 활성화합니다. 자세한 내용은 WorkSpaces Personal의 IP 주소 및 포트 요구 사항 섹션을 참조하세요.

WorkSpaces 지표

AWS/WorkSpaces 네임스페이스에는 다음과 같은 지표가 포함됩니다.

지표	설명	측정 기준	통계	단위
`Available`	정상 상태인 WorkSpaces 수입니다.	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	평균, 합계, 최대, 최소, 데이터 샘플	개수
`Unhealthy`	비정상인 WorkSpaces 수입니다.	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	평균, 합계, 최대, 최소, 데이터 샘플	개수
`Stopped`	중단된 WorkSpaces의 수.	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	평균, 합계, 최대, 최소, 데이터 샘플	개수
`Maintenance`	유지보수 중인 WorkSpaces의 수.	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	평균, 합계, 최대, 최소, 데이터 샘플	개수
`ConnectionAttempt`¹	연결 시도 횟수.	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	평균, 합계, 최대, 최소, 데이터 샘플	개수
`ConnectionSuccess`¹	성공적 연결 수.	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	평균, 합계, 최대, 최소, 데이터 샘플	개수
`ConnectionFailure`¹	실패한 연결 수.	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	평균, 합계, 최대, 최소, 데이터 샘플	개수
`SessionLaunchTime`¹	WorkSpaces 세션을 시작하는 데 소요된 시간	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	평균, 최대, 최소, 데이터 샘플	초
`SessionDisconnect`	연결이 해제된 세션 수입니다.	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	평균, 합계, 최대, 최소, 데이터 샘플	개수
`UserConnected`	사용자가 연결되어 있는 WorkSpaces의 수.	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	평균, 합계, 최대, 최소, 데이터 샘플	개수
`TrustedDeviceValidationAttempt`²	디바이스 인증 서명 유효성 검사를 시도한 횟수.	`DirectoryId`	평균, 합계, 최대, 최소, 데이터 샘플	개수
`TrustedDeviceValidationSuccess`²	디바이스 인증 서명 유효성 검사에 성공한 횟수.	`DirectoryId`	평균, 합계, 최대, 최소, 데이터 샘플	개수
`TrustedDeviceValidationFailure`²	디바이스 인증 서명 유효성 검사에 실패한 횟수.	`DirectoryId`	평균, 합계, 최대, 최소, 데이터 샘플	개수
`TrustedDeviceCertificateDaysBeforeExpiration`	디렉터리와 연결된 루트 인증서가 만료되기까지 남은 일수.	`CertificateId`	평균, 합계, 최대, 최소, 데이터 샘플	개수
`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`	평균, 최대, 최소	백분율
`UpTime`	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`	평균, 최대, 최소, 데이터 샘플	Kbit/s
`BandwidthInbound`⁴	클라이언트에서 게이트웨이(인바운드)로 전송된 데이터의 속도입니다.	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	평균, 최대, 최소, 데이터 샘플	Kbit/s
`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`	평균, 최대, 최소	개수/초

¹ WorkSpaces는 각 WorkSpace에 대한 연결에 대한 지표를 기록합니다. 이러한 지표는 사용자가 WorkSpaces 클라이언트를 통해 성공적으로 인증한 후 클라이언트가 세션 연결을 시작한 후에 생성됩니다.

² 디렉터리에 대해 신뢰할 수 있는 디바이스 기능이 활성화된 경우 Amazon WorkSpaces는 인증서 기반 인증을 사용하여 디바이스가 신뢰할 수 있는지 확인합니다. 사용자가 WorkSpaces에 액세스하려고 하면 이러한 지표가 생성되어 신뢰할 수 있는 디바이스 인증의 성공 또는 실패를 나타냅니다. 이러한 지표는 Windows 및 macOS 클라이언트 애플리케이션에만 적용됩니다.

³ 측정 방향은 기본 프로토콜에 따라 다릅니다.

PCoIP: 클라이언트에서 게이트웨이로의 손실을 측정합니다.
DCV: 게이트웨이에서 클라이언트로의 손실을 측정합니다.

⁴ DCV에서만 사용할 수 있습니다.

WorkSpaces 지표 차원

지표 데이터를 필터링하려면 다음 차원을 사용하세요.

차원	설명
`DirectoryId`	지정된 디렉터리의 WorkSpaces로 수신하는 지표 데이터를 필터링합니다. 디렉터리 ID는 `d-XXXXXXXXXX` 형식입니다.
`WorkspaceId`	지정된 WorkSpaces로 수신하는 지표 데이터를 필터링합니다. Workspace ID는 `ws-XXXXXXXXXX` 형식입니다.
`CertificateId`	지표 데이터를 디렉터리와 연결된 지정된 루트 인증서로 필터링합니다. 인증서 ID는 `wsc-XXXXXXXXX` 형식입니다.
`RunningMode`	실행 모드를 기준으로 지표 데이터를 WorkSpaces로 필터링합니다. 실행 모드의 형식은 AutoStop 또는 AlwaysOn입니다.
`BundleId`	프로토콜을 기준으로 지표 데이터를 WorkSpaces로 필터링합니다. 번들의 형식은 `wsb-XXXXXXXXXX`입니다.
`ComputeType`	컴퓨팅 유형을 기준으로 지표 데이터를 WorkSpaces로 필터링합니다.
`Protocol`	프로토콜 유형을 기준으로 지표 데이터를 WorkSpaces로 필터링합니다.
`UserName`	사용자 이름을 기준으로 지표 데이터를 WorkSpaces로 필터링합니다. 참고 `UserName`은 다음과 같은 비ASCII 문자로 구성될 수 없습니다. 악센트가 있는 문자: é, à, ö, ñ 등 비라틴어 알파벳 기호: ©️, ®️, €, £, µ, ¥ 등
`ComputerName`	지정된 WorkSpaces로 수신하는 지표 데이터를 필터링합니다. WorkSpaces 컴퓨터 이름에 대한 다양한 형식을 참조하세요.

모니터링 예

다음 예제에서는 AWS CLI 를 사용하여 CloudWatch 경보에 응답하고 디렉터리에서 연결 실패가 발생한 WorkSpaces를 확인하는 방법을 보여줍니다.

CloudWatch 경보에 응답하는 방법

describe-alarms 명령을 사용하여 경보가 적용되는 디렉터리를 결정합니다.


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

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

describe-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가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

CloudWatch 자동 대시보드로 모니터링

Amazon EventBridge를 사용하여 모니터링