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

根據預設，RUM 應用程式會監控將指標傳送至 CloudWatch. 這些預設量度和維度會列在您可以使用 CloudWatch RUM 收集的CloudWatch 量度中。

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

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

您可以將自定義指標發送給 CloudWatch 和 CloudWatch 顯而易見。
擴展指標 — 允許您將默認的 CloudWatch RUM 指標發送到 CloudWatch 顯然可以用於顯而易見的實驗。您也可以將任何預設 CloudWatch RUM 量度傳送至 CloudWatch 其他維度。如此一來，這些指標就能提供您更精細的檢視。

自訂指標

若要傳送自訂指標，您必須使用 AWS API 或 AWS CLI 取代主控台。如需使用 AWS API 的詳細資訊，請參閱PutRumMetricsDestination和BatchCreateRumMetricDefinitions。

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

下列範例顯示如何建立從自訂事件衍生的自訂指標。以下是使用的自訂事件範例：


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 顯而易見的實驗中使用。只有PerformanceNavigationDuration、、PerformanceResourceDurationWebVitalsCumulativeLayoutShiftWebVitalsFirstInputDelay、和WebVitalsLargestContentfulPaint指標可以傳送至「明顯」。
將任何預設 CloudWatch RUM 量度傳送至 CloudWatch 其他維度，以便量度提供更精細的檢視。例如，您可以查看使用者所使用之特定瀏覽器的特定指標，或是特定地理位置中使用者的指標。

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

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

當您將擴充指標傳送至時 CloudWatch，您可以使用 CloudWatch RUM 主控台在其上建立 CloudWatch 警示。

延伸指標會以 CloudWatch 自訂指標的形式收費。如需詳細資訊，請參閱 Amazon CloudWatch 定價。

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

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 顯而易見，您必須使用 AWS API 或 AWS CLI 代替控制台。有關使用 AWS API 將擴展指標發送到其中一個 CloudWatch 或顯而易見的信息，請參閱PutRumMetricsDestination和BatchCreateRumMetricDefinitions。

使用主控台設定應用程式監視器，並將 RUM 延伸指標傳送至 CloudWatch

請在以下位置開啟 CloudWatch 主控台。 https://console.aws.amazon.com/cloudwatch/
在瀏覽窗格中，選擇應用程式訊號，RUM。
選擇 List view (清單檢視)，然後選擇要傳送指標的應用程式監視器名稱。
選擇 Configuration (組態) 索引標籤，然後選擇 RUM extended metrics (RUM 延伸指標)。
選擇 Send metrics (傳送指標)。
選取要與其他維度一起傳送的一或多個指標名稱。
選取一或多個要作為這些指標之維度的因素。作出選擇後，您選擇建立的延伸指標數量會顯示在 Number of extended metrics (延伸指標的數量) 中。

此數字的計算方式是將選擇的指標名稱數目乘以您建立的不同維度數量。此數字代表需要您支付費用的自訂指標數量。如需有關 CloudWatch 定價的詳細資訊，請參閱 Amazon CloudWatch 定價。
1. 若要傳送以頁面 ID 作為維度的指標，請選擇 Browse for page ID (瀏覽頁面 ID)，然後選取要使用的頁面 ID。
2. 若要傳送以裝置類型作為維度的指標，請選擇 Desktop devices (桌面裝置) 或 Mobile and tablets (行動裝置和平板電腦)。
3. 若要傳送以作業系統作為維度的指標，請在 Operating system (作業系統) 下選取一或多個作業系統。
4. 若要傳送以瀏覽器類型作為維度的指標，請在 Browsers (瀏覽器) 下選取一或多個瀏覽器。
5. 若要傳送以地理位置作為維度的指標，請在 Locations (位置) 下選取一或多個位置。
  
  只有此應用程式監視器已回報指標的位置才會顯示在清單中供您選擇。
完成選擇後，選擇 Send metrics (傳送指標)。
(選用) 在 Extended metrics (延伸指標) 清單中，若要建立監看其中一個指標的警示，請在該指標列中選擇 Create alarm (建立警示)。

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

停止傳送延伸指標

使用主控台停止傳送延伸指標

請在以下位置開啟 CloudWatch 主控台。 https://console.aws.amazon.com/cloudwatch/
在瀏覽窗格中，選擇應用程式訊號，RUM。
選擇 List view (清單檢視)，然後選擇要傳送指標的應用程式監視器名稱。
選擇 Configuration (組態) 索引標籤，然後選擇 RUM extended metrics (RUM 延伸指標)。
選取要停止傳送的一或多個指標名稱和維度組合。接著選擇 Actions (動作)，Delete (刪除)。

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

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

設定此延伸指標並設定其警示

請在以下位置開啟 CloudWatch 主控台。 https://console.aws.amazon.com/cloudwatch/
在瀏覽窗格中，選擇應用程式訊號，RUM。
選擇 List view (清單檢視)，然後選擇要傳送指標的應用程式監視器名稱。
選擇 Configuration (組態) 索引標籤，然後選擇 RUM extended metrics (RUM 延伸指標)。
選擇 Send metrics (傳送指標)。
選取 [JS] ErrorCount。
在 Browsers (瀏覽器) 下，選取 Chrome。

JS ErrorCount 和 Chrome 的這種組合將向其發送一個擴展指標 CloudWatch。該指標僅針對使用 Chrome 瀏覽器的使用者工作階段計算 JavaScript 錯誤。測量結果名稱將為 JsErrorCount，維度名稱將為「瀏覽器」。
選擇 Send metrics (傳送指標)。
在「延伸量度」清單中，在 JsErrorCount「名稱」下方顯示的列中選擇「建立警示」，並在下方顯示「Chrome」BrowserName。
在「指定量度和條件」下，確認量度名稱和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 分鐘期間內任何兩個期間內超過閾值，才會觸發警示。

如需有關此類型警示評估的詳細資訊，請參閱評估警示。
選擇下一步。
在 Configure actions (設定動作) 中，指定警示進入 ALARM 狀態時應採取的動作。若要使用 Amazon SNS 接收通知，請執行以下操作：
- 選擇 Add notification (新增通知)。
- 選擇警示中。
- 選取現有的 SNS 主題，或建立新主題。如果您建立新主題，請為其指定名稱，並至少向其新增一個電子郵件地址。
選擇下一步。
輸入名稱和選用的警示描述，然後選擇 Next (下一步)。
檢閱詳細資訊，並選擇 Create alarm (建立警示)。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

CloudWatch 您可以使用 CloudWatch RUM 收集的指標

CloudWatchRUM 的資料保護和資料隱私