配置 CloudWatch RUM Web 客戶端 - Amazon CloudWatch

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

配置 CloudWatch RUM Web 客戶端

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

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

代碼片段位於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 RUMWeb 客戶端會監聽應用程序中發生的所有類型的錯誤。如果您的應用程式發出您不想在 CloudWatch RUM儀表板中檢視的 JavaScript 錯誤,您可以設定 CloudWatch RUM Web 用戶端來篩選出這些錯誤,以便只在 CloudWatch RUM儀表板上看到相關的錯誤事件。例如,您可能會選擇不檢視儀表板中的某些 JavaScript錯誤,因為您已經識別錯誤的修正程式,而這些錯誤的數量正在遮罩其他錯誤。您可能還想忽略無法修正的錯誤,因為這些錯誤是由第三方擁有的程式庫所擁有。

有關如何檢測 Web 客戶端以過濾掉特定 JavaScript 錯誤的詳細信息,請參閱 Web 客戶端 Github 文檔中的錯誤中的示例。

組態選項

有關 CloudWatch RUM Web 客戶端可用配置選項的更多信息,請參閱 CloudWatch RUMWeb 客戶端文檔