# 设置移动应用程序以使用 CloudWatch RUM
<a name="CloudWatch-RUM-web-mobile"></a>

要监控移动应用程序，需要创建应用程序监视器，将其配置为移动平台，然后将适用于 OpenTelemetry 的 AWS Distro（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 X-Ray 跟踪服务**。

   如果选中，则会跟踪在采样用户会话期间生成的 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. 在**示例代码**部分，您可以复制代码片段以添加到应用程序当中。使用适用于 OpenTelemetry 的 AWS Distro（ADOT）SDK，您可以选择**手动埋点**（在应用程序代码中配置监控），也可以选择**零代码埋点**（所需的配置更改极少）。

   对于 Android 和 iOS 应用程序，零代码埋点是最简单的选项，因为它会使用配置文件自动初始化遥测收集。手动埋点可以更好地控制初始化和配置过程。

1. 选择 **Copy**（复制）或 **Download**（下载），然后选择 **Done**（完成）。

### iOS 应用程序设置
<a name="CloudWatch-RUM-ios-setup"></a>

对于 iOS 应用程序，请集成[适用于 OpenTelemetry 的 AWS Distro（ADOT）iOS SDK](https://github.com/aws-observability/aws-otel-swift)，启用 RUM 监控。该 SDK 支持 iOS 16 及更高版本，并为常见性能场景提供自动埋点。

### Android 应用程序设置
<a name="CloudWatch-RUM-android-setup"></a>

对于 Android 应用程序，请集成[适用于 OpenTelemetry 的 AWS Distro（ADOT）Android SDK](https://github.com/aws-observability/aws-otel-android)，启用 RUM 监控。该 SDK 提供自动埋点，并支持签名和未签名的身份验证模型。

## 身份验证和安全
<a name="CloudWatch-RUM-authentication"></a>

移动 RUM 支持其 SDK 中定义的灵活身份验证模型。
+ iOS 应用程序使用[适用于 OpenTelemetry 的 AWS Distro（ADOT）iOS SDK](https://github.com/aws-observability/aws-otel-swift)。
+ Android 应用程序使用[适用于 OpenTelemetry 的 AWS Distro（ADOT）Android SDK](https://github.com/aws-observability/aws-otel-android)。