使用 Amazon CloudWatch 監控 Amplify 應用程式

AWS Amplify 與 Amazon CloudWatch 整合，可讓您近乎即時地監控 Amplify 應用程式的指標，並建立警示，在指標超過您設定的閾值時傳送通知。如需 CloudWatch 服務運作方式的詳細資訊，請參閱 Amazon CloudWatch 使用者指南。

支援的 CloudWatch 指標

Amplify 在 AWS/AmplifyHosting 命名空間中支援七個 CloudWatch 指標，用於監控應用程式的流量、錯誤、資料傳輸、延遲和請求權杖。這些指標會每隔一分鐘彙總一次。CloudWatch 監控指標是免費的，不會計入 CloudWatch 服務配額。

下表說明每個支援的指標，並列出最相關的統計資料。並非所有可用的統計資料都適用於每個指標。

指標	描述
請求	您的應用程式收到的檢視器請求總數。 最相關的統計資料是 Sum。使用 Sum 統計資料來取得請求總數。
BytesDownloaded	檢視器針對 GET、 HEAD和 OPTIONS請求從應用程式 （下載） 傳輸的資料總量，以位元組為單位。 最相關的統計資料是 Sum。
BytesUploaded	任何請求傳輸到您的應用程式 （上傳） 的資料總量，以位元組為單位，包括 標頭。 Amplify 不會向您收取在應用程式中上傳的資料費用。 最相關的統計資料是 Sum。
4xxErrors	傳回 HTTP 狀態碼 400-499 範圍內錯誤的請求數目。 最相關的統計資料是 Sum。使用 Sum 統計資料來取得這些錯誤的總出現次數。
5xxErrors	傳回 HTTP 狀態碼 500-599 範圍內錯誤的請求數目。 最相關的統計資料是 Sum。使用 Sum 統計資料來取得這些錯誤的總出現次數。
Latency (延遲)	第一個位元組的時間，以秒為單位。這是 Amplify Hosting 收到請求到將回應傳回至網路之間的總時間。這不包括回應到達檢視器裝置時所遇到的網路延遲。 最相關的統計資料為 Average、Maximum、Minimum、p10、p50、p90、 p95和 p100。 使用 Average 統計資料來評估預期的延遲。
TokensConsumed	您的應用程式使用的請求字符。 Sum 統計資料代表總請求字符消耗量。您可以將此統計資料與目前的Request tokens per second服務配額進行比較，以判斷是否需要請求提高配額，以避免在未來的高流量事件期間發生潛在的限流。 Average 統計資料代表正常和尖峰時間的請求字符消耗。較高的字符使用量通常會導致較長的第一位元組時間 (TTFB)。因此，您可以在評估應用程式的延遲時使用此統計資料。如果您的延遲不佳，您可以改善下游 APIs以減少字符消耗，並避免字符消耗超過應用程式Request tokens per second的服務配額時可能發生的限流。 如需Request tokens per second服務配額的詳細資訊，請參閱 Amplify Hosting 服務配額。

Amplify 提供下列 CloudWatch 指標維度。

維度	描述
應用程式	指標資料由應用程式提供。
AWS 帳戶	指標資料會在 中的所有應用程式中提供 AWS 帳戶。

存取 CloudWatch 指標

您可以使用下列程序，直接從 Amplify 主控台存取 CloudWatch 指標。

注意

您也可以存取 中的 CloudWatch 指標， AWS Management Console 網址為 https：//https://console.aws.amazon.com/cloudwatch/。

在 Amplify 主控台中存取指標

1. 登入 AWS Management Console 並開啟 Amplify 主控台。

2. 選擇您要檢視指標的應用程式。

3. 在導覽窗格中，選擇監控，然後選擇指標。

建立 CloudWatch 警示

您可以在 Amplify 主控台中建立 CloudWatch 警示，在符合特定條件時傳送通知。警示會監看單一 CloudWatch 指標，並在指標超過指定數量的評估期間閾值時傳送 Amazon Simple Notification Service 通知。

您可以在 CloudWatch 主控台或使用 CloudWatch APIs 建立使用指標數學表達式的更進階警示。例如，您可以建立警示，在連續三個期間 的百分比4xxErrors超過 15% 時通知您。如需詳細資訊，請參閱《Amazon CloudWatch 使用者指南》中的根據指標數學表達式建立 CloudWatch 警示。 Amazon CloudWatch

標準 CloudWatch 定價適用於警示。如需詳細資訊，請參閱 Amazon CloudWatch 定價。

使用下列程序在 Amplify 主控台中建立警示。

為 Amplify 指標建立 CloudWatch 警示

1. 登入 AWS Management Console 並開啟 Amplify 主控台。

2. 選擇您要設定警示的應用程式。

3. 在導覽窗格中，選擇監控，然後選擇警示。

4. 在警示頁面上，選擇建立警示。

5. 在建立警示視窗中，設定您的警示，如下所示：

   1. 針對指標，從清單中選擇要監控的指標名稱。

   2. 在警示名稱中，輸入警示的有意義的名稱。例如，如果您正在監控請求，您可以命名警示 HighTraffic。名稱只能包含 ASCII 字元。

   3. 對於設定通知，請執行下列其中一項操作：

      • 1. 選擇新增以設定新的 Amazon SNS 主題。

        2. 對於電子郵件地址，輸入通知收件人的電子郵件地址。

        3. 選擇新增電子郵件地址以新增其他收件人。

      • 1. 選擇現有以重複使用 Amazon SNS 主題。

        2. 針對 SNS 主題，從清單中選擇現有 Amazon SNS 主題的名稱。

   4. 對於每當指標的統計資料，請設定警示的條件，如下所示：

      1. 指定指標是否必須大於或等於閾值。

      2. 指定閾值。

      3. 指定必須處於警示狀態才能叫用警示的連續評估期間數目。

      4. 指定評估期間的時間長度。

   5. 選擇確認。

注意

您指定的每個 Amazon SNS 收件人都會收到來自 AWS Notifications 的確認電子郵件。電子郵件包含收件人必須遵循的連結，以確認其訂閱並接收通知。

存取 SSR 應用程式的 CloudWatch Logs

Amplify 會將 SSR 執行時間的相關資訊傳送至 中的 Amazon CloudWatch Logs AWS 帳戶。當您將 SSR 應用程式部署到 Amplify 託管運算時，應用程式需要 Amplify 代表您呼叫其他 服務時擔任的 IAM 服務角色。您可以允許 Amplify 託管運算自動為您建立服務角色，也可以指定您已建立的角色。

如果您選擇允許 Amplify 為您建立 IAM 角色，該角色將已有建立 CloudWatch Logs 的許可。如果您建立自己的 IAM 角色，則需要將下列許可新增至政策，以允許 Amplify 存取 Amazon CloudWatch Logs。

logs:CreateLogStream
logs:CreateLogGroup
logs:DescribeLogGroups
logs:PutLogEvents

如需新增服務角色的詳細資訊，請參閱 新增具有部署後端資源許可的服務角色。如需部署伺服器端轉譯應用程式的詳細資訊，請參閱 使用 Amplify Hosting 部署伺服器端轉譯應用程式。

您可以在 CloudWatch 主控台或 Amplify 主控台中檢視 SSR 應用程式的 Amplify 託管運算日誌。使用下列指示在 Amplify 主控台中檢視日誌。

在 Amplify 主控台中檢視 SSR 應用程式的 CloudWatch 日誌

1. 登入 AWS Management Console 並開啟 Amplify 主控台。

2. 選擇 SSR 應用程式以檢視其 CloudWatch 日誌。

3. 在導覽窗格中，選擇監控，然後選擇託管運算日誌。

4. 在託管運算日誌頁面上，搜尋並選取特定分支的 CloudWatch 日誌群組。