CloudWatch 顯然可以發送的自定義指標 CloudWatch 和擴展指標 - Amazon CloudWatch

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

CloudWatch 顯然可以發送的自定義指標 CloudWatch 和擴展指標

默認情況下,RUM應用程序監控將指標發送到 CloudWatch. 這些預設量度和維度會列在您可收集的CloudWatch 量度中 CloudWatch RUM。

您也可以設定應用程式監視器來匯出指標。應用程序監視器可以發送擴展指標,自定義指標或兩者。它可以將它們發送到 CloudWatch 或發送給 CloudWatch 顯然,或兩者。

  • 自訂指標 – 自訂指標是您定義的指標。透過自訂指標,您可以使用任何指標名稱和命名空間。若要衍生指標,您可以使用任何自訂事件、內建事件、自訂屬性或預設屬性。

    您可以將自定義指標發送給 CloudWatch 和 CloudWatch 顯而易見。

  • 擴展指標 — 允許您將默認 CloudWatch RUM指標發送到 CloudWatch 顯而易見的實驗中使用。您也可以將任何預設 CloudWatch RUM量度 CloudWatch 與其他維度一起傳送至。如此一來,這些指標就能提供您更精細的檢視。

自訂指標

若要傳送自訂量度,您必須使用 AWS APIs或 AWS CLI 而不是控制台。有關使用的更多信息 AWS APIs」,請參閱PutRumMetricsDestinationBatchCreateRumMetricDefinitions

一個目的地可包含的延伸指標和自訂指標定義數量上限為 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 } })

鑑於此自定義事件,您可以創建一個自定義指標來計算amazonaws.comURL來自 Chrome 瀏覽器的訪問次數。在 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 顯而易見的實驗中使用。只有PerformanceNavigationDuration、、PerformanceResourceDurationWebVitalsCumulativeLayoutShiftWebVitalsFirstInputDelay、和WebVitalsLargestContentfulPaint指標可以傳送至「明顯」。

  • 將任何預設 CloudWatch RUM量度傳送至 CloudWatch 其他維度,以便量度提供更精細的檢視。例如,您可以查看使用者所使用之特定瀏覽器的特定指標,或是特定地理位置中使用者的指標。

如需有關預設 CloudWatch RUM量度的詳細資訊,請參閱CloudWatch 您可以收集的指標 CloudWatch RUM

一個目的地可包含的延伸指標和自訂指標定義數量上限為 2000 個。對於您傳送至每個目的地的每個延伸或自訂指標,每個維度名稱和維度值的組合都會計為此限制的延伸指標。

將延伸指標傳送至時 CloudWatch,您可以使用主 CloudWatch RUM控台在其上建立 CloudWatch 警示。

為的預設量度建立的延伸指標不會向您收費 CloudWatch RUM。

應用程式監視器可傳送的所有指標名稱的延伸指標支援下列維度。這些指標名稱列於CloudWatch 您可以收集的指標 CloudWatch RUM中。

  • BrowserName

    維度值範例:ChromeFirefoxChrome Headless

  • CountryCode這使用 ISO -3166 格式,並帶有兩個字母的代碼。

    維度值範例:USJPDE

  • DeviceType

    維度值範例:desktopmobiletabletembedded

  • FileType

    維度值範例:ImageStylesheet

  • OSName

    維度值範例:LinuxWindows, iOSAndroid

  • PageId

使用主控台設定延伸指標

若要使用主控台傳送延伸指標 CloudWatch,請使用下列步驟。

若要傳送延伸指標給「 CloudWatch 明顯」,您必須使用 AWS APIs或 AWS CLI 而不是控制台。有關使用 AWS APIs要將擴展指標發送到 CloudWatch 或顯然,請參閱PutRumMetricsDestinationBatchCreateRumMetricDefinitions

使用主控台設定應用程式監視器並將RUM延伸指標傳送至 CloudWatch
  1. 在開啟 CloudWatch 主控台https://console.aws.amazon.com/cloudwatch/

  2. 在瀏覽窗格中,選擇「應用程式訊號」、RUM

  3. 選擇 List view (清單檢視),然後選擇要傳送指標的應用程式監視器名稱。

  4. 選擇組態索引標籤,然後選擇RUM擴充度量

  5. 選擇 Send metrics (傳送指標)。

  6. 選取要與其他維度一起傳送的一或多個指標名稱。

  7. 選取一或多個要作為這些指標之維度的因素。作出選擇後,您選擇建立的延伸指標數量會顯示在 Number of extended metrics (延伸指標的數量) 中。

    此數字的計算方式是將選擇的指標名稱數目乘以您建立的不同維度數量。

    1. 若要傳送含有頁面 ID 的量度作為維度,請選擇「瀏覽頁面 ID」,然後選取IDs要使用的頁面。

    2. 若要傳送以裝置類型作為維度的指標,請選擇 Desktop devices (桌面裝置) 或 Mobile and tablets (行動裝置和平板電腦)。

    3. 若要傳送以作業系統作為維度的指標,請在 Operating system (作業系統) 下選取一或多個作業系統。

    4. 若要傳送以瀏覽器類型作為維度的指標,請在 Browsers (瀏覽器) 下選取一或多個瀏覽器。

    5. 若要傳送以地理位置作為維度的指標,請在 Locations (位置) 下選取一或多個位置。

      只有此應用程式監視器已回報指標的位置才會顯示在清單中供您選擇。

  8. 完成選擇後,選擇 Send metrics (傳送指標)。

  9. (選用) 在 Extended metrics (延伸指標) 清單中,若要建立監看其中一個指標的警示,請在該指標列中選擇 Create alarm (建立警示)。

    如需 CloudWatch 警示的一般資訊,請參閱 使用 Amazon CloudWatch 警示。如需在 CloudWatch RUM延伸量度上設定警示的教學課程,請參閱教學課程:建立延伸指標並設定其警示

停止傳送延伸指標

使用主控台停止傳送延伸指標
  1. 在開啟 CloudWatch 主控台https://console.aws.amazon.com/cloudwatch/

  2. 在瀏覽窗格中,選擇「應用程式訊號」、RUM

  3. 選擇 List view (清單檢視),然後選擇要傳送指標的應用程式監視器名稱。

  4. 選擇組態索引標籤,然後選擇RUM擴充度量

  5. 選取要停止傳送的一或多個指標名稱和維度組合。接著選擇 Actions (動作),Delete (刪除)。

教學課程:建立延伸指標並設定其警示

本教學課程示範如何設定要傳送至的延伸量度 CloudWatch,以及如何設定該量度的警示。在本教學課程中,您會建立追蹤 Chrome 瀏覽器 JavaScript 錯誤的指標。

設定此延伸指標並設定其警示
  1. 在開啟 CloudWatch 主控台https://console.aws.amazon.com/cloudwatch/

  2. 在瀏覽窗格中,選擇「應用程式訊號」、RUM

  3. 選擇 List view (清單檢視),然後選擇要傳送指標的應用程式監視器名稱。

  4. 選擇組態索引標籤,然後選擇RUM擴充度量

  5. 選擇 Send metrics (傳送指標)。

  6. 選取JSErrorCount

  7. Browsers (瀏覽器) 下,選取 Chrome

    這種JSErrorCountChrome 的組合將向其發送一個擴展指標 CloudWatch。該指標僅針對使用 Chrome 瀏覽器的使用者工作階段計算 JavaScript 錯誤。測量結果名稱將為 JsErrorCount,維度名稱將為「瀏覽器」。

  8. 選擇 Send metrics (傳送指標)。

  9. 在「延伸量度」清單中,在 JsErrorCount名稱」下方顯示的列中選擇「建立警示」,並在下方顯示「ChromeBrowserName

  10. 在「指定量度和條件」下,確認量度名稱BrowserName欄位已預先填入正確的值。

  11. Statistic (統計資料) 中,選取您要用於警示的統計資料。對於這種類型的計數指標,Average (平均值) 是一個不錯的選擇。

  12. Period (期間) 中,選取 5 minutes (5 分鐘)。

  13. Conditions (條件) 下,執行下列動作:

    • 選擇 Static (靜態)。

    • 選擇「更大」,可指定當錯誤數目大於您要指定的臨界值時,警示應進入ALARM狀態。

    • than... (於…) 下方,輸入警示閾值的數字。當 5 分鐘內的錯誤次數超過此數目時,警報會進入ALARM狀態。

  14. (選擇性) 依預設,只要錯誤數超過您在 5 分鐘內設定的臨界值數目,警示就會進入ALARM狀態。您可以選擇性地變更此設定,以便只有在超過 5 分鐘的時間超過此數字時,警示才會進入ALARM狀態。

    若要這麼做,請選擇 Additional configuration (其他組態),然後在 Datapoints to alarm (要警示的資料點) 中,指定在連續多少個 5 分鐘期間內錯誤次數超過閾值才會觸發警示。例如,您可以選取 2 個 (共 2 個),只有在連續兩個 5 分鐘期間內超過閾值時才觸發警示;如果選取 2個 (共 3 個),只有連續三個 5 分鐘期間內任何兩個期間內超過閾值,才會觸發警示。

    如需有關此類型警示評估的詳細資訊,請參閱評估警示

  15. 選擇 Next (下一步)

  16. Configure actions (設定動作) 中,指定警示進入 ALARM 狀態時應採取的動作。要接收 Amazon 的通知SNS,請執行以下操作:

    • 選擇 Add notification (新增通知)。

    • 選擇警示中

    • 選取現有SNS主題或建立新主題。如果您建立新主題,請為其指定名稱,並至少向其新增一個電子郵件地址。

  17. 選擇 Next (下一步)

  18. 輸入名稱和選用的警示描述,然後選擇 Next (下一步)。

  19. 檢閱詳細資訊,並選擇 Create alarm (建立警示)。