Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

修改代码片段以配置 CloudWatch RUM Web 客户端（可选）

您可以在代码段插入应用程序之前对其进行修改，以激活或停用多个选项。有关更多信息，请参阅 CloudWatch RUM Web 客户端文档。

正如本章节中所述，您必须注意三个配置选项。

防止收集可能包含个人信息的资源 URL

预设情况下，CloudWatch RUM Web 客户端配置为记录应用程序下载的资源的 URL。这些资源包括 HTML 文件、图像、CSS 文件、JavaScript 文件等。对于某些应用程序，URL 可能包含个人身份信息（PII）。

如果应用程序属于这种情况，则强烈建议您通过在代码段配置中设置 recordResourceUrl: false 以禁用收集资源 URL，然后再将其插入到应用程序中。

手动记录页面浏览次数

默认情况下，Web 客户端会在页面首次加载以及调用浏览器的历史 API 时记录页面浏览次数。默认页面 ID 为 window.location.pathname。但在某些情况下，您可能需要覆盖此行为并利用应用程序以编程方式记录页面浏览量。这样您可以控制页面 ID 及其记录时间。例如，假设一个 Web 应用程序的 URI 带有变量标识符，例如 /entity/123 或 /entity/456。默认情况下，CloudWatch RUM 会为每个具有与路径名匹配的不同页面 ID 的 URI 生成页面浏览事件，但您可能希望改用相同的页面 ID 对它们进行分组。为此，请使用 disableAutoPageView 配置禁用 Web 客户端的页面浏览自动化，然后使用 recordPageView 命令设置所需的页面 ID。有关更多信息，请参阅 GitHub 上的特定于应用程序的配置。

嵌入式脚本示例：

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

JavaScript 模块示例：

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

启用 X-Ray 端到端跟踪

在创建应用程序监控时，选择 Trace my service with Amazon X-Ray（使用跟踪我的服务）将启用跟踪在应用程序监控采样的用户会话期间发出的 XMLHttpRequest 和 fetch 请求。然后，您可在 CloudWatch RUM 控制面板、X-Ray 跟踪地图和跟踪详细信息页面查看来自这些 HTTP 请求的跟踪。

默认情况下，这些客户端跟踪未连接到下游服务器端跟踪。要将客户端跟踪连接到服务器端跟踪并启用端到端跟踪，请在 Web 客户端中将 addXRayTraceIdHeader 选项设置为 true。这将导致 CloudWatch RUM Web 客户端向 HTTP 请求添加 X-Ray 跟踪标头。

下面的代码块展示了添加客户端跟踪的示例。为提高可读性，此示例中省略了一些配置选项。

<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 RUM Web 客户端文档