기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# CloudWatch 지표를 사용하여 WorkSpaces 모니터링
WorkSpaces 및 Amazon CloudWatch가 통합되어 성능 지표를 수집하고 분석할 수 있습니다. CloudWatch 콘솔, CloudWatch의 명령줄 인터페이스를 사용하거나 프로그래밍 방식으로 CloudWatch API를 사용하여 이러한 지표를 모니터링할 수 있습니다. CloudWatch에서는 지표에 지정된 임계값에 도달할 때 경보를 설정할 수 있습니다.
CloudWatch와 경보 사용에 대한 자세한 내용은 [Amazon CloudWatch 사용 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/)를 참조하세요.
**사전 조건**
CloudWatch 지표를 가져오려면 `us-east-1` 리전의 `AMAZON` 하위 세트에서 포트 443에서의 액세스를 활성화합니다. 자세한 내용은 [WorkSpaces Personal의 IP 주소 및 포트 요구 사항](workspaces-port-requirements.md) 섹션을 참조하세요.
**Topics**
+ [WorkSpaces 지표](#wsp-metrics)
+ [WorkSpaces 지표 차원](#wsp-metric-dimensions)
+ [모니터링 예](#monitoring_example)
## 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`1 | 연결 시도 횟수. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 |
| `ConnectionSuccess`1 | 성공적 연결 수. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 |
| `ConnectionFailure`1 | 실패한 연결 수. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 |
| `SessionLaunchTime`1 | 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`2 | 디바이스 인증 서명 유효성 검사를 시도한 횟수. | `DirectoryId` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 |
| `TrustedDeviceValidationSuccess`2 | 디바이스 인증 서명 유효성 검사에 성공한 횟수. | `DirectoryId` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 |
| `TrustedDeviceValidationFailure`2 | 디바이스 인증 서명 유효성 검사에 실패한 횟수. | `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` | 평균, 최대, 최소 | 백분율 |
| `GPUUsage` | WorkSpace에서 사용되는 GPU 리소스의 백분율입니다. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 평균, 최대, 최소 | 백분율 |
| `CPUQueueLength` | WorkSpace에서 CPU 시간을 기다리는 스레드 수입니다. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 평균, 최대, 최소 | 개수 |
| `RootVolumeDiskIOQueueLength` | WorkSpace의 루트 볼륨 디스크에서 처리를 대기 중인 보류 중인 I/O 요청 수입니다. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 평균, 최대, 최소 | 개수 |
| `UserVolumeDiskIOQueueLength` | WorkSpace의 사용자 볼륨 디스크에서 처리를 대기 중인 보류 중인 I/O 요청 수입니다. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 평균, 최대, 최소 | 개수 |
| `MemoryPageHardFaults` | WorkSpace의 하드 페이지 장애 발생률입니다. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 평균, 최대, 최소 | 개수/초 |
| `PagingFileUsage` | WorkSpace에서 현재 사용 중인 페이징 파일의 백분율입니다. | `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`3 | 게이트웨이와 클라이언트 간의 트래픽에서 손실된 UDP 패킷의 백분율입니다. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 평균, 최대, 최소, 데이터 샘플 | 백분율 |
| `TCPRetransmissionRate`4 | 게이트웨이에서 클라이언트로 재전송된 TCP 세그먼트의 백분율입니다. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 평균, 최대, 최소, 데이터 샘플 | 백분율 |
| `Bandwidth`4 | 게이트웨이에서 클라이언트로 전송된 데이터 속도(아웃바운드). | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 평균, 최대, 최소, 데이터 샘플 | Kbit/s |
| `BandwidthInbound`4 | 클라이언트에서 게이트웨이(인바운드)로 전송된 데이터의 속도입니다. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 평균, 최대, 최소, 데이터 샘플 | Kbit/s |
| `CongestionWindow`4 | 클라이언트로 흐르는 트래픽에 대한 게이트웨이의 정체 기간의 크기입니다. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 평균, 최대, 최소, 데이터 샘플 | 바이트 |
| `ConnectionDuration`4 | 스트리밍 연결 기간입니다. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 평균, 최대, 최소, 데이터 샘플 | 초 |
| `FramesPerSecond`4 | WorkSpace에서 클라이언트로 초당 전송된 프레임 수입니다. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | 평균, 최대, 최소 | 개수/초 |
1 WorkSpaces는 각 WorkSpace에 대한 연결에 대한 지표를 기록합니다. 이러한 지표는 사용자가 WorkSpaces 클라이언트를 통해 성공적으로 인증한 후 클라이언트가 세션 연결을 시작한 후에 생성됩니다.
2 디렉터리에 대해 신뢰할 수 있는 디바이스 기능이 활성화된 경우 Amazon WorkSpaces는 인증서 기반 인증을 사용하여 디바이스가 신뢰할 수 있는지 확인합니다. 사용자가 WorkSpaces에 액세스하려고 하면 이러한 지표가 생성되어 신뢰할 수 있는 디바이스 인증의 성공 또는 실패를 나타냅니다. 이러한 지표는 Windows 및 macOS 클라이언트 애플리케이션에만 적용됩니다.
3 측정 방향은 기본 프로토콜에 따라 다릅니다.
+ **PCoIP:** 클라이언트에서 게이트웨이로의 손실을 측정합니다.
+ **DCV:** 게이트웨이에서 클라이언트로의 손실을 측정합니다.
4 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 컴퓨터 이름]( https://docs.aws.amazon.com/workspaces/latest/adminguide/wsp-directory-identify-computer.html)에 대한 다양한 형식을 참조하세요. |
## 모니터링 예
다음 예제에서는 AWS CLI 를 사용하여 CloudWatch 경보에 응답하고 디렉터리에서 연결 실패가 발생한 WorkSpaces를 확인하는 방법을 보여줍니다.
**CloudWatch 경보에 응답하는 방법**
1. [describe-alarms](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/describe-alarms.html) 명령을 사용하여 경보가 적용되는 디렉터리를 결정합니다.
```
aws cloudwatch describe-alarms --state-value "ALARM"
{
"MetricAlarms": [
{
...
"Dimensions": [
{
"Name": "DirectoryId",
"Value": "{{directory_id}}"
}
],
...
}
]
}
```
1. [describe-workspaces](https://docs.aws.amazon.com/cli/latest/reference/workspaces/describe-workspaces.html) 명령을 사용하여 지정된 디렉터리의 WorkSpaces 목록을 가져옵니다.
```
aws workspaces describe-workspaces --directory-id {{directory_id}}
{
"Workspaces": [
{
...
"WorkspaceId": "{{workspace1_id}}",
...
},
{
...
"WorkspaceId": "{{workspace2_id}}",
...
},
{
...
"WorkspaceId": "{{workspace3_id}}",
...
}
]
}
```
1. [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html) 명령을 사용하여 디렉터리의 각 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"
}
```