Create a custom widget - Amazon CloudWatch
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Create a custom widget

To create a custom widget, you can use one of the samples provided by Amazon, or you can create your own. The Amazon samples include samples in both JavaScript and Python, and are created by a Amazon CloudFormation stack. For a list of samples, see Sample custom widgets.

To create a custom widget in a CloudWatch dashboard
  1. Open the CloudWatch console at

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

  3. Choose the + symbol.

  4. Choose Custom widget.

  5. Use one of the following methods:

    • To use a sample custom widget provided by Amazon, do the following:

      1. Select the sample in the dropdown box.

        The Amazon CloudFormation console launches in a new browser. In the Amazon CloudFormation console, do the following:

      2. (Optional) Customize the Amazon CloudFormation stack name.

      3. Make selections for any parameters used by the sample.

      4. Select I acknowledge that Amazon CloudFormation might create IAM resources, and choose Create stack.

    • To create your own custom widget provided by Amazon, do the following:

      1. Choose Next.

      2. Choose to either select your Lambda function from a list, or enter its Amazon Resource Name (ARN). If you select it from a list, also specify the Region where the function is and the version to use.

      3. For Parameters, make selections for any parameters used by the function.

      4. Enter a title for the widget.

      5. For Update on, configure when the widget should be updated (when the Lambda function should be called again). This can be one or more of the following: Refresh to update it when the dashboard auto-refreshes, Resize to update it whenever the widget is resized, or Time Range to update it whenever the dashboard's time range is adjusted, including when graphs are zoomed into.

      6. If you are satisfied with the preview, choose Create widget.