(可选)步骤 3:手动修改代码段以配置 CloudWatch RUM Web 客户端 - Amazon CloudWatch
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

(可选)步骤 3:手动修改代码段以配置 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。在某些情况下,Web 客户端工具不会记录所需的页面 ID。在这种情况下,必须使用 disableAutoPageView 配置禁用 Web 客户端的页面浏览自动化,并且必须对应用程序进行分析,以采用 recordPageView command 记录页面浏览次数。

启用 X-Ray 端到端跟踪

创建应用程序监控时,选择 Trace my service with Amazon X-Ray(使用 Amazon X-Ray 跟踪我的服务)启用跟踪在应用程序监控采样的用户会话期间发出的 XMLHttpRequestfetch 请求。然后,您可在 CloudWatch RUM 控制面板、CloudWatch ServiceLens 控制台和 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>
警告

如果使用 SigV4 签署请求,则将 CloudWatch RUM Web 客户端配置为向 HTTP 请求添加 X-Ray 跟踪标头可能会导致跨源资源共享 (CORS) 失败或该请求的签名无效。有关更多信息,请参阅 CloudWatch RUM Web 客户端文档。我们强烈建议您在生产环境中添加客户端 X-Ray 跟踪标头之前测试应用程序。

有关更多信息,请参阅 CloudWatch RUM Web 客户端文档