

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定 CloudWatch RUM Web 用戶端
<a name="CloudWatch-RUM-configure-client"></a>

您的應用程式可以使用 CloudWatch RUM 產生的其中一個程式碼片段，安裝 CloudWatch RUM Web 用戶端。產生的程式碼片段支援兩種安裝方法：透過 NPM 作為 JavaScript 模組進行安裝，或者從內容交付網路 (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 用戶端，來安裝 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'`
+ 應用程式監視器 AWS 的區域，例如 `'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 用戶端會偵聽應用程式中發生的所有類型錯誤。如果應用程式發出您不想在 CloudWatch RUM 儀表板中檢視的 JavaScript 錯誤，您可以設定 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)