配置 CloudWatch RUM Web 客户端 - Amazon CloudWatch
参数忽略错误配置选项
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

配置 CloudWatch RUM Web 客户端

应用程序可以使用 CloudWatch RUM 生成的其中一个代码段来安装 CloudWatch RUM Web 客户端。生成的代码段支持两种安装方法：作为 JavaScript 模块并通过 NPM，或通过内容分发网络（CDN）。为了获得最佳性能，我们建议使用 NPM 安装方法。有关使用此方法的更多信息，请参阅作为 JavaScript 模块安装。

如果您使用 CDN 安装选项，广告拦截器可能拦截由 CloudWatch RUM 提供的默认 CDN。若用户安装了广告拦截器，它将禁用应用程序监控。因此，我们建议您只在第一次启动 CloudWatch RUM 时使用默认的 CDN。有关此问题缓解方法的更多信息，请参阅检测应用程序。

代码段位于 HTML 文件的 <head> 标签，并且下载 Web 客户端来完成其安装，然后为其监控的应用程序配置 Web 客户端。该代码段是一种自动执行的函数，类似于以下内容。在此示例中，为提高可读性，已省略代码段函数的正文。

<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',
{ /* Configuration Options Here */ }
);
<script>

参数

代码段接受六个参数：

  • 用于在 Web 客户端上运行命令的命名空间，例如 'cwr'

  • 应用程序监控的 ID，例如 '00000000-0000-0000-0000-000000000000'

  • 应用程序版本，例如 '1.0.0'

  • 应用程序监控的 Amazon 区域，例如 'us-west-2'

  • Web 客户端的 URL，例如 'https://client.rum.us-east-1.amazonaws.com/1.0.2/cwr.js'

  • 特定于应用程序的配置选项。有关更多信息，请参阅以下 章节。

忽略错误

CloudWatch RUM Web 客户端会侦听应用程序中发生的所有类型的错误。如果您的应用程序发出了 JavaScript 错误，而您不想在 CloudWatch RUM 控制面板中查看这些错误，则可以配置 CloudWatch RUM Web 客户端以筛选出这些错误，以便在 CloudWatch RUM 控制面板上仅看到相关的错误事件。例如，您可能选择不在控制面板中查看某些 JavaScript 错误，因为您已经确定了这些错误的修复方法，而且这些错误的数量掩盖了其他错误。您可能还想忽略那些您无法修复的错误，因为它们归第三方所有的库所有。

有关如何分析 Web 客户端以筛选出特定 JavaScript 错误的更多信息，请参阅 Web 客户端 Github 文档中的错误中的示例。

配置选项

有关 CloudWatch RUM Web 客户端可用的配置选项信息，请参阅 CloudWatch RUM Web 客户端文档