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

# 為 Web 應用程式建立 CloudWatch RUM 應用程式監視器
<a name="CloudWatch-RUM-get-started-create-app-monitor"></a>

若要開始搭配應用程式使用 CloudWatch RUM，您可以建立*應用程式監控*。建立應用程式監視器時，RUM 會產生程式碼片段，供您貼入應用程式。程式碼片段會提取 RUM 用戶端程式碼。RUM 用戶端會從應用程式的使用者工作階段擷取資料，並將其傳送至 RUM。

## 為 Web 平台建立應用程式監控
<a name="web-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. 選取 **Web** 做為平台。

1. 對於**應用程式網域**，輸入您應用程式擁有管理授權的註冊網域名稱。也可以使用萬用字元 `*` 來允許任何子網域或頂層網域 (例如 \*.amazon.com、amazon.\*、\*.amazon.\*)。

1. 對於 **Configure RUM data collection** (設定 RUM 資料收集)，指定是否要應用程式監控來收集下列各項：
   + **Performance telemetry** (效能遙測) – 收集頁面載入和資源載入時間的相關資訊
   + **JavaScript errors** (JavaScript 錯誤) – 收集您應用程式所引發之未處理 JavaScript 錯誤的相關資訊

     您可以選取**取消壓縮 JavaScript 錯誤堆疊追蹤**，以偵錯未壓縮的 JavaScript 錯誤。若要使用此功能，請將來源映射檔案上傳至 Amazon S3 儲存貯體或資料夾，並提供 Amazon S3 URI。啟用後，RUM 將使用這些來源映射，並透過新增未壓縮堆疊追蹤來豐富 JavaScript 錯誤事件。請注意，啟用後，此功能只會處理新的 JavaScript 錯誤事件，無法用於先前收集的資料。如需詳細資訊，請參閱[啟用 JavaScript 錯誤堆疊追蹤的反壓縮功能](CloudWatch-RUM-JavaScriptStackTraceSourceMaps.md)。
   + **HTTP errors** (HTTP 錯誤) – 收集應用程式所擲回之 HTTP 錯誤的相關資訊

   選取這些選項可提供有關應用程式的更多資訊，但也會產生更多 CloudWatch RUM 事件，並因此會產生更多費用。

   如果您沒有選取任何這些項目，則應用程式監控仍會收集工作階段啟動事件和頁面 ID，以便查看有多少使用者正在使用您的應用程式，包括依作業系統類型和版本、瀏覽器類型和版本、裝置類型和位置劃分的明細內容。

1. 如果您希望能夠從取樣的使用者工作階段中收集使用者 ID 和工作階段 ID，則選擇 **Check this option to allow the CloudWatch RUM Web Client to set cookies** (核取此選項以允許 CloudWatch RUM Web 用戶端設定 Cookie)。使用者 ID 是由 RUM 隨機產生。如需詳細資訊，請參閱[CloudWatch RUM Web 用戶端 Cookie (或類似技術)](CloudWatch-RUM-privacy.md#CloudWatch-RUM-cookies)。

1. 對於 **Session samples** (工作階段範例)，輸入會用於收集 RUM 資料的使用者工作階段百分比。預設為 100%。減少此數量會讓您減少資料，但也會降低費用。如需有關 RUM 定價的詳細資訊，請參閱 [RUM 定價](CloudWatch-RUM.md#RUMpricing)。

1. 您為 CloudWatch RUM 收集的最終使用者資料會保留 30 天，然後刪除。如果您想要在 CloudWatch Logs 中保留 RUM 事件的複本，並設定保留這些複本的時間，則請選擇 **Data storage** (資料儲存) 下的 **Check this option to store your application telemetry data in your CloudWatch Logs account** (核取此選項將應用程式遙測資料存放在 CloudWatch Logs 帳戶中)。根據預設，CloudWatch Logs 日誌群組會保留資料 30 天。您可以在 CloudWatch Logs 主控台中調整保留期間。

1. (選用) 選擇將資源型政策新增至應用程式監視器，以控制誰可以將 `PutRumEvents` 請求傳送至應用程式監視器。如果您選擇**建立公有政策**，資源政策會連結到您的應用程式監視器，讓任何人都能將 `PutRumEvents` 請求傳送到應用程式監視器。如需有關此方法的詳細資訊，請參閱 [搭配資源型政策使用 CloudWatch RUM](CloudWatch-RUM-resource-policies.md)。

1. 如果您在上一個步驟中連接以資源為基礎的政策，則不需要使用 AWS 登入資料簽署對 CloudWatch RUM 的請求，而且可以略過設定授權。否則，對於**授權**，請指定要使用新的或現有的 Amazon Cognito 身分池，還是使用不同的身分提供者。建立新的身分集區是不需要其他設定步驟的最簡單選項。如需詳細資訊，請參閱[授權您的 Web 應用程式將資料傳送至 AWS](CloudWatch-RUM-get-started-authorization.md)。

   建立新的 Amazon Cognito 身分集區需要管理許可。如需詳細資訊，請參閱[使用 CloudWatch RUM 的 IAM 政策](CloudWatch-RUM-permissions.md)。

1. (選用) 根據預設，當您將 RUM 程式碼片段新增至應用程式時，Web 用戶端會將 JavaScript 標籤插入以監控應用程式所有頁面之 HTML 程式碼中的使用情況。若要變更此選項，請選擇 **Configure pages** (設定頁面)，然後選擇 **Include only these pages** (僅包含這些頁面) 或 **Exclude these pages** (排除這些頁面)。然後，指定要包含或排除的頁面。若要指定要包含或排除的頁面，請輸入其完整 URL。若要指定其他頁面，請選擇 **Add URL** (新增網址)。

1. 若要啟用應用程式監視器取樣之使用者工作階段的 AWS X-Ray 追蹤，請選擇**主動追蹤**，然後選取**使用 追蹤我的服務 AWS X-Ray。**

   如果您選取此選項，則會追蹤由應用程式監控取樣的使用者工作階段期間所發出的 `XMLHttpRequest` 和 `fetch` 請求。然後，您可以在 RUM 儀表板、X-Ray 追蹤地圖以及追蹤詳細資訊頁面中查看這些使用者工作階段的追蹤和區段。在為應用程式啟用它之後，這些使用者工作階段也會在 [Application Signals](CloudWatch-Application-Monitoring-Sections.md) 中顯示為用戶端頁面。

   透過對 CloudWatch RUM Web 用戶端進行其他組態變更，您可以將 X-Ray 追蹤標頭新增至 HTTP 請求，以啟用end-to-end追蹤。 AWS 如需詳細資訊，請參閱[啟用 X-Ray 端對端追蹤](CloudWatch-RUM-modify-snippet.md#CloudWatch-RUM-xraytraceheader)。

1. (選用) 若要新增標籤至應用程式監控，請選擇 **Tags** (標籤)、**Add new tag** (新增標籤)。

   之後，在 **Key** (索引鍵) 中，輸入標籤的名稱。您可以在 **Value (值)** 中為標籤新增選用值。

   若要新增另一個標籤，請再次選擇 **Add new tag** (新增標籤)。

   如需詳細資訊，請參閱[標記 AWS 資源](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)。

1. 選擇 **Add app monitor** (新增應用程式監控)。

1. 在 **Sample code** (範本程式碼) 區段中，您可以複製程式碼片段，以便新增至應用程式中。建議您選擇 **JavaScript** 或 **TypeScript**，並使用 NPM 安裝 CloudWatch RUM Web 用戶端，作為 JavaScript 模組。

   或者，您可以選擇 **HTML** 以使用內容交付網路 (CDN) 安裝 CloudWatch RUM Web 用戶端。使用 CDN 的缺點是 Web 用戶端通常會遭廣告封鎖程式封鎖。

1. 選擇 **Copy** (複製) 或 **Download** (下載)，然後選擇 **Done** (完成)。