AWS Performance Insights
API Reference (API Version 2018-02-27)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.


A logical grouping of Performance Insights metrics for a related subject area. For example, the db.sql dimension group consists of the following dimensions:, db.sql.db_id, db.sql.statement, and db.sql.tokenized_id.


Each response element returns a maximum of 500 bytes. For larger elements, such as SQL statements, only the first 500 bytes are returned.



In the following list, the required parameters are described first.


The name of the dimension group. Valid values are:

  • db.user


  • db.sql

  • db.sql_tokenized

  • db.wait_event

  • db.wait_event_type

Type: String

Required: Yes


A list of specific dimensions from a dimension group. If this parameter is not present, then it signifies that all of the dimensions in the group were requested, or are present in the response.

Valid values for elements in the Dimensions array are:






  • db.sql.db_id

  • db.sql.statement

  • db.sql.tokenized_id


  • db.sql_tokenized.db_id

  • db.sql_tokenized.statement


  • db.wait_event.type


Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 10 items.

Required: No


The maximum number of items to fetch for this dimension group.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 10.

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

On this page: