

# 配置 CloudWatch RUM Web 客户端
<a name="CloudWatch-RUM-configure-client"></a>

应用程序可以使用 CloudWatch RUM 生成的其中一个代码段来安装 CloudWatch RUM Web 客户端。生成的代码段支持两种安装方法：作为 JavaScript 模块并通过 NPM，或通过内容分发网络（CDN）。为了获得最佳性能，我们建议使用 NPM 安装方法。有关使用此方法的更多信息，请参阅[作为 JavaScript 模块安装](https://github.com/aws-observability/aws-rum-web/blob/main/docs/npm_installation.md)。

如果您使用 CDN 安装选项，广告拦截器可能拦截由 CloudWatch RUM 提供的默认 CDN。若用户安装了广告拦截器，它将禁用应用程序监控。因此，我们建议您只在第一次启动 CloudWatch RUM 时使用默认的 CDN。有关此问题缓解方法的更多信息，请参阅[检测应用程序](https://github.com/aws-observability/aws-rum-web/blob/main/docs/cdn_installation.md#instrument-the-application)。

代码段位于 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>
```

## 参数
<a name="CloudWatch-RUM-configure-client-arguments"></a>

代码段接受六个参数：
+ 用于在 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'`
+ 特定于应用程序的配置选项。有关更多信息，请参阅下文。

## 忽略错误
<a name="CloudWatch-RUM-configure-ignore-errors"></a>

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

有关如何分析 Web 客户端以筛选出特定 JavaScript 错误的更多信息，请参阅 Web 客户端 Github 文档中的[错误](https://github.com/aws-observability/aws-rum-web/blob/main/docs/configuration.md#errors)中的示例。

## 配置选项
<a name="CloudWatch-RUM-configure-options"></a>

有关 CloudWatch RUM Web 客户端可用的配置选项信息，请参阅 [CloudWatch RUM Web 客户端文档](https://github.com/aws-observability/aws-rum-web/blob/main/docs/configuration.md)