Skip to content

Commit b3f8ccc

Browse files
Adds documentation for dimension groups and dimensions to analyze locks for Database Insights.
1 parent 304dceb commit b3f8ccc

15 files changed

+123
-30
lines changed

generator/ServiceModels/pi/pi-2018-02-27.api.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -805,6 +805,7 @@
805805
"Metric":{"shape":"DescriptiveString"},
806806
"DisplayName":{"shape":"DescriptiveString"},
807807
"Dimensions":{"shape":"DescriptiveMap"},
808+
"Filter":{"shape":"DescriptiveMap"},
808809
"Value":{"shape":"Double"}
809810
}
810811
},

generator/ServiceModels/pi/pi-2018-02-27.docs.json

Lines changed: 10 additions & 9 deletions
Large diffs are not rendered by default.

generator/ServiceModels/pi/pi-2018-02-27.normal.json

Lines changed: 12 additions & 8 deletions
Large diffs are not rendered by default.

sdk/src/Services/PI/Generated/Model/DescribeDimensionKeysRequest.cs

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,10 @@ public partial class DescribeDimensionKeysRequest : AmazonPIRequest
6363
/// group in the <c>GroupBy</c> parameter is <c>db.sql_tokenized</c>, you can specify
6464
/// per-SQL metrics to get the values for the top <c>N</c> SQL digests. The response syntax
6565
/// is as follows: <c>"AdditionalMetrics" : { "<i>string</i>" : "<i>string</i>" }</c>.
66-
///
66+
/// </para>
67+
///
68+
/// <para>
69+
/// The only supported statistic function is <c>.avg</c>.
6770
/// </para>
6871
/// </summary>
6972
[AWSProperty(Min=1, Max=30)]

sdk/src/Services/PI/Generated/Model/DimensionGroup.cs

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -96,6 +96,36 @@ public partial class DimensionGroup
9696
/// </para>
9797
/// </li> </ul> </li> <li>
9898
/// <para>
99+
/// <c>db.blocking_sql.id</c> - The ID for each of the SQL queries blocking the most
100+
/// DB load.
101+
/// </para>
102+
/// </li> <li>
103+
/// <para>
104+
/// <c>db.blocking_sql.sql</c> - The SQL text for each of the SQL queries blocking the
105+
/// most DB load.
106+
/// </para>
107+
/// </li> <li>
108+
/// <para>
109+
/// <c>db.blocking_session.id</c> - The ID for each of the sessions blocking the most
110+
/// DB load.
111+
/// </para>
112+
/// </li> <li>
113+
/// <para>
114+
/// <c>db.blocking_object.id</c> - The ID for each of the object resources acquired by
115+
/// other sessions that are blocking the most DB load.
116+
/// </para>
117+
/// </li> <li>
118+
/// <para>
119+
/// <c>db.blocking_object.type</c> - The object type for each of the object resources
120+
/// acquired by other sessions that are blocking the most DB load.
121+
/// </para>
122+
/// </li> <li>
123+
/// <para>
124+
/// <c>db.blocking_object.value</c> - The value for each of the object resources acquired
125+
/// by other sessions that are blocking the most DB load.
126+
/// </para>
127+
/// </li> <li>
128+
/// <para>
99129
/// <c>db.host.id</c> - The host ID of the connected client (all engines).
100130
/// </para>
101131
/// </li> <li>
@@ -306,10 +336,27 @@ internal bool IsSetDimensions()
306336
/// </para>
307337
/// </li> </ul> </li> <li>
308338
/// <para>
339+
/// <c>db.blocking_sql</c> - The SQL queries blocking the most DB load.
340+
/// </para>
341+
/// </li> <li>
342+
/// <para>
343+
/// <c>db.blocking_session</c> - The sessions blocking the most DB load.
344+
/// </para>
345+
/// </li> <li>
346+
/// <para>
347+
/// <c>db.blocking_object</c> - The object resources acquired by other sessions that
348+
/// are blocking the most DB load.
349+
/// </para>
350+
/// </li> <li>
351+
/// <para>
309352
/// <c>db.host</c> - The host name of the connected client (all engines).
310353
/// </para>
311354
/// </li> <li>
312355
/// <para>
356+
/// <c>db.plans</c> - The execution plans for the query (only Aurora PostgreSQL).
357+
/// </para>
358+
/// </li> <li>
359+
/// <para>
313360
/// <c>db.query</c> - The query that is currently running (only Amazon DocumentDB).
314361
/// </para>
315362
/// </li> <li>

sdk/src/Services/PI/Generated/Model/GetDimensionKeyDetailsRequest.cs

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ namespace Amazon.PI.Model
3535
/// For example, if you specify a SQL ID, <c>GetDimensionKeyDetails</c> retrieves the
3636
/// full text of the dimension <c>db.sql.statement</c> associated with this ID. This operation
3737
/// is useful because <c>GetResourceMetrics</c> and <c>DescribeDimensionKeys</c> don't
38-
/// support retrieval of large SQL statement text.
38+
/// support retrieval of large SQL statement text, lock snapshots, and execution plans.
3939
/// </summary>
4040
public partial class GetDimensionKeyDetailsRequest : AmazonPIRequest
4141
{
@@ -53,6 +53,10 @@ public partial class GetDimensionKeyDetailsRequest : AmazonPIRequest
5353
/// </para>
5454
/// <ul> <li>
5555
/// <para>
56+
/// <c>db.lock_snapshot</c> (Aurora only)
57+
/// </para>
58+
/// </li> <li>
59+
/// <para>
5660
/// <c>db.query</c> (Amazon DocumentDB only)
5761
/// </para>
5862
/// </li> <li>
@@ -89,6 +93,12 @@ internal bool IsSetGroup()
8993
/// <para>
9094
/// <c>db.query.id</c> for dimension group <c>db.query</c> (DocumentDB only)
9195
/// </para>
96+
/// </li> <li>
97+
/// <para>
98+
/// For the dimension group <c>db.lock_snapshot</c>, the <c>GroupIdentifier</c> is the
99+
/// epoch timestamp when Performance Insights captured the snapshot, in seconds. You can
100+
/// retrieve this value with the <c>GetResourceMetrics</c> operation for a 1 second period.
101+
/// </para>
92102
/// </li> </ul>
93103
/// </summary>
94104
[AWSProperty(Required=true, Min=0, Max=256)]
@@ -136,6 +146,10 @@ internal bool IsSetIdentifier()
136146
/// </para>
137147
/// <ul> <li>
138148
/// <para>
149+
/// <c>db.lock_trees</c> - Specify the dimension name <c>db.lock_trees</c>. (Aurora only)
150+
/// </para>
151+
/// </li> <li>
152+
/// <para>
139153
/// <c>db.sql</c> - Specify either the full dimension name <c>db.sql.statement</c> or
140154
/// the short dimension name <c>statement</c> (Aurora and RDS only).
141155
/// </para>

sdk/src/Services/PI/Generated/Model/GetResourceMetricsRequest.cs

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -109,9 +109,7 @@ internal bool IsSetIdentifier()
109109
/// <summary>
110110
/// Gets and sets the property MaxResults.
111111
/// <para>
112-
/// The maximum number of items to return in the response. If more items exist than the
113-
/// specified <c>MaxRecords</c> value, a pagination token is included in the response
114-
/// so that the remaining results can be retrieved.
112+
/// The maximum number of items to return in the response.
115113
/// </para>
116114
/// </summary>
117115
[AWSProperty(Min=0, Max=25)]

sdk/src/Services/PI/Generated/Model/Internal/MarshallTransformations/PerformanceInsightsMetricUnmarshaller.cs

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,12 @@ public PerformanceInsightsMetric Unmarshall(JsonUnmarshallerContext context)
7878
unmarshalledObject.DisplayName = unmarshaller.Unmarshall(context);
7979
continue;
8080
}
81+
if (context.TestExpression("Filter", targetDepth))
82+
{
83+
var unmarshaller = new DictionaryUnmarshaller<string, string, StringUnmarshaller, StringUnmarshaller>(StringUnmarshaller.Instance, StringUnmarshaller.Instance);
84+
unmarshalledObject.Filter = unmarshaller.Unmarshall(context);
85+
continue;
86+
}
8187
if (context.TestExpression("Metric", targetDepth))
8288
{
8389
var unmarshaller = StringUnmarshaller.Instance;

sdk/src/Services/PI/Generated/Model/PerformanceInsightsMetric.cs

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,7 @@ public partial class PerformanceInsightsMetric
3636
{
3737
private Dictionary<string, string> _dimensions = AWSConfigs.InitializeCollections ? new Dictionary<string, string>() : null;
3838
private string _displayName;
39+
private Dictionary<string, string> _filter = AWSConfigs.InitializeCollections ? new Dictionary<string, string>() : null;
3940
private string _metric;
4041
private double? _value;
4142

@@ -76,6 +77,24 @@ internal bool IsSetDisplayName()
7677
return this._displayName != null;
7778
}
7879

80+
/// <summary>
81+
/// Gets and sets the property Filter.
82+
/// <para>
83+
/// The filter for the Performance Insights metric.
84+
/// </para>
85+
/// </summary>
86+
public Dictionary<string, string> Filter
87+
{
88+
get { return this._filter; }
89+
set { this._filter = value; }
90+
}
91+
92+
// Check to see if Filter property is set
93+
internal bool IsSetFilter()
94+
{
95+
return this._filter != null && (this._filter.Count > 0 || !AWSConfigs.InitializeCollections);
96+
}
97+
7998
/// <summary>
8099
/// Gets and sets the property Metric.
81100
/// <para>

sdk/src/Services/PI/Generated/_bcl35/AmazonPIClient.cs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -507,7 +507,7 @@ public virtual DescribeDimensionKeysResponse EndDescribeDimensionKeys(IAsyncResu
507507
/// For example, if you specify a SQL ID, <c>GetDimensionKeyDetails</c> retrieves the
508508
/// full text of the dimension <c>db.sql.statement</c> associated with this ID. This operation
509509
/// is useful because <c>GetResourceMetrics</c> and <c>DescribeDimensionKeys</c> don't
510-
/// support retrieval of large SQL statement text.
510+
/// support retrieval of large SQL statement text, lock snapshots, and execution plans.
511511
/// </summary>
512512
/// <param name="request">Container for the necessary parameters to execute the GetDimensionKeyDetails service method.</param>
513513
///

0 commit comments

Comments
 (0)