# 使用搜索表达式创建 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**。

1. 选择**折线**或**堆积面积**，然后选择**配置**。

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**（绘制的指标），然后选择**动态标签**。

   默认情况下，添加到标签的动态值显示在标签开头。然后，您可以单击指标的**标签**值以编辑标签。有关更多信息，请参阅 [使用动态标签](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**。

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 (添加到控制面板)**。