Amazon CloudWatch
User Guide

Creating a CloudWatch Graph with a Search Expression

On the CloudWatch console, you can access search capability when you add a graph to a dashboard, or by using the Metrics view.

To add a graph with a search expression to an existing dashboard

  1. Open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.

  2. In the navigation pane, choose Dashboards and select a dashboard.

  3. Choose Add widget.

  4. Choose either Line or Stacked area and choose Configure.

  5. On the Graphed metrics tab, choose Add a math expression.

  6. For Details, enter the search expression that you want. For example, SEARCH('{AWS/EC2,InstanceId} MetricName="CPUUtilization" ', 'Average', 300)

  7. (Optional) To add another search expression or math expression to the graph, choose Add a math expression

  8. (Optional) After you add a search expression, you can specify a dynamic label to appear on the graph legend for each metric. Dynamic labels display a statistic about the metric and automatically update when the dashboard or graph is refreshed. To add a dynamic label, choose Graphed metrics and then Dynamic labels.

    By default, the dynamic values you add to the label appear at the beginning of the label. You can then click the Label value for the metric to edit the label. For more information, see Using Dynamic Labels.

  9. (Optional) To add a single metric to the graph, choose the All metrics tab and drill down to the metric you want.

  10. (Optional) To change the time range shown on the graph, choose either custom at the top of the graph or one of the time periods to the left of custom.

  11. (Optional) Horizontal annotations help dashboard users quickly see when a metric has spiked to a certain level or whether the metric is within a predefined range. To add a horizontal annotation, choose Graph options and then Add horizontal annotation:

    1. For Label, enter a label for the annotation.

    2. For Value, enter the metric value where the horizontal annotation appears.

    3. For Fill, specify whether to use fill shading with this annotation. For example, choose Above or Below for the corresponding area to be filled. If you specify Between, another Value field appears, and the area of the graph between the two values is filled.

    4. For Axis, specify whether the numbers in Value refer to the metric associated with the left y-axis or the right y-axis if the graph includes multiple metrics.

      You can change the fill color of an annotation by choosing the color square in the left column of the annotation.

    Repeat these steps to add multiple horizontal annotations to the same graph.

    To hide an annotation, clear the check box in the left column for that annotation.

    To delete an annotation, choose x in the Actions column.

  12. (Optional) Vertical annotations help you mark milestones in a graph, such as operational events or the beginning and end of a deployment. To add a vertical annotation, choose Graph options and then Add vertical annotation:

    1. For Label, enter a label for the annotation. To show only the date and time on the annotation, keep the Label field blank.

    2. For Date, specify the date and time where the vertical annotation appears.

    3. For Fill, specify whether to use fill shading before or after a vertical annotation or between two vertical annotations. For example, choose Before or After for the corresponding area to be filled. If you specify Between, another Date field appears, and the area of the graph between the two values is filled.

    Repeat these steps to add multiple vertical annotations to the same graph.

    To hide an annotation, clear the check box in the left column for that annotation.

    To delete an annotation, choose x in the Actions column.

  13. Choose Create widget.

  14. Choose Save dashboard.

To use the Metrics view to graph searched metrics

  1. Open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.

  2. In the navigation pane, choose Metrics.

  3. In the search field, enter the tokens to search for: for example, cpuutilization t2.small.

    Results that match your search appear.

  4. To graph all of the metrics that match your search, choose Graph search.

    or

    To refine your search, choose one of the namespaces that appeared in your search results.

  5. If you selected a namespace to narrow your results, you can do the following:

    1. To graph one or more metrics, select the check box next to each metric. To select all metrics, select the check box in the heading row of the table.

    2. To refine your search, hover over a metric name and choose Add to search or Search for this only.

    3. To view help for a metric, select the metric name and choose What is this?.

    The selected metrics appear on the graph.

  6. (Optional) Select one of the buttons in the search bar to edit that part of the search term.

  7. (Optional) To add the graph to a dashboard, choose Actions and then Add to dashboard.