aws-sdk-pi 1.74.0 → 1.76.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71fadeeb3b4d3042d1dc160c27369d3118a18079a2cd276191c51b589afb92f4
-  data.tar.gz: b2bff634a6c0fd0855f9f5bdca6c8543223fab1265956b4b1f62a3e68a2261e4
+  metadata.gz: 974a9e58a4a9a4821c4c3223fa5fb39885c01351fb360470bb699046ea08053d
+  data.tar.gz: ff3cb3a7281b45936fe317d059a1505de73c13326254f5370cee58d917898278
 SHA512:
-  metadata.gz: 2a2fd42ba5220e3aff5abee28b67106eaeb67d00c7a7632565534a5e42451ef0b021d8b54d1c7b8bd4c0f5c58a8457b0c1969c00a2db86d226f45fc024636a34
-  data.tar.gz: 07ece8b413d908a17e6463a2e0733dcde93d2b6cec25ccc100436d57ce8fcdcef8f658c0bfebd1ff536154581eff9825f39172c66258a696a469b052bee56e06
+  metadata.gz: e63e207f2521d7997ef9dec0342a00ed56cc10f91c6b57618a6c826d7fa59517cd46122237adeb9c7f96de941174bc1ba1b649aacaf556ce2feecc9a91c3667f
+  data.tar.gz: 1f67a694bfb3534a3c12dea16b32aee975ce54e3574932340ff420e74524aa264b31d68a53c333b5769c306afb973f2e719bba80417bf847ea5cb518f5101111

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.76.0 (2025-02-11)
+------------------
+
+* Feature - Documentation only update for RDS Performance Insights dimensions for execution plans and locking analysis.
+
+1.75.0 (2025-02-07)
+------------------
+
+* Feature - Adds documentation for dimension groups and dimensions to analyze locks for Database Insights.
+
 1.74.0 (2025-02-06)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.74.0
+1.76.0

data/lib/aws-sdk-pi/client.rb

@@ -666,6 +666,8 @@ module Aws::PI
     #   digests. The response syntax is as follows: `"AdditionalMetrics" : {
     #   "string" : "string" }`.
     #
+    #   The only supported statistic function is `.avg`.
+    #
     # @option params [Types::DimensionGroup] :partition_by
     #   For each dimension specified in `GroupBy`, specify a secondary
     #   dimension to further subdivide the partition keys in the response.
@@ -762,7 +764,8 @@ module Aws::PI
     # `GetDimensionKeyDetails` retrieves the full text of the dimension
     # `db.sql.statement` associated with this ID. This operation is useful
     # because `GetResourceMetrics` and `DescribeDimensionKeys` don't
-    # support retrieval of large SQL statement text.
+    # support retrieval of large SQL statement text, lock snapshots, and
+    # execution plans.
     #
     # @option params [required, String] :service_type
     #   The Amazon Web Services service for which Performance Insights returns
@@ -779,6 +782,10 @@ module Aws::PI
     #   specified group for the dimension group ID. The following group name
     #   values are valid:
     #
+    #   * `db.execution_plan` (Amazon RDS and Aurora only)
+    #
+    #   * `db.lock_snapshot` (Aurora only)
+    #
     #   * `db.query` (Amazon DocumentDB only)
     #
     #   * `db.sql` (Amazon RDS and Aurora only)
@@ -788,16 +795,32 @@ module Aws::PI
     #   details. For dimension group `db.sql`, the group ID is `db.sql.id`.
     #   The following group ID values are valid:
     #
+    #   * `db.execution_plan.id` for dimension group `db.execution_plan`
+    #     (Aurora and RDS only)
+    #
     #   * `db.sql.id` for dimension group `db.sql` (Aurora and RDS only)
     #
     #   * `db.query.id` for dimension group `db.query` (DocumentDB only)
     #
+    #   * For the dimension group `db.lock_snapshot`, the `GroupIdentifier` is
+    #     the epoch timestamp when Performance Insights captured the snapshot,
+    #     in seconds. You can retrieve this value with the
+    #     `GetResourceMetrics` operation for a 1 second period.
+    #
     # @option params [Array<String>] :requested_dimensions
     #   A list of dimensions to retrieve the detail data for within the given
     #   dimension group. If you don't specify this parameter, Performance
     #   Insights returns all dimension data within the specified dimension
     #   group. Specify dimension names for the following dimension groups:
     #
+    #   * `db.execution_plan` - Specify the dimension name
+    #     `db.execution_plan.raw_plan` or the short dimension name `raw_plan`
+    #     (Amazon RDS and Aurora only)
+    #
+    #   * `db.lock_snapshot` - Specify the dimension name
+    #     `db.lock_snapshot.lock_trees` or the short dimension name
+    #     `lock_trees`. (Aurora only)
+    #
     #   * `db.sql` - Specify either the full dimension name `db.sql.statement`
     #     or the short dimension name `statement` (Aurora and RDS only).
     #
@@ -906,12 +929,16 @@ module Aws::PI
     #   resp.analysis_report.insights[0].insight_data[0].performance_insights_metric.display_name #=> String
     #   resp.analysis_report.insights[0].insight_data[0].performance_insights_metric.dimensions #=> Hash
     #   resp.analysis_report.insights[0].insight_data[0].performance_insights_metric.dimensions["DescriptiveString"] #=> String
+    #   resp.analysis_report.insights[0].insight_data[0].performance_insights_metric.filter #=> Hash
+    #   resp.analysis_report.insights[0].insight_data[0].performance_insights_metric.filter["DescriptiveString"] #=> String
     #   resp.analysis_report.insights[0].insight_data[0].performance_insights_metric.value #=> Float
     #   resp.analysis_report.insights[0].baseline_data #=> Array
     #   resp.analysis_report.insights[0].baseline_data[0].performance_insights_metric.metric #=> String
     #   resp.analysis_report.insights[0].baseline_data[0].performance_insights_metric.display_name #=> String
     #   resp.analysis_report.insights[0].baseline_data[0].performance_insights_metric.dimensions #=> Hash
     #   resp.analysis_report.insights[0].baseline_data[0].performance_insights_metric.dimensions["DescriptiveString"] #=> String
+    #   resp.analysis_report.insights[0].baseline_data[0].performance_insights_metric.filter #=> Hash
+    #   resp.analysis_report.insights[0].baseline_data[0].performance_insights_metric.filter["DescriptiveString"] #=> String
     #   resp.analysis_report.insights[0].baseline_data[0].performance_insights_metric.value #=> Float
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/GetPerformanceAnalysisReport AWS API Documentation
@@ -1040,10 +1067,7 @@ module Aws::PI
     #   data points in the response.
     #
     # @option params [Integer] :max_results
-    #   The maximum number of items to return in the response. If more items
-    #   exist than the specified `MaxRecords` value, a pagination token is
-    #   included in the response so that the remaining results can be
-    #   retrieved.
+    #   The maximum number of items to return in the response.
     #
     # @option params [String] :next_token
     #   An optional pagination token provided by a previous request. If this
@@ -1476,7 +1500,7 @@ module Aws::PI
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-pi'
-      context[:gem_version] = '1.74.0'
+      context[:gem_version] = '1.76.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-pi/client_api.rb

@@ -382,6 +382,7 @@ module Aws::PI
     PerformanceInsightsMetric.add_member(:metric, Shapes::ShapeRef.new(shape: DescriptiveString, location_name: "Metric"))
     PerformanceInsightsMetric.add_member(:display_name, Shapes::ShapeRef.new(shape: DescriptiveString, location_name: "DisplayName"))
     PerformanceInsightsMetric.add_member(:dimensions, Shapes::ShapeRef.new(shape: DescriptiveMap, location_name: "Dimensions"))
+    PerformanceInsightsMetric.add_member(:filter, Shapes::ShapeRef.new(shape: DescriptiveMap, location_name: "Filter"))
     PerformanceInsightsMetric.add_member(:value, Shapes::ShapeRef.new(shape: Double, location_name: "Value"))
     PerformanceInsightsMetric.struct_class = Types::PerformanceInsightsMetric
 

data/lib/aws-sdk-pi/types.rb

@@ -324,6 +324,8 @@ module Aws::PI
     #   you can specify per-SQL metrics to get the values for the top `N`
     #   SQL digests. The response syntax is as follows: `"AdditionalMetrics"
     #   \: { "string" : "string" }`.
+    #
+    #   The only supported statistic function is `.avg`.
     #   @return [Array<String>]
     #
     # @!attribute [rw] partition_by
@@ -481,8 +483,18 @@ module Aws::PI
     #     * Amazon RDS PostgreSQL
     #
     #     * Amazon DocumentDB
+    #   * `db.blocking_sql` - The SQL queries blocking the most DB load.
+    #
+    #   * `db.blocking_session` - The sessions blocking the most DB load.
+    #
+    #   * `db.blocking_object` - The object resources acquired by other
+    #     sessions that are blocking the most DB load.
+    #
     #   * `db.host` - The host name of the connected client (all engines).
     #
+    #   * `db.plans` - The execution plans for the query (only Aurora
+    #     PostgreSQL).
+    #
     #   * `db.query` - The query that is currently running (only Amazon
     #     DocumentDB).
     #
@@ -526,6 +538,26 @@ module Aws::PI
     #     * Amazon RDS PostgreSQL
     #
     #     * Amazon DocumentDB
+    #   * `db.blocking_sql.id` - The ID for each of the SQL queries blocking
+    #     the most DB load.
+    #
+    #   * `db.blocking_sql.sql` - The SQL text for each of the SQL queries
+    #     blocking the most DB load.
+    #
+    #   * `db.blocking_session.id` - The ID for each of the sessions
+    #     blocking the most DB load.
+    #
+    #   * `db.blocking_object.id` - The ID for each of the object resources
+    #     acquired by other sessions that are blocking the most DB load.
+    #
+    #   * `db.blocking_object.type` - The object type for each of the object
+    #     resources acquired by other sessions that are blocking the most DB
+    #     load.
+    #
+    #   * `db.blocking_object.value` - The value for each of the object
+    #     resources acquired by other sessions that are blocking the most DB
+    #     load.
+    #
     #   * `db.host.id` - The host ID of the connected client (all engines).
     #
     #   * `db.host.name` - The host name of the connected client (all
@@ -780,6 +812,10 @@ module Aws::PI
     #   specified group for the dimension group ID. The following group name
     #   values are valid:
     #
+    #   * `db.execution_plan` (Amazon RDS and Aurora only)
+    #
+    #   * `db.lock_snapshot` (Aurora only)
+    #
     #   * `db.query` (Amazon DocumentDB only)
     #
     #   * `db.sql` (Amazon RDS and Aurora only)
@@ -790,9 +826,17 @@ module Aws::PI
     #   details. For dimension group `db.sql`, the group ID is `db.sql.id`.
     #   The following group ID values are valid:
     #
+    #   * `db.execution_plan.id` for dimension group `db.execution_plan`
+    #     (Aurora and RDS only)
+    #
     #   * `db.sql.id` for dimension group `db.sql` (Aurora and RDS only)
     #
     #   * `db.query.id` for dimension group `db.query` (DocumentDB only)
+    #
+    #   * For the dimension group `db.lock_snapshot`, the `GroupIdentifier`
+    #     is the epoch timestamp when Performance Insights captured the
+    #     snapshot, in seconds. You can retrieve this value with the
+    #     `GetResourceMetrics` operation for a 1 second period.
     #   @return [String]
     #
     # @!attribute [rw] requested_dimensions
@@ -802,6 +846,14 @@ module Aws::PI
     #   dimension group. Specify dimension names for the following dimension
     #   groups:
     #
+    #   * `db.execution_plan` - Specify the dimension name
+    #     `db.execution_plan.raw_plan` or the short dimension name
+    #     `raw_plan` (Amazon RDS and Aurora only)
+    #
+    #   * `db.lock_snapshot` - Specify the dimension name
+    #     `db.lock_snapshot.lock_trees` or the short dimension name
+    #     `lock_trees`. (Aurora only)
+    #
     #   * `db.sql` - Specify either the full dimension name
     #     `db.sql.statement` or the short dimension name `statement` (Aurora
     #     and RDS only).
@@ -1007,10 +1059,7 @@ module Aws::PI
     #   @return [Integer]
     #
     # @!attribute [rw] max_results
-    #   The maximum number of items to return in the response. If more items
-    #   exist than the specified `MaxRecords` value, a pagination token is
-    #   included in the response so that the remaining results can be
-    #   retrieved.
+    #   The maximum number of items to return in the response.
     #   @return [Integer]
     #
     # @!attribute [rw] next_token
@@ -1579,6 +1628,10 @@ module Aws::PI
     #   A dimension map that contains the dimensions for this partition.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] filter
+    #   The filter for the Performance Insights metric.
+    #   @return [Hash<String,String>]
+    #
     # @!attribute [rw] value
     #   The value of the metric. For example, `9` for `db.load.avg`.
     #   @return [Float]
@@ -1589,6 +1642,7 @@ module Aws::PI
       :metric,
       :display_name,
       :dimensions,
+      :filter,
       :value)
       SENSITIVE = []
       include Aws::Structure

data/lib/aws-sdk-pi.rb

@@ -54,7 +54,7 @@ module Aws::PI
   autoload :EndpointProvider, 'aws-sdk-pi/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-pi/endpoints'
 
-  GEM_VERSION = '1.74.0'
+  GEM_VERSION = '1.76.0'
 
 end
 

data/sig/types.rbs

@@ -300,6 +300,7 @@ module Aws::PI
       attr_accessor metric: ::String
       attr_accessor display_name: ::String
       attr_accessor dimensions: ::Hash[::String, ::String]
+      attr_accessor filter: ::Hash[::String, ::String]
       attr_accessor value: ::Float
       SENSITIVE: []
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-pi
 version: !ruby/object:Gem::Version
-  version: 1.74.0
+  version: 1.76.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-06 00:00:00.000000000 Z
+date: 2025-02-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core