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

修改代碼片段以配置 CloudWatch RUM Web 客戶端（可選）

您可以在將程式碼片段插入應用程式之前修改程式碼片段，以啟用或停用數個選項。如需詳細資訊，請參閱 CloudWatch RUMWeb 用戶端文件。

有三個您應該務必注意到的組態選項，如這些章節所述。

防止收集可能包含個人信息的資源 URLs

默認情況下， CloudWatch RUMWeb 客戶端配置為記錄應用程序下載URLs的資源。這些資源包括HTML文CSS件，圖像， JavaScript 文件，文件等。對於某些應用程式，URLs可能包含個人識別資訊 (PII)。

如果您的應用程式是這種情況，我們強烈建議您在程式碼片段設定recordResourceUrl: false中設定URLs來停用資源集合，然後再將其插入您的應用程式。

手動記錄頁面檢視

根據預設，Web 用戶端會在網頁首次載入時以及呼叫瀏覽器歷程API記錄時記錄頁面檢視次數。預設頁面 ID 為 window.location.pathname。但在某些情況下，您可以覆寫此行為並檢測應用程式，進而以程式設計方式記錄頁面檢視。這樣做可讓您控制頁面 ID 以及其記錄時間。例如，假URI設具有變數識別碼的 Web 應用程式，例如/entity/123或/entity/456。默認情況下，為每個URI具有不同頁面 ID 與路徑名匹配的頁面視圖事件 CloudWatch RUM生成頁面視圖事件，但您可能希望改用相同的頁面 ID 對它們進行分組。若要完成此操作，請使用 disableAutoPageView 組態停用 Web 客戶端的頁面檢視自動化，然後使用 recordPageView 命令設定所需的頁面 ID。如需詳細資訊，請參閱上 GitHub的應用程式特定組態。

內嵌指令碼範例：

cwr('recordPageView', { pageId: 'entityPageId' });

JavaScript 模塊示例：

awsRum.recordPageView({ pageId: 'entityPageId' });

啟用 X-Ray end-to-end 追蹤

當您創建應用程序監視器時，選擇跟踪我的服務 AWS X-Ray啟用追蹤應用程XMLHttpRequest式監視器取樣的使用者工作階段期間所做的fetch要求。然後，您可以在 CloudWatch RUM儀表板中查看來自這些HTTP請求的跟踪，以及 X-Ray 跟踪地圖和跟踪詳細信息頁面。

根據預設，這些用戶端追蹤不會連線到下游伺服器端追蹤。若要將用戶端追蹤連線至伺服器端 end-to-end 追蹤並啟用追蹤，請在 Web 用戶端true中將addXRayTraceIdHeader選項設定為。這會導致 CloudWatch RUM Web 用戶端將 X-Ray 追蹤標頭新增至HTTP要求。

下列程式碼區塊會顯示新增用戶端追蹤的範例。為了便於閱讀，此範例會省略某些組態選項。

<script>
    (function(n,i,v,r,s,c,u,x,z){...})(
        'cwr',
        '00000000-0000-0000-0000-000000000000',
        '1.0.0',
        'us-west-2',
        'https://client.rum.us-east-1.amazonaws.com/1.0.2/cwr.js',
        {
            enableXRay: true,
            telemetries: [ 
                'errors', 
                'performance',
                [ 'http', { addXRayTraceIdHeader: true } ]
            ]
        }
    );
</script>

如需詳細資訊，請參閱 CloudWatch RUMWeb 用戶端文件