本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
您可以傳送至 CloudWatch 和 CloudWatch Evidently 的自訂指標和延伸指標
依預設,RUM 應用程式監視器會將指標傳送至 CloudWatch。這些預設指標和維度會列於您可以使用 CloudWatch RUM 收集的 CloudWatch 指標當中。
您也可以設定應用程式監視器來匯出指標。應用程式監視器可以傳送延伸指標、自訂指標或兩者。它可以將其傳送至 CloudWatch 或 CloudWatch Evidently,或同時傳送至兩者。
自訂指標 – 自訂指標是您定義的指標。透過自訂指標,您可以使用任何指標名稱和命名空間。若要衍生指標,您可以使用任何自訂事件、內建事件、自訂屬性或預設屬性。
您可以將自訂指標傳送至 CloudWatch 和 CloudWatch Evidently。
延伸指標 – 可讓您將預設 CloudWatch RUM 指標傳送至 CloudWatch Evidently,以便在 Evidently 實驗中使用。您也可以將任何預設 CloudWatch RUM 指標傳送至具有其他維度的 CloudWatch。如此一來,這些指標就能提供您更精細的檢視。
自訂指標
若要傳送自訂指標,您必須使用 AWS APIs或 , AWS CLI 而非 主控台。如需使用 AWS APIs的詳細資訊,請參閱 PutRumMetricsDestination 和 BatchCreateRumMetricDefinitions。
一個目的地可包含的延伸指標和自訂指標定義數量上限為 2000 個。對於您傳送至每個目的地的每個自訂指標和延伸指標,每個維度名稱和維度值的組合都會計入此限制。您不需要為衍生自 CloudWatch RUM 任何類型的事件或屬性的自訂指標付費。
下列範例顯示如何建立從自訂事件衍生的自訂指標。以下是使用的自訂事件範例:
cwr('recordEvent', { type: 'my_custom_event', data: { location: 'IAD', current_url: 'amazonaws.com', user_interaction: { interaction_1 : "click", interaction_2 : "scroll" }, visit_count:10 } })
如果是此自訂事件,您可以建立自訂指標來計算透過 Chrome 瀏覽器造訪 amazonaws.com
URL 的次數。在 RUM/CustomMetrics/PageVisits
命名空間中,下列定義會在您的帳戶中建立名為 AmazonVisitsCount
的指標。
{ "AppMonitorName":"customer-appMonitor-name", "Destination":"CloudWatch", "MetricDefinitions":[ { "Name":"AmazonVisitsCount", "Namespace":"PageVisit", "ValueKey":"event_details.visit_count", "UnitLabel":"Count", "DimensionKeys":{ "event_details.current_url": "URL" }, "EventPattern":"{\"metadata\":{\"browserName\":[\"Chrome\"]},\"event_type\":[\"my_custom_event\"],\"event_details\": {\"current_url\": [\"amazonaws.com\"]}}" } ] }
延伸指標
如果您設定延伸指標,就可以執行下列其中一個或全部動作:
將預設 CloudWatch RUM 指標傳送至 CloudWatch Evidently,以便在 Evidently 實驗中使用。只有 PerformanceNavigationDuration、PerformanceResourceDuration、WebVitalsCumulativeLayoutShift、WebVitalsFirstInputDelay 和 WebVitalsLargestContentfulPaint 指標可以傳送至 Evidently。
將任何預設 CloudWatch RUM 指標傳送至具有其他維度的 CloudWatch,以便指標為您提供更精細的檢視。例如,您可以查看使用者所使用之特定瀏覽器的特定指標,或是特定地理位置中使用者的指標。
如需有關預設 CloudWatch RUM 指標的詳細資訊,請參閱「您可以使用 CloudWatch RUM 收集的 CloudWatch 指標」。
一個目的地可包含的延伸指標和自訂指標定義數量上限為 2000 個。對於您傳送至每個目的地的每個延伸或自訂指標,每個維度名稱和維度值的組合都會計為此限制的延伸指標。
將延伸指標傳送至 CloudWatch 後,就可以使用 CloudWatch RUM 主控台在這些指標上建立 CloudWatch 警示。
您不需要為針對 CloudWatch RUM 預設指標建立的延伸指標付費。
應用程式監視器可傳送的所有指標名稱的延伸指標支援下列維度。這些指標名稱列於您可以使用 CloudWatch RUM 收集的 CloudWatch 指標中。
-
BrowserName
維度值範例:
Chrome
、Firefox
、Chrome Headless
-
CountryCode
此維度會使用 ISO-3166 格式 (兩個字母的代碼)。維度值範例:
US
、JP
、DE
-
DeviceType
維度值範例:
desktop
、mobile
、tablet
、embedded
-
FileType
維度值範例:
Image
、Stylesheet
-
OSName
維度值範例:
Linux
、Windows,
iOS
、Android
-
PageId
使用主控台設定延伸指標
若要使用主控台將延伸指標傳送至 CloudWatch,請遵循下列步驟。
若要將延伸指標傳送至 CloudWatch Evidently,您必須使用 AWS APIs或 AWS CLI ,而非 主控台。如需有關使用 AWS APIs 將延伸指標傳送至 CloudWatch 或 Evidently 的資訊,請參閱 PutRumMetricsDestination 和 BatchCreateRumMetricDefinitions。
使用主控台設定應用程式監視器,並將 RUM 延伸指標傳送至 CloudWatch
透過 https://console.aws.amazon.com/cloudwatch/
開啟 CloudWatch 主控台。 在導覽窗格中,選擇 Application Signals, RUM。
選擇 List view (清單檢視),然後選擇要傳送指標的應用程式監視器名稱。
選擇 Configuration (組態) 索引標籤,然後選擇 RUM extended metrics (RUM 延伸指標)。
選擇 Send metrics (傳送指標)。
選取要與其他維度一起傳送的一或多個指標名稱。
選取一或多個要作為這些指標之維度的因素。作出選擇後,您選擇建立的延伸指標數量會顯示在 Number of extended metrics (延伸指標的數量) 中。
此數字的計算方式是將選擇的指標名稱數目乘以您建立的不同維度數量。
若要傳送以頁面 ID 作為維度的指標,請選擇 Browse for page ID (瀏覽頁面 ID),然後選取要使用的頁面 ID。
若要傳送以裝置類型作為維度的指標,請選擇 Desktop devices (桌面裝置) 或 Mobile and tablets (行動裝置和平板電腦)。
若要傳送以作業系統作為維度的指標,請在 Operating system (作業系統) 下選取一或多個作業系統。
若要傳送以瀏覽器類型作為維度的指標,請在 Browsers (瀏覽器) 下選取一或多個瀏覽器。
若要傳送以地理位置作為維度的指標,請在 Locations (位置) 下選取一或多個位置。
只有此應用程式監視器已回報指標的位置才會顯示在清單中供您選擇。
完成選擇後,選擇 Send metrics (傳送指標)。
(選用) 在 Extended metrics (延伸指標) 清單中,若要建立監看其中一個指標的警示,請在該指標列中選擇 Create alarm (建立警示)。
如需有關 CloudWatch 警示的一般資訊,請參閱 使用 Amazon CloudWatch 警示。如需在 CloudWatch RUM 延伸指標上設定警示的教學課程,請參閱教學課程:建立延伸指標並設定其警示。
停止傳送延伸指標
使用主控台停止傳送延伸指標
透過 https://console.aws.amazon.com/cloudwatch/
開啟 CloudWatch 主控台。 在導覽窗格中,選擇 Application Signals, RUM。
選擇 List view (清單檢視),然後選擇要傳送指標的應用程式監視器名稱。
選擇 Configuration (組態) 索引標籤,然後選擇 RUM extended metrics (RUM 延伸指標)。
選取要停止傳送的一或多個指標名稱和維度組合。接著選擇 Actions (動作),Delete (刪除)。
教學課程:建立延伸指標並設定其警示
本教學課程示範如何設定要傳送至 CloudWatch 的延伸指標,以及如何設定該指標的警示。在本教學課程中,您將建立一個指標來追蹤 Chrome 瀏覽器上的 JavaScript 錯誤。
設定此延伸指標並設定其警示
透過 https://console.aws.amazon.com/cloudwatch/
開啟 CloudWatch 主控台。 在導覽窗格中,選擇 Application Signals, RUM。
選擇 List view (清單檢視),然後選擇要傳送指標的應用程式監視器名稱。
選擇 Configuration (組態) 索引標籤,然後選擇 RUM extended metrics (RUM 延伸指標)。
選擇 Send metrics (傳送指標)。
選取 JSErrorCount。
在 Browsers (瀏覽器) 下,選取 Chrome。
這種 JSerrorCount 和 Chrome 的組合會將一個延伸指標傳送到 CloudWatch。此指標只會計算使用 Chrome 瀏覽器的使用者工作階段 JavaScript 錯誤。此指標名稱是 JSerrorCount,維度名稱是 Browser。
選擇 Send metrics (傳送指標)。
在 Extended metrics (延伸指標) 清單中,在 Name (名稱) 下顯示 JSerrorCount 和在 BrowserName 下顯示 Chrome 中的列中選擇 Create alarm (建立警示)。
在 Specify metric and conditions (指定指標和條件) 下,確認 Metric name (指標名稱) 和 BrowserName (瀏覽器名稱) 欄位已預先填入正確的值。
在 Statistic (統計資料) 中,選取您要用於警示的統計資料。對於這種類型的計數指標,Average (平均值) 是一個不錯的選擇。
在 Period (期間) 中,選取 5 minutes (5 分鐘)。
在 Conditions (條件) 下,執行下列動作:
選擇 Static (靜態)。
選擇 Greater (大),指定當錯誤數量大於您要指定的閾值時,警示應進入 ALARM 狀態。
在 than... (於…) 下方,輸入警示閾值的數字。如果 5 分鐘的期間內錯誤數量超過此數量時,警示會進入 ALARM 狀態。
(選用) 依預設,一旦 5 分鐘期間內的錯誤數量超過您設定的閾值數量,警示就會進入 ALARM 狀態。您也可以選擇將此設定變更為只有在連續多個 5 分鐘期間內超過此數字時,警示才進入 ALARM 狀態。
若要這麼做,請選擇 Additional configuration (其他組態),然後在 Datapoints to alarm (要警示的資料點) 中,指定在連續多少個 5 分鐘期間內錯誤次數超過閾值才會觸發警示。例如,您可以選取 2 個 (共 2 個),只有在連續兩個 5 分鐘期間內超過閾值時才觸發警示;如果選取 2個 (共 3 個),只有連續三個 5 分鐘期間內任何兩個期間內超過閾值,才會觸發警示。
如需有關此類型警示評估的詳細資訊,請參閱評估警示。
選擇 Next (下一步)。
在 Configure actions (設定動作) 中,指定警示進入 ALARM 狀態時應採取的動作。若要使用 Amazon SNS 接收通知,請執行以下操作:
選擇 Add notification (新增通知)。
選擇警示中。
選取現有的 SNS 主題,或建立新主題。如果您建立新主題,請為其指定名稱,並至少向其新增一個電子郵件地址。
選擇 Next (下一步)。
輸入名稱和選用的警示描述,然後選擇 Next (下一步)。
檢閱詳細資訊,並選擇 Create alarm (建立警示)。