設定 CloudWatch RUM Web 用戶端 - Amazon CloudWatch

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

設定 CloudWatch RUM Web 用戶端

您的應用程式可以使用 CloudWatch RUM 產生的其中一個程式碼片段,安裝 CloudWatch RUM Web 用戶端。產生的程式碼片段支援兩種安裝方法:透過 NPM 作為 JavaScript 模組進行安裝,或者從內容交付網路 (CDN) 安裝。為獲得最佳效能,我們建議您使用 NPM 安裝方法。如需有關使用此方法的詳細資訊,請參閱作為 JavaScript 模組進行安裝

如果您使用 CDN 安裝選項,廣告封鎖程式可能會封鎖 CloudWatch RUM 提供的預設 CDN。這將停用對已安裝廣告封鎖程式的使用者的應用程式監控。因此,我們建議您僅在最初使用 CloudWatch RUM 入門時使用預設 CDN。如需有關此問題緩解方法的詳細資訊,請參閱檢測應用程式

程式碼片段位於 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>

引數

程式碼片段接受六個引數:

  • 用於在 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'

  • 應用程式特定的組態選項。如需詳細資訊,請參閱下一節。

忽略錯誤

CloudWatch RUM Web 用戶端會偵聽應用程式中發生的所有類型錯誤。如果應用程式發出您不想在 CloudWatch RUM 儀表板中檢視的 JavaScript 錯誤,您可以設定 CloudWatch RUM Web 用戶端來篩選掉這些錯誤,讓您在 CloudWatch RUM 儀表板上僅查看相關的錯誤事件。例如,您可能會選擇不檢視儀表板中的某些 JavaScript 錯誤,因為您已經找出修正方法,而且這些錯誤的數量正在掩蓋其他錯誤。您可能還想忽略無法修正的錯誤,因為這些錯誤是由第三方擁有的程式庫所擁有。

如需有關如何檢測 Web 用戶端以篩選掉特定 JavaScript 錯誤的詳細資訊,請參閱 Web 用戶端 Github 文件中的錯誤中的範例。

組態選項

如需 CloudWatch RUM Web 用戶端可用組態選項的相關資訊,請參閱 CloudWatch RUM Web 用戶端文件