配置 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 客户端文档