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

# 使用搜尋運算式建立 CloudWatch 圖形
<a name="create-search-expression"></a>

在 CloudWatch 主控台上，您可以在新增圖形至儀表板時存取搜尋功能，或使用 **Metrics** (指標) 檢視存取搜尋功能。

您無法根據 **SEARCH** 表達式建立警示。這是因為搜尋表達式會傳回多個時間序列，並且基於數學表達式的警示只能監看一個時間序列。

**使用搜尋表達式將圖形新增至現有的儀表板**

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

1. 在導覽窗格中，選擇 **Dashboards (儀表板)**，然後選取儀表板。

1. 選擇 **Add widget** (新增 widget)。

1. 選擇 **Line (列)** 或 **Stacked area (堆疊區域)**，然後選擇 **Configure (設定)**。

1. 在 **Graphed metrics (圖表化指標)** 標籤上，選擇 **Add a math expression (新增數學表達式)**。

1.  針對 **Details (詳細資訊)**，輸入您想要的搜尋表達式。例如 **SEARCH('\$1AWS/EC2,InstanceId\$1 MetricName="CPUUtilization"', 'Average')** 

1. (選用) 若要將另一個搜尋表達式或數學表達式新增到圖形，請選擇 **Add a math expression (新增數學表達式)**。

1. (選用) 在您新增搜尋表達式後，您可以指定動態標籤在每個指標的圖形圖例上顯示。動態標籤會顯示指標的統計資料，並在儀表板或圖形重新整理時自動更新。若要新增動態標籤，請選擇 **Graphed metrics (圖表化指標)**，然後選擇 **Dynamic labels (動態標籤)**。

   根據預設，您新增到標籤的動態值會出現在標籤的開頭。然後，您接著可以按一下指標的 **Label (標籤)** 值來編輯標籤。如需詳細資訊，請參閱[使用動態標籤](graph-dynamic-labels.md)。

1. (選用) 若要將單一指標新增至圖形，請選擇 **All metrics (所有指標)** 標籤，向下鑽研至您想要的指標。

1. (選用) 若要變更圖形上顯示的時間範圍，請選擇圖形頂端的 **custom (自訂)**，或 **custom (自訂)** 左側其中一個時段。

1. <a name="horizontal-annotations"></a> (選用) 水平註釋可協助儀表板使用者快速查看指標何時突增到特定水準，或指標是否在預先定義的範圍內。若要新增水平註釋，請選擇 **Graph options (圖形選項)**，和 **Add horizontal annotation (新增水平註釋)**：

   1. 針對 **Label (標籤)**，輸入註釋的標籤。

   1. 針對 **Value (值)**，輸入水平註釋顯示的指標值。

   1. 在 **Fill** (填充) 中指定此註釋是否要填充陰影。例如，選擇 `Above` 或 `Below` 作為要填入的相關區域。如果您指定 `Between`，將會顯示另一個 `Value` 欄位，這兩個值之間的圖形區域將被填充。

   1. 針對 **Axis (軸)**，指定 `Value` 中的數字是否要參照與左側 Y 軸或右側 Y 軸關聯的指標 (如果此圖形包含多個指標)。

      您可以透過選擇註釋左側欄中的顏色方塊，來變更註釋的填充顏色。

   重複這些步驟，將多個水平註釋新增到同一個圖形。

   若要隱藏註釋，請清除該註釋左側欄中的核取方塊。

   若要刪除註釋，請選擇 **Actions** (動作) 欄中的 **x**。

1. <a name="vertical-annotations"></a> (選用) 垂直註釋協助您標記里程碑的圖形，例如操作事件或部署的開始與結束。若要新增垂直註釋，請選擇 **Graph options (圖形選項)**，然後選擇 **Add vertical annotation (新增垂直註釋)**：

   1. 針對 **Label (標籤)**，輸入註釋的標籤。若要僅顯示註釋上的日期與時間，請保留 **Label (標籤)** 欄位留白。

   1. 在 **Date (日期)**，指定垂直註釋出現的日期和時間位置。

   1. 針對 **Fill (填充)**，指定是否在垂直註釋之前或之後，或是在兩個垂直註釋之間使用填充陰影。例如，選擇 `Before` 或 `After` 作為要填入的相關區域。如果您指定 `Between`，將會顯示另一個 `Date` 欄位，這兩個值之間的圖形區域將被填充。

   重複這些步驟，將多個垂直註釋新增到同一個圖形。

   若要隱藏註釋，請清除該註釋左側欄中的核取方塊。

   若要刪除註釋，請選擇 **Actions** (動作) 欄中的 **x**。

1. 選擇 **Create widget** (建立 widget)。

1. 選擇 **Save dashboard (儲存儀表板)**。

**使用 Metrics (指標) 檢視建立搜尋指標的圖形**

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

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

1. 在搜尋欄位中，輸入要搜尋的字符：例如 **cpuutilization t2.small**。

   即會顯示符合您搜尋的結果。

1. 若要建立所有符合搜尋指標的圖形，請選擇 **Graph search (圖形搜尋)**。

   或

   若要強化搜尋，請選擇出現在搜尋結果中的其中一個命名空間。

1. 如已選取命名空間縮減搜尋結果，您可以執行以下操作：

   1. 若要將一或多個指標圖形化，請選取各個指標旁的核取方塊。若要選擇所有指標，請勾選表格標題列中的核取方塊。

   1. 若要強化搜尋，請將滑鼠游標移到指標名稱上，然後選擇 **Add to search (新增至搜尋)** 或 **Search for this only (僅搜尋此項)**。

   1. 若要查看指標的說明，請選取指標名稱並選擇 **What is this?** (這是什麼？)。

   圖形中隨即顯示選取的指標。

1. (選用) 在搜尋列中選取其中一個按鈕，編輯搜尋詞彙的一部分。

1. (選用) 若要將圖形新增至儀表板，請選擇 **Actions (動作)**，然後選擇 **Add to dashboard (新增至儀表板)**。