本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定行動應用程式以使用 CloudWatch RUM
<a name="CloudWatch-RUM-web-mobile"></a>

若要監控行動應用程式，您可以建立應用程式監視器、將其設定為行動平台，並將 AWS Distro for OpenTelemetry (ADOT) SDK 整合到您的應用程式中。Mobile 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. 若要新增另一個標籤，請再次選擇 **Add new tag** (新增標籤)。

   如需詳細資訊，請參閱[《標記 AWS 和標籤編輯器使用者指南》中的標記資源](https://docs.aws.amazon.com/tagging/latest/userguide/tagging-resources.html)。 *AWS *

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 監控。開發套件支援 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 監控。開發套件提供自動檢測，並支援已簽章和未簽章的身分驗證模型。

## 身分驗證和安全性
<a name="CloudWatch-RUM-authentication"></a>

Mobile RUM 支援其 SDKs中定義的彈性身分驗證模型。
+ iOS 應用程式使用 [AWS Distro for OpenTelemetry (ADOT) iOS 開發套件](https://github.com/aws-observability/aws-otel-swift)。
+ Android 應用程式使用 [AWS Distro for OpenTelemetry (ADOT) Android SDK](https://github.com/aws-observability/aws-otel-android)。