CloudWatch RUM 웹 클라이언트 구성 - Amazon CloudWatch
인수오류 무시구성 옵션

CloudWatch RUM 웹 클라이언트 구성

애플리케이션은 CloudWatch RUM에서 생성한 코드 조각 중 하나를 사용하여 CloudWatch RUM 웹 클라이언트를 설치할 수 있습니다. 생성된 조각은 NPM을 통한 JavaScript 모듈이나 콘텐츠 전송 네트워크(CDN)의 두 가지 설치 방법을 지원합니다. 최상의 성능을 내려면 NPM 설치 방법을 사용하는 것이 좋습니다. 이 방법의 사용에 대한 자세한 내용은 JavaScript 모듈로 설치를 참조하세요.

CDN 설치 옵션을 사용하는 경우 광고 차단기가 CloudWatch RUM에서 제공하는 기본 CDN을 차단할 수 있습니다. 이렇게 하면 광고 차단기를 설치한 사용자에 대해 애플리케이션 모니터링이 사용 중지됩니다. 따라서 CloudWatch RUM이 포함된 초기 온보딩에만 기본 CDN을 사용하는 것이 좋습니다. 이 문제를 완화하는 방법에 대한 자세한 내용은 애플리케이션 계측을 참조하세요.

코드 조각은 HTML 파일의 <head> 태그에 위치하고, 웹 클라이언트를 다운로드한 다음 모니터링 중인 애플리케이션에 대한 웹 클라이언트를 구성하여 웹 클라이언트를 설치합니다. 코드 조각은 다음과 비슷하게 보이는 자체 실행 함수입니다. 이 예제에서는 가독성을 위해 코드 조각 함수의 본문이 생략되었습니다.

<script>
(function(n,i,v,r,s,c,u,x,z){...})(
'cwr',
'00000000-0000-0000-0000-000000000000',
'1.0.0',
'us-west-2',
'https://client.rum.us-east-1.amazonaws.com/1.0.2/cwr.js',
{ /* Configuration Options Here */ }
);
<script>

인수

코드 조각은 6개의 인수를 허용합니다.

  • 웹 클라이언트에서 명령을 실행하기 위한 네임스페이스(예: 'cwr')

  • 앱 모니터의 ID(예: '00000000-0000-0000-0000-000000000000')

  • 애플리케이션 버전(예: '1.0.0')

  • 앱 모니터의 AWS 리전(예: 'us-west-2')

  • 웹 클라이언트 URL(예: 'https://client.rum.us-east-1.amazonaws.com/1.0.2/cwr.js')

  • 애플리케이션별 구성 옵션 자세한 내용은 다음 섹션을 참조하세요.

오류 무시

CloudWatch RUM 웹 클라이언트는 애플리케이션에서 발생하는 모든 유형의 오류를 수신합니다. CloudWatch RUM 대시보드에 표시하지 않으려는 JavaScript 오류가 애플리케이션에서 전달되는 경우, 이러한 오류를 필터링하고 CloudWatch RUM 대시보드에 관련 오류 이벤트만 표시하도록 CloudWatch RUM 웹 클라이언트를 구성할 수 있습니다. 예를 들어 일부 JavaScript 오류에 대한 수정 사항을 이미 식별했고 방대한 오류의 양으로 인해 다른 오류가 가려지는 경우 대시보드에 일부 JavaScript 오류를 표시하지 않도록 선택할 수 있습니다. 또한 서드 파티가 소유한 라이브러리의 소유이기 때문에 수정할 수 없는 오류를 무시할 수도 있습니다.

특정 JavaScript 오류를 필터링하도록 웹 클라이언트를 구성하는 방법에 대한 자세한 내용은 웹 클라이언트 Github 설명서에서 오류의 예를 참조하세요.

구성 옵션

CloudWatch RUM 웹 클라이언트에서 사용할 수 있는 구성 옵션에 대한 자세한 내용은 CloudWatch RUM 웹 클라이언트 설명서를 참조하세요.