步驟 2：建立應用程式監控 - Amazon CloudWatch

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

步驟 2：建立應用程式監控

若要開始搭配應用程式使用 CloudWatch RUM，請建立應用程式監視器。建立應用程式監視器時，RUM 會產生一個程式 JavaScript碼片段供您貼到應用程式中。程式碼片段會提取 RUM Web 用戶端程式碼。RUM Web 用戶端會擷取應用程式使用者工作階段中某個百分比的資料，並將其傳送至 RUM。

建立應用程式監控

  1. 請在以下位置開啟 CloudWatch 主控台。 https://console.aws.amazon.com/cloudwatch/

  2. 在瀏覽窗格中，選擇應用程式訊號，RUM。

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

  4. 輸入應用程式的資訊和設定：

    • 針對應用程式監視器名稱，請輸入要在 CloudWatch RUM 主控台中識別此應用程式監視器的名稱。

    • 對於 Application domain (應用程式網域)，輸入您應用程式擁有管理授權的頂層網域名稱。這必須是 URL 網域格式。

      選擇 Include sub domains (包含子網域)，讓應用程式監控也會從頂層網域下的所有子網域收集資料。

  5. 對於 Configure RUM data collection (設定 RUM 資料收集)，指定是否要應用程式監控來收集下列各項：

    • Performance telemetry (效能遙測) – 收集頁面載入和資源載入時間的相關資訊

    • JavaScript 錯誤 — 收集應用程式所引發之未處理 JavaScript 錯誤的相關資訊

    • HTTP errors (HTTP 錯誤) – 收集應用程式所擲回之 HTTP 錯誤的相關資訊

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

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

  6. 如果您希望能夠從取樣的使用者工作階段收集使用者 ID 和工作階段 ID，請選取核取此選項，允許 CloudWatch RUM Web 用戶端設定 Cookie。使用者 ID 是由 RUM 隨機產生。如需詳細資訊，請參閱 CloudWatch RUM 網頁用戶端 Cookie（或類似技術）。

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

  8. 您針對 CloudWatch RUM 收集的使用者資料會保留 30 天，然後刪除。如果您想要在 CloudWatch 記錄中保留 RUM 事件的副本，並設定保留這些副本的時間長度，請選擇核取此選項，將應用程式遙測資料儲存在 [資料儲存體] 底下的 CloudWatch 記錄帳戶中。根據預設，記 CloudWatch 錄檔記錄群組會保留資料 30 天。您可以在 CloudWatch 記錄主控台中調整保留期間。

  9. 對於 Authorization (授權)，請指定要使用新的或現有的 Amazon Cognito 身分集區，還是使用不同的身分提供者。建立新的身分集區是不需要其他設定步驟的最簡單選項。如需詳細資訊，請參閱 步驟 1：授權您的應用程序將數據發送到 AWS。

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

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

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

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

    透過對 R CloudWatch UM Web 用戶端進行其他組態變更，您可以將 X-Ray 追蹤標頭新增至 HTTP 要求，以便 end-to-end 追蹤下游 AWS 受管理服務的使用者工作階段。如需詳細資訊，請參閱 啟用 X-Ray end-to-end 追蹤。

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

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

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

    如需詳細資訊，請參閱標記 AWS 資源。

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

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

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

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