# CloudWatch RUM을 사용하도록 모바일 애플리케이션 설정
<a name="CloudWatch-RUM-web-mobile"></a>

모바일 애플리케이션을 모니터링하려면 앱 모니터를 생성한 후 이를 모바일 플랫폼에 맞게 구성한 다음, AWS Distro for OpenTelemetry(ADOT) SDK를 애플리케이션에 통합합니다. 모바일 RUM은 OpenTelemetry Protocol(OTLP)을 사용하여 원격 분석 데이터를 전용 OTLP 엔드포인트로 전송합니다.

## 모바일 플랫폼용 앱 모니터를 생성하려면
<a name="mobile-platform-app-monitor"></a>

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **Application Signals**, **RUM**을 선택합니다.

1. **앱 모니터 추가(Add app monitor)**를 선택합니다.

1. **앱 모니터 이름(App monitor name)**에서 CloudWatch RUM 콘솔 내에서 이 앱 모니터를 식별하는 데 사용할 이름을 입력합니다.

1. **Android** 또는 **iOS**를 플랫폼으로 선택합니다.

1. **데이터 스토리지**에서 RUM OTEL 로그 이벤트 및 스팬의 복사본을 CloudWatch Logs에 저장하도록 선택하고, 보존을 구성할 수 있습니다. 기본적으로 CloudWatch Logs 로그 그룹은 데이터를 30일 동안 보존합니다. CloudWatch Logs 콘솔에서 보존 기간을 조정할 수 있습니다.

1. (선택 사항) **리소스 기반 정책**에서 앱 모니터에 요청을 전송할 수 있는 사용자를 제어하는 리소스 기반 정책을 추가하도록 선택합니다. **퍼블릭 정책 생성**을 선택하면 누구나 요청을 앱 모니터로 전송할 수 있도록 허용하는 리소스 정책이 앱 모니터에 연결됩니다. 자세한 내용은 [CloudWatch RUM에서 리소스 기반 정책 사용](CloudWatch-RUM-resource-policies.md) 섹션을 참조하세요.

1. 샘플링한 사용자 세션의 AWS X-Ray 추적을 사용하려면 **활성 추적**을 선택한 후 **AWS로 내 서비스 추적**을 선택합니다.

   선택이 완료되면 샘플링한 사용자 세션 동안 생성된 OTEL 스팬이 추적됩니다. 그런 다음 RUM 대시보드, X-Ray 트레이스 맵, 트레이스 세부 정보 페이지에서 이러한 세션의 트레이스와 스팬을 볼 수 있습니다. 이러한 사용자 세션은 애플리케이션에 대해 활성화된 후 Application Signals의 클라이언트 페이지로도 표시됩니다.

1. (선택 사항) 앱 모니터에 태그를 추가하려면:

   1. **태그**에서 **새 태그 추가**를 선택합니다.

   1. **키**에 태그의 이름을 입력합니다. **값**에 선택적 값을 추가할 수 있습니다.

   1. 다른 태그를 추가하려면 **새 태그 추가**를 다시 선택합니다.

   자세한 내용은 *AWS 태그 지정 및 태그 편집기 사용 설명서*의 [AWS 리소스 태그 지정](https://docs.aws.amazon.com/tagging/latest/userguide/tagging-resources.html) 섹션을 참조하세요.

1. **앱 모니터 추가(Add app monitor)**를 선택합니다.

1. **샘플 코드** 섹션에서 애플리케이션에 추가할 코드 조각을 복사할 수 있습니다. AWS Distro for OpenTelemetry(ADOT) SDK를 사용하면 **수동 계측**을 선택하여 애플리케이션 코드에서 모니터링을 구성하거나, 구성 변경을 최소화하는 **제로 코드 계측**을 선택할 수 있습니다.

   제로 코드 계측은 구성 파일을 사용하여 원격 분석 수집을 자동으로 초기화하므로, Android 및 iOS 애플리케이션 양쪽 모두에서 가장 간단히 사용할 수 있는 옵션입니다. 수동 계측을 사용하면 초기화 및 구성 프로세스를 더욱 잘 제어할 수 있습니다.

1. **복사(Copy)** 또는 **다운로드(Download)**를 선택한 다음 **완료(Done)**를 선택합니다.

### iOS 애플리케이션 설정
<a name="CloudWatch-RUM-ios-setup"></a>

iOS 애플리케이션의 경우 [AWS Distro for OpenTelemetry(ADOT) iOS SDK](https://github.com/aws-observability/aws-otel-swift)를 통합하여 RUM 모니터링을 활성화할 수 있습니다. SDK는 iOS 16 이상 버전을 지원하며, 일반적인 성능 시나리오를 위한 자동 계측 기능을 제공합니다.

### Android 애플리케이션 설정
<a name="CloudWatch-RUM-android-setup"></a>

Android 애플리케이션의 경우 [AWS Distro for OpenTelemetry(ADOT) Android SDK](https://github.com/aws-observability/aws-otel-android)를 통합하여 RUM 모니터링을 활성화할 수 있습니다. SDK는 자동 계측을 제공하며, 서명된 인증 모델과 서명되지 않은 인증 모델을 둘 다 지원합니다.

## 인증 및 보안
<a name="CloudWatch-RUM-authentication"></a>

모바일 RUM은 SDK에 정의된 대로 유연한 인증 모델을 지원합니다.
+ iOS 애플리케이션은 [AWS Distro for OpenTelemetry(ADOT) iOS SDK](https://github.com/aws-observability/aws-otel-swift)를 사용합니다.
+ Android 애플리케이션은 [AWS Distro for OpenTelemetry(ADOT) Android SDK](https://github.com/aws-observability/aws-otel-android)를 사용합니다.