PI / Client / list_available_resource_metrics



Retrieve metrics of the specified types that can be queried for a specified DB instance.

See also: AWS API Documentation

Request Syntax

response = client.list_available_resource_metrics(
  • ServiceType (string) –


    The Amazon Web Services service for which Performance Insights returns metrics.

  • Identifier (string) –


    An immutable identifier for a data source that is unique within an Amazon Web Services Region. Performance Insights gathers metrics from this data source. To use an Amazon RDS DB instance as a data source, specify its DbiResourceId value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VWZ.

  • MetricTypes (list) –


    The types of metrics to return in the response. Valid values in the array include the following:

    • os (OS counter metrics) - All engines

    • db (DB load metrics) - All engines except for Amazon DocumentDB

    • db.sql.stats (per-SQL metrics) - All engines except for Amazon DocumentDB

    • db.sql_tokenized.stats (per-SQL digest metrics) - All engines except for Amazon DocumentDB

    • (string) –

  • NextToken (string) – An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the token, up to the value specified by MaxRecords.

  • MaxResults (integer) – The maximum number of items to return. If the MaxRecords value is less than the number of existing items, the response includes a pagination token.

Return type:



Response Syntax

    'Metrics': [
            'Metric': 'string',
            'Description': 'string',
            'Unit': 'string'
    'NextToken': 'string'

Response Structure

  • (dict) –

    • Metrics (list) –

      An array of metrics available to query. Each array element contains the full name, description, and unit of the metric.

      • (dict) –

        An object that contains the full name, description, and unit of a metric.

        • Metric (string) –

          The full name of the metric.

        • Description (string) –

          The description of the metric.

        • Unit (string) –

          The unit of the metric.

    • NextToken (string) –

      A pagination token that indicates the response didn’t return all available records because MaxRecords was specified in the previous request. To get the remaining records, specify NextToken in a separate request with this value.


  • PI.Client.exceptions.InvalidArgumentException

  • PI.Client.exceptions.InternalServiceError

  • PI.Client.exceptions.NotAuthorizedException