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

# 在 CloudWatch Metrics Insights 中建置查詢
<a name="cloudwatch-metrics-insights-buildquery"></a>

您可以使用 CloudWatch 主控台 AWS CLI、 或 AWS SDKs 執行 CloudWatch Metrics Insights 查詢。在主控台中執行的查詢無需支付任何費用。如需 CloudWatch 定價的詳細資訊，請參閱 [Amazon CloudWatch 定價](https://aws.amazon.com/cloudwatch/pricing/)。

使透過 CloudWatch Metrics Insights，您可以分析長達兩週之延伸時間段內的指標資料，相較於較短的保留期間，能進行更全面的歷史分析與趨勢識別。為了在查詢較長時間範圍的資料時保持效能最佳，請考慮使用較大的時間間隔 (例如 5 分鐘或 1 小時)，以減少返回的資料點數目。分析整兩週期間的趨勢時，請在 ORDER BY 子句中使用 AVG()、MAX() 等彙總函式，以有效識別模式。

如需使用 AWS SDKs執行 Metrics Insights 查詢的詳細資訊，請參閱 [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)。

若要使用 CloudWatch 主控台執行查詢，請依照下列步驟執行：

**使用 Metrics Insights 查詢指標**

1. 透過 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 在導覽窗格中，選擇 **Metrics** (指標)、**All metrics** (所有指標)。

1. (選用) 若要執行預先建置的範例查詢，請選擇 **Add query** (新增查詢)，然後選取要執行的查詢。如果您對此查詢感到滿意，則可以略過此處理程序的剩餘部分。或者，您也可以選擇 **Editor** (編輯器) 以編輯範例查詢，然後選擇 **Run** (執行) 來執行修改的查詢。

1. 若要建立自己的查詢，請選擇**多來源查詢**。然後，您可以使用**建置器**檢視 (預設) 取得引導式體驗，或者使用**編輯器**檢視查看查詢語法。您可以隨時在兩個檢視之間切換，並在兩個檢視中查看工作進度。

   在**建置器**檢視中，按一下命名空間、指標名稱、篩選條件、群組、順序和限制欄位，以瀏覽和選取可能的值。您可以開始輸入要尋找的值的任何部分，以篩選建置器所呈現的清單。可以在篩選條件和群組輸入中引用資源標籤。

   在**編輯器**檢視中，可以使用 Metrics Insights 支援的 SQL 子集來撰寫查詢。編輯器會根據您目前輸入的字元提供自動填寫選項，包括支援它們之指標的資源標籤名稱。

   CloudWatch Metrics Insights 支援依 AWS 資源標籤查詢指標。可以使用標籤對指標資料進行篩選和分組，以進行更精準的監控和分析。

   下列範例示範如何將查詢與標籤搭配使用。

   若要查看生產環境中 Amazon EC2 執行個體的 CPU 使用率：

   ```
   SELECT MAX(CPUUtilization) FROM SCHEMA("AWS/EC2") WHERE tag.env='prod'
   ```

   使用 GROUP BY 子句依環境對指標分組：

   ```
   SELECT MAX(CPUUtilization) FROM SCHEMA("AWS/EC2") GROUP BY tag.env
   ```

   若要使用您指定標籤名稱的 GROUP BY 子句：

   ```
   SELECT AVG(CPUUtilization) FROM "AWS/EC2" GROUP BY tag."aws:cloudformation:stack-name"
   ```

   若要結合標籤查詢與現有指標維度：

   ```
   SELECT MAX(CPUUtilization) FROM SCHEMA("AWS/EC2") WHERE tag.env='prod' AND InstanceId='i-1234567890abcdef0'
   ```

1. 當您對您的查詢感到滿意時，請選擇 **Run** (執行)。

1. (選用) 另一種編輯已繪製圖形的查詢方式是選擇 **Graphed metrics** (繪製指標) 索引標籤，然後選擇 **Details** (詳細資訊) 資料欄中查詢公式旁的編輯圖示。

1. (選用) 若要從繪製中移除查詢，請選擇 **Graphed metrics** (繪製指標)，然後選擇顯示查詢之列右側的 **X** 圖示。