기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 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`1 | 정상 상태를 반환한 WorkSpaces의 수. | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 | | `Unhealthy`1 | 비정상 상태를 반환한 WorkSpaces의 수. | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 | | `ConnectionAttempt`2 | 연결 시도 횟수. | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 | | `ConnectionSuccess`2 | 성공적 연결 수. | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 | | `ConnectionFailure`2 | 실패한 연결 수. | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 | | `SessionLaunchTime`2,6 | WorkSpaces 세션을 시작하는 데 소요된 시간. | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 평균, 합계, 최대, 최소, 데이터 샘플 | 초(시간) | | `InSessionLatency`2,6 | WorkSpaces 클라이언트와 WorkSpace 간 왕복 시간. | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 평균, 합계, 최대, 최소, 데이터 샘플 | 밀리초(시간) | | `SessionDisconnect`2,6 | 사용자가 시작한 연결, 실패한 연결을 포함하여 닫힌 연결의 수. | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 | | `UserConnected`3 | 사용자가 연결되어 있는 WorkSpaces의 수. | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 | | `Stopped` | 중단된 WorkSpaces의 수. | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 | | `Maintenance`4 | 유지보수 중인 WorkSpaces의 수. | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 | | `TrustedDeviceValidationAttempt`5,6 | 디바이스 인증 서명 유효성 검사를 시도한 횟수. | `DirectoryId` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 | | `TrustedDeviceValidationSuccess`5,6 | 디바이스 인증 서명 유효성 검사에 성공한 횟수. | `DirectoryId` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 | | `TrustedDeviceValidationFailure`5,6 | 디바이스 인증 서명 유효성 검사에 실패한 횟수. | `DirectoryId` | 평균, 합계, 최대, 최소, 데이터 샘플 | 개수 | | `TrustedDeviceCertificateDaysBeforeExpiration`6 | 디렉터리와 연결된 루트 인증서가 만료되기까지 남은 일수. | `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` | 평균, 최대, 최소 | 백분율 | | `UDPPacketLossRate`7 | 클라이언트와 게이트웨이 간에 삭제된 패킷의 백분율. | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 평균, 최대, 최소, 데이터 샘플 | 백분율 | | `UpTime` | WorkSpace의 마지막 재부팅 이후의 시간. | `DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName` | 평균, 최대, 최소, 데이터 샘플 | 초 | 1 WorkSpaces가 WorkSpace에 상태 요청을 주기적으로 전송합니다. WorkSpace에서 이러한 요청에 응답할 경우 `Available`로 표시되고 이러한 요청에 응답하지 않을 경우에는 `Unhealthy`로 표시됩니다. 이러한 지표는 개별 WorkSpaces 수준에서 사용할 수 있으며 조직의 모든 WorkSpaces에 대해서도 집계됩니다. 2 WorkSpaces가 각 WorkSpace에서 실행된 연결에 대한 지표를 기록합니다. 이러한 지표는 사용자가 WorkSpaces 클라이언트를 통해 성공적으로 인증한 후 발생하며 그 후 클라이언트가 세션을 시작합니다. 이러한 지표는 개별 WorkSpace 수준에서 사용 가능하며 디렉터리의 모든 WorkSpaces에 대해서도 집계됩니다. 3 WorkSpaces가 WorkSpace에 연결 상태 요청을 주기적으로 전송합니다. 사용자가 세션을 능동적으로 사용하고 있을 경우 연결된 상태로 보고됩니다. 이러한 지표는 개별 WorkSpaces 수준에서 사용할 수 있으며 조직의 모든 WorkSpaces에 대해서도 집계됩니다. 4 이 지표는 AutoStop 실행 모드가 구성된 WorkSpaces에 적용됩니다. WorkSpaces에 유지관리가 활성화된 경우 이 지표는 현재 유지보수 중인 WorkSpaces 수를 캡처합니다. 이러한 지표는 개별 WorkSpace 수준에서 사용할 수 있으며, WorkSpace가 유지보수로 전환된 때와 제거된 때를 설명합니다. 5 디렉터리에 신뢰할 수 있는 디바이스 기능이 활성화된 경우 Amazon WorkSpaces는 인증서 기반 인증을 사용하여 디바이스를 신뢰할 수 있는지 확인합니다. 사용자가 WorkSpaces에 액세스하려고 하면 이러한 지표가 생성되어 신뢰할 수 있는 디바이스 인증의 성공 또는 실패를 나타냅니다. 이러한 지표는 개별 디렉터리별 수준에서 사용할 수 있으며, Amazon WorkSpaces Windows 및 macOS 클라이언트 애플리케이션에서만 사용할 수 있습니다. 6 WorkSpaces Web Access에서는 사용할 수 없습니다. 7 이 지표는 평균 패킷 손실을 측정합니다. + **PCoIP**: 클라이언트에서 게이트웨이로의 평균 UDP 패킷 손실을 측정합니다. **참고** 이는 게이트웨이에서 측정됩니다. + **DCV**: 게이트웨이에서 클라이언트로의 UDP 패킷 손실을 측정합니다. **참고** 이는 게이트웨이에서 측정됩니다. ## 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" } ```