사용자 지정 지표 및 CloudWatch 및 CloudWatch Evidently로 전송할 수 있는 확장 지표

기본적으로 RUM 앱 모니터는 지표를 CloudWatch로 전송합니다. 이러한 기본 지표와 차원은 CloudWatch RUM을 사용하여 수집할 수 있는 CloudWatch 지표에 나열되어 있습니다.

앱 모니터를 설정하여 지표를 내보낼 수도 있습니다. 앱 모니터는 확장 지표, 사용자 지정 지표 또는 두 가지 모두를 전송할 수 있습니다. CloudWatch나 CloudWatch Evidently, 또는 두 가지 모두로 전송할 수 있습니다.

사용자 지정 지표 - 사용자 지정 지표는 사용자가 정의하는 지표입니다. 사용자 지정 지표를 사용하면 모든 지표 이름과 네임스페이스를 사용할 수 있습니다. 지표를 도출하기 위해 사용자 지정 이벤트, 기본 제공 이벤트, 사용자 지정 속성 또는 기본 속성을 사용할 수 있습니다.

사용자 지정 지표를 CloudWatch와 CloudWatch Evidently 모두에 전송할 수 있습니다.
확장 지표 - 기본 CloudWatch RUM 지표를 CloudWatch Evidently로 전송하여 Evidently 실험에 사용할 수 있습니다. 또한 기본 CloudWatch RUM 지표를 추가 측정기준과 함께 CloudWatch로 전송할 수도 있습니다. 이렇게 하면 이러한 지표를 통해 보다 세분화된 보기를 얻을 수 있습니다.

사용자 지정 지표

사용자 지정 지표를 보내려면 AWS API를 사용하거나 콘솔 대신 AWS CLI를 사용해야 합니다. AWS API 사용에 대한 자세한 내용은 PutRumMetricsDestination 및 BatchCreateRumMetricDefinitions를 참조하세요.

하나의 대상에 포함할 수 있는 확장 지표 및 사용자 지정 지표 정의의 최대 개수는 2,000개입니다. 각 대상에 보내는 각 사용자 지정 지표 또는 확장 지표에 대해 측정기준 이름과 측정기준 값의 각 조합이 이 한도에 포함됩니다. 이는 요금을 위한 CloudWatch 사용자 지정 지표로도 계산됩니다.

다음 예에서는 사용자 지정 이벤트에서 파생된 사용자 지정 지표를 만드는 방법을 보여줍니다. 다음은 사용되는 사용자 지정 이벤트의 예입니다.


cwr('recordEvent', {
    type: 'my_custom_event', 
    data: {
        location: 'IAD', 
        current_url: 'amazonaws.com', 
        user_interaction: {
            interaction_1 : "click",
            interaction_2 : "scroll"
        }, 
        visit_count:10
    }
})

이 사용자 지정 이벤트가 주어지면 Chrome 브라우저에서 amazonaws.com URL에 대한 방문 횟수를 계산하는 사용자 지정 지표를 만들 수 있습니다. 다음 정의는 계정의 RUM/CustomMetrics/PageVisits 네임스페이스에 AmazonVisitsCount라는 지표를 생성합니다.


{
    "AppMonitorName":"customer-appMonitor-name",
    "Destination":"CloudWatch",
    "MetricDefinitions":[
        {
            "Name":"AmazonVisitsCount",
            "Namespace":"PageVisit",
            "ValueKey":"event_details.visit_count",
            "UnitLabel":"Count",
            "DimensionKeys":{
                "event_details.current_url": "URL"
            },
            "EventPattern":"{\"metadata\":{\"browserName\":[\"Chrome\"]},\"event_type\":[\"my_custom_event\"],\"event_details\": {\"current_url\": [\"amazonaws.com\"]}}" 
        }
    ]
}

확장 지표

확장 지표를 설정하면 다음 중 하나 또는 둘 다를 수행할 수 있습니다.

기본 CloudWatch RUM 지표를 CloudWatch Evidently로 전송하여 Evidently 실험에 사용할 수 있습니다. PerformanceNavigationDuration, PerformanceResourceDuration, WebVitalsCumulativeLayoutShift, WebVitalsFirstInputDelay 및 WebVitalsLargestContentfulPaint 지표만 Evidently로 전송할 수 있습니다.
지표가 보다 세분화된 보기를 제공하도록 기본 CloudWatch RUM 지표를 추가 측정기준과 함께 CloudWatch로 전송합니다. 예를 들어 사용자가 사용하는 특정 브라우저에 대한 지표나 특정 지리적 위치의 사용자에 대한 지표를 볼 수 있습니다.

기본 CloudWatch RUM 지표에 대한 자세한 내용은 CloudWatch RUM을 사용하여 수집할 수 있는 CloudWatch 지표 섹션을 참조하세요.

하나의 대상에 포함할 수 있는 확장 지표 및 사용자 지정 지표 정의의 최대 개수는 2,000개입니다. 각 대상으로 전송하는 각 확장 또는 사용자 지정 지표에 대해 측정기준 이름과 측정기준 값의 각 조합이 이 한도에 대한 확장 지표 수 계산에 포함됩니다. 이는 요금을 위한 CloudWatch 사용자 지정 지표로도 계산됩니다.

CloudWatch로 확장 지표를 전송할 때 CloudWatch RUM 콘솔을 사용하여 확장 지표에 대한 CloudWatch 경보를 생성할 수 있습니다.

확장 지표는 CloudWatch 사용자 지정 지표로 요금이 부과됩니다. 자세한 내용은 Amazon CloudWatch 요금을 참조하십시오.

앱 모니터에서 전송할 수 있는 모든 지표 이름에 대한 확장 지표에 다음과 같은 차원이 지원됩니다. 이러한 지표 이름은 CloudWatch RUM을 사용하여 수집할 수 있는 CloudWatch 지표에 나열되어 있습니다.

BrowserName

차원 값의 예: Chrome, Firefox, Chrome Headless
CountryCode 이 차원은 2자리 코드와 함께 ISO-3166 형식을 사용합니다.

차원 값의 예: US, JP, DE
DeviceType

차원 값의 예: desktop, mobile, tablet, embedded
FileType

차원 값의 예: Image, Stylesheet
OSName

차원 값의 예: Linux, Windows, iOS, Android
PageId

콘솔을 사용하여 확장 지표 설정

콘솔을 사용하여 CloudWatch로 확장 지표를 전송하려면 다음 단계를 사용하세요.

CloudWatch Evidently로 확장 지표를 전송하려면 콘솔 대신 AWS API 또는 AWS CLI를 사용해야 합니다. AWS API를 사용하여 확장 지표를 CloudWatch 또는 Clariby로 전송하는 방법에 대한 자세한 내용은 PutRumMetricsDestination 및 BatchCreateRumMetricDefinitions를 참조하세요.

콘솔을 사용하여 RUM 확장 지표를 CloudWatch로 전송하도록 앱 모니터를 설정하려면 다음을 수행하세요.

https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.
탐색 창에서 Application Signals, RUM을 선택합니다.
List view(목록 보기)를 선택한 다음 지표를 전송할 앱 모니터의 이름을 선택합니다.
Configuration(구성) 탭을 선택한 다음 RUM extended metrics(RUM 확장 지표)를 선택합니다.
Send metrics(지표 전송)를 선택합니다.
추가 차원과 함께 전송할 지표 이름을 하나 이상 선택합니다.
이러한 지표의 차원으로 사용할 요소를 하나 이상 선택합니다. 선택 시 해당 항목이 생성하는 확장 지표 수가 Number of extended metrics(확장 지표 수)에 표시됩니다.

이 숫자는 선택한 지표 이름의 수에 생성한 서로 다른 차원의 수를 곱하여 계산됩니다. 이 숫자는 요금이 부과되는 사용자 지정 지표의 수를 나타냅니다. CloudWatch 요금에 대한 자세한 내용은 Amazon CloudWatch 요금을 참조하세요.
1. 페이지 ID를 차원으로 사용하여 지표를 전송하려면 Browse for page ID(페이지 ID 찾아보기)를 선택한 다음 사용할 페이지 ID를 선택합니다.
2. 디바이스 유형을 차원으로 사용하여 지표를 전송하려면 Desktop devices(데스크톱 디바이스) 또는 Mobile and tablets(모바일 및 태블릿)를 선택합니다.
3. 운영 체제를 차원으로 사용하여 지표를 전송하려면 Operating system(운영 체제)에서 운영 체제를 하나 이상 선택합니다.
4. 브라우저 유형을 차원으로 사용하여 지표를 전송하려면 Browsers(브라우저)에서 브라우저를 하나 이상 선택합니다.
5. 지리적 위치를 차원으로 사용하여 지표를 전송하려면 Locations(위치)에서 위치를 하나 이상 선택합니다.
  
  이 앱 모니터가 지표를 보고한 위치만 선택할 수 있는 목록에 표시됩니다.
선택을 마치면 Send metrics(지표 전송)를 선택합니다.
(선택 사항) Extended metrics(확장 지표) 목록에서 지표 중 하나를 관찰하는 경보를 생성하려면 해당 지표 행에서 Create alarm(경보 생성)을 선택합니다.

CloudWatch 경보에 대한 일반적인 정보는 Amazon CloudWatch 경보 사용 섹션을 참조하세요. CloudWatch RUM 확장 지표에 대한 경보를 설정하는 방법에 대한 자습서는 자습서: 확장 지표 생성 및 경보 설정 섹션을 참조하세요.

확장 지표 전송 중지

콘솔을 사용하여 확장 지표 전송을 중지하려면 다음을 수행하세요.

https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.
탐색 창에서 Application Signals, RUM을 선택합니다.
List view(목록 보기)를 선택한 다음 지표를 전송할 앱 모니터의 이름을 선택합니다.
Configuration(구성) 탭을 선택한 다음 RUM extended metrics(RUM 확장 지표)를 선택합니다.
전송을 중지할 지표 이름과 차원 조합을 하나 이상 선택합니다. 그런 다음 Actions(작업), Delete(삭제)를 선택합니다.

자습서: 확장 지표 생성 및 경보 설정

이 자습서에서는 CloudWatch로 전송할 확장 지표를 설정하는 방법과 해당 지표에 대한 경보를 설정하는 방법을 설명합니다. 이 자습서에서는 Chrome 브라우저에서 JavaScript 오류를 추적하는 지표를 생성합니다.

이 확장 지표를 설정하고 이에 대한 경보를 설정하려면 다음을 수행하세요.

https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.
탐색 창에서 Application Signals, RUM을 선택합니다.
List view(목록 보기)를 선택한 다음 지표를 전송할 앱 모니터의 이름을 선택합니다.
Configuration(구성) 탭을 선택한 다음 RUM extended metrics(RUM 확장 지표)를 선택합니다.
Send metrics(지표 전송)를 선택합니다.
JSErrorCount를 선택합니다.
Browsers(브라우저)에서 Chrome을 선택합니다.

JSErrorCount와 Chrome의 이러한 조합은 하나의 확장 지표를 CloudWatch로 전송합니다. 지표는 Chrome 브라우저를 사용하는 사용자 세션에 대해서만 JavaScript 오류를 계산합니다. 지표 이름은 JsErrorCount이고 차원 이름은 Browser(브라우저)입니다.
Send metrics(지표 전송)를 선택합니다.
Extended metrics(확장 지표) 목록에서 Name(이름) 아래에 JsErrorCount가 표시되고 BrowserName 아래에 Chrome이 표시되는 행에서 Create alarm(경보 생성)을 선택합니다.
Specify metric and conditions(지표 및 조건 지정)에서 Metric name(지표 이름) 및 BrowserName 필드가 올바른 값으로 미리 채워져 있는지 확인합니다.
Statistic(통계)에서 경보에 사용할 통계를 선택합니다. 이러한 유형의 계산 지표에는 Average(평균)가 적합합니다.
기간에 대해 5분을 선택합니다.
조건(Conditions)에서 다음을 수행하십시오:
- Static(정적)을 선택합니다.
- Greater(보다 큼)를 선택하여 오류 수가 지정하려는 임곗값보다 높을 때 경보가 ALARM 상태로 전환되도록 지정합니다.
- than...(큼) 아래에 경보 임계값의 숫자를 입력합니다. 5분 동안 오류 수가 이 숫자를 초과하면 경보가 ALARM 상태로 전환됩니다.
(선택 사항) 기본적으로 오류 수가 5분 동안 설정한 임곗값 숫자를 초과하는 즉시 경보가 ALARM 상태로 전환됩니다. 이 숫자가 5분 이상 초과되는 경우에만 경보가 ALARM 상태로 전환되도록 필요에 따라 이를 변경할 수 있습니다.

이렇게 하려면 Additional configuration(추가 구성)을 선택한 다음 Datapoints to alarm(경보를 보낼 데이터 포인트)에서 경보를 트리거하기 위해 오류 번호가 임계값을 초과해야 하는 5분 기간 수를 지정합니다. 예를 들어, 두 개의 연속된 5분 기간이 임계값을 초과하는 경우에만 경보가 트리거되도록 2개 중 2개를 선택하거나, 3개의 연속된 5분 기간 중 2개가 임계값을 초과하는 경우 경보가 트리거되도록 3개 중 2개를 선택할 수 있습니다.

이러한 유형의 경보 평가에 대한 자세한 내용은 경보 평가 섹션을 참조하세요.
Next(다음)를 선택합니다.
Configure actions(작업 구성)에서 경보가 경보 상태로 전환될 때 수행할 작업을 지정합니다. Amazon SNS로 알림을 받으려면 다음을 수행하세요.
- 알림 추가를 선택합니다.
- 경보 내를 선택합니다.
- 기존의 SNS 주제를 선택하거나 새로 생성합니다. 새로 생성하는 경우 이름을 지정하고 이메일 주소를 하나 이상 추가합니다.
Next(다음)를 선택합니다.
경보의 이름과 설명(선택 사항)을 입력하고 Next(다음)를 선택합니다.
세부 정보를 검토하고 Create alarm(경보 생성)을 선택합니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

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

문서 규칙

CloudWatch RUM을 사용하여 수집할 수 있는 CloudWatch 지표

CloudWatch RUM을 통한 데이터 보호 및 데이터 프라이버시