aws-sdk-devopsguru 1.16.0 → 1.17.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -135,20 +135,49 @@ module Aws::DevOpsGuru
135
135
  include Aws::Structure
136
136
  end
137
137
 
138
+ # The Amazon Web Services resources in which DevOps Guru detected
139
+ # unusual behavior that resulted in the generation of an anomaly. When
140
+ # DevOps Guru detects multiple related anomalies, it creates and insight
141
+ # with details about the anomalous behavior and suggestions about how to
142
+ # correct the problem.
143
+ #
144
+ # @!attribute [rw] name
145
+ # The name of the Amazon Web Services resource.
146
+ # @return [String]
147
+ #
148
+ # @!attribute [rw] type
149
+ # The type of the Amazon Web Services resource.
150
+ # @return [String]
151
+ #
152
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/AnomalyResource AWS API Documentation
153
+ #
154
+ class AnomalyResource < Struct.new(
155
+ :name,
156
+ :type)
157
+ SENSITIVE = []
158
+ include Aws::Structure
159
+ end
160
+
138
161
  # Details about the source of the anomalous operational data that
139
- # triggered the anomaly. The one supported source is Amazon CloudWatch
140
- # metrics.
162
+ # triggered the anomaly.
141
163
  #
142
164
  # @!attribute [rw] cloud_watch_metrics
143
- # An array of `CloudWatchMetricsDetail` object that contains
144
- # information about the analyzed metrics that displayed anomalous
165
+ # An array of `CloudWatchMetricsDetail` objects that contain
166
+ # information about analyzed CloudWatch metrics that show anomalous
145
167
  # behavior.
146
168
  # @return [Array<Types::CloudWatchMetricsDetail>]
147
169
  #
170
+ # @!attribute [rw] performance_insights_metrics
171
+ # An array of `PerformanceInsightsMetricsDetail` objects that contain
172
+ # information about analyzed Performance Insights metrics that show
173
+ # anomalous behavior.
174
+ # @return [Array<Types::PerformanceInsightsMetricsDetail>]
175
+ #
148
176
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/AnomalySourceDetails AWS API Documentation
149
177
  #
150
178
  class AnomalySourceDetails < Struct.new(
151
- :cloud_watch_metrics)
179
+ :cloud_watch_metrics,
180
+ :performance_insights_metrics)
152
181
  SENSITIVE = []
153
182
  include Aws::Structure
154
183
  end
@@ -284,12 +313,13 @@ module Aws::DevOpsGuru
284
313
  # anomalous behavior.
285
314
  #
286
315
  # @!attribute [rw] timestamp_metric_value_pair_list
287
- # This is a list of cloudwatch metric values at given timestamp.
316
+ # This is a list of Amazon CloudWatch metric values at given
317
+ # timestamp.
288
318
  # @return [Array<Types::TimestampMetricValuePair>]
289
319
  #
290
320
  # @!attribute [rw] status_code
291
- # This is enum of the status showing whether the metric value pair
292
- # list has Partial or Complete data or there was an error.
321
+ # This is an enum of the status showing whether the metric value pair
322
+ # list has partial or complete data, or if there was an error.
293
323
  # @return [String]
294
324
  #
295
325
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/CloudWatchMetricsDataSummary AWS API Documentation
@@ -354,7 +384,7 @@ module Aws::DevOpsGuru
354
384
  include Aws::Structure
355
385
  end
356
386
 
357
- # The dimension of a Amazon CloudWatch metric that is used when DevOps
387
+ # The dimension of am Amazon CloudWatch metric that is used when DevOps
358
388
  # Guru analyzes the resources in your account for operational problems
359
389
  # and anomalous behavior. A dimension is a name/value pair that is part
360
390
  # of the identity of a metric. A metric can have up to 10 dimensions.
@@ -424,6 +454,12 @@ module Aws::DevOpsGuru
424
454
  # cloud_formation: {
425
455
  # stack_names: ["StackName"],
426
456
  # },
457
+ # tags: [
458
+ # {
459
+ # app_boundary_key: "AppBoundaryKey", # required
460
+ # tag_values: ["TagValue"], # required
461
+ # },
462
+ # ],
427
463
  # }
428
464
  #
429
465
  # @!attribute [rw] cloud_formation
@@ -432,10 +468,50 @@ module Aws::DevOpsGuru
432
468
  # DevOps Guru.
433
469
  # @return [Types::CloudFormationCostEstimationResourceCollectionFilter]
434
470
  #
471
+ # @!attribute [rw] tags
472
+ # The Amazon Web Services tags used to filter the resource collection
473
+ # that is used for a cost estimate.
474
+ #
475
+ # Tags help you identify and organize your Amazon Web Services
476
+ # resources. Many Amazon Web Services services support tagging, so you
477
+ # can assign the same tag to resources from different services to
478
+ # indicate that the resources are related. For example, you can assign
479
+ # the same tag to an Amazon DynamoDB table resource that you assign to
480
+ # an Lambda function. For more information about using tags, see the
481
+ # [Tagging best practices][1] whitepaper.
482
+ #
483
+ # Each Amazon Web Services tag has two parts.
484
+ #
485
+ # * A tag *key* (for example, `CostCenter`, `Environment`, `Project`,
486
+ # or `Secret`). Tag *keys* are case-sensitive.
487
+ #
488
+ # * An optional field known as a tag *value* (for example,
489
+ # `111122223333`, `Production`, or a team name). Omitting the tag
490
+ # *value* is the same as using an empty string. Like tag *keys*, tag
491
+ # *values* are case-sensitive.
492
+ #
493
+ # Together these are known as *key*-*value* pairs.
494
+ #
495
+ # The string used for a *key* in a tag that you use to define your
496
+ # resource coverage must begin with the prefix `Devops-guru-`. The tag
497
+ # *key* might be `Devops-guru-deployment-application` or
498
+ # `Devops-guru-rds-application`. While *keys* are case-sensitive, the
499
+ # case of *key* characters don't matter to DevOps Guru. For example,
500
+ # DevOps Guru works with a *key* named `devops-guru-rds` and a *key*
501
+ # named `DevOps-Guru-RDS`. Possible *key*/*value* pairs in your
502
+ # application might be `Devops-Guru-production-application/RDS` or
503
+ # `Devops-Guru-production-application/containers`.
504
+ #
505
+ #
506
+ #
507
+ # [1]: https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf
508
+ # @return [Array<Types::TagCostEstimationResourceCollectionFilter>]
509
+ #
435
510
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/CostEstimationResourceCollectionFilter AWS API Documentation
436
511
  #
437
512
  class CostEstimationResourceCollectionFilter < Struct.new(
438
- :cloud_formation)
513
+ :cloud_formation,
514
+ :tags)
439
515
  SENSITIVE = []
440
516
  include Aws::Structure
441
517
  end
@@ -579,11 +655,11 @@ module Aws::DevOpsGuru
579
655
  end
580
656
 
581
657
  # @!attribute [rw] proactive_anomaly
582
- # A `ReactiveAnomaly` object that represents the requested anomaly.
658
+ # A `ProactiveAnomaly` object that represents the requested anomaly.
583
659
  # @return [Types::ProactiveAnomaly]
584
660
  #
585
661
  # @!attribute [rw] reactive_anomaly
586
- # A `ProactiveAnomaly` object that represents the requested anomaly.
662
+ # A `ReactiveAnomaly` object that represents the requested anomaly.
587
663
  # @return [Types::ReactiveAnomaly]
588
664
  #
589
665
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeAnomalyResponse AWS API Documentation
@@ -798,12 +874,14 @@ module Aws::DevOpsGuru
798
874
  #
799
875
  # @!attribute [rw] organization_resource_collection_type
800
876
  # An Amazon Web Services resource collection type. This type specifies
801
- # how analyzed Amazon Web Services resources are defined. The one type
802
- # of Amazon Web Services resource collection supported is Amazon Web
803
- # Services CloudFormation stacks. DevOps Guru can be configured to
804
- # analyze only the Amazon Web Services resources that are defined in
805
- # the stacks. You can specify up to 500 Amazon Web Services
806
- # CloudFormation stacks.
877
+ # how analyzed Amazon Web Services resources are defined. The two
878
+ # types of Amazon Web Services resource collections supported are
879
+ # Amazon Web Services CloudFormation stacks and Amazon Web Services
880
+ # resources that contain the same Amazon Web Services tag. DevOps Guru
881
+ # can be configured to analyze the Amazon Web Services resources that
882
+ # are defined in the stacks or that are tagged using the same tag
883
+ # *key*. You can specify up to 500 Amazon Web Services CloudFormation
884
+ # stacks.
807
885
  # @return [String]
808
886
  #
809
887
  # @!attribute [rw] account_ids
@@ -873,18 +951,20 @@ module Aws::DevOpsGuru
873
951
  # data as a hash:
874
952
  #
875
953
  # {
876
- # resource_collection_type: "AWS_CLOUD_FORMATION", # required, accepts AWS_CLOUD_FORMATION, AWS_SERVICE
954
+ # resource_collection_type: "AWS_CLOUD_FORMATION", # required, accepts AWS_CLOUD_FORMATION, AWS_SERVICE, AWS_TAGS
877
955
  # next_token: "UuidNextToken",
878
956
  # }
879
957
  #
880
958
  # @!attribute [rw] resource_collection_type
881
959
  # An Amazon Web Services resource collection type. This type specifies
882
- # how analyzed Amazon Web Services resources are defined. The one type
883
- # of Amazon Web Services resource collection supported is Amazon Web
884
- # Services CloudFormation stacks. DevOps Guru can be configured to
885
- # analyze only the Amazon Web Services resources that are defined in
886
- # the stacks. You can specify up to 500 Amazon Web Services
887
- # CloudFormation stacks.
960
+ # how analyzed Amazon Web Services resources are defined. The two
961
+ # types of Amazon Web Services resource collections supported are
962
+ # Amazon Web Services CloudFormation stacks and Amazon Web Services
963
+ # resources that contain the same Amazon Web Services tag. DevOps Guru
964
+ # can be configured to analyze the Amazon Web Services resources that
965
+ # are defined in the stacks or that are tagged using the same tag
966
+ # *key*. You can specify up to 500 Amazon Web Services CloudFormation
967
+ # stacks.
888
968
  # @return [String]
889
969
  #
890
970
  # @!attribute [rw] next_token
@@ -918,12 +998,52 @@ module Aws::DevOpsGuru
918
998
  # this operation. If there are no more pages, this value is null.
919
999
  # @return [String]
920
1000
  #
1001
+ # @!attribute [rw] tags
1002
+ # The Amazon Web Services tags that are used by resources in the
1003
+ # resource collection.
1004
+ #
1005
+ # Tags help you identify and organize your Amazon Web Services
1006
+ # resources. Many Amazon Web Services services support tagging, so you
1007
+ # can assign the same tag to resources from different services to
1008
+ # indicate that the resources are related. For example, you can assign
1009
+ # the same tag to an Amazon DynamoDB table resource that you assign to
1010
+ # an Lambda function. For more information about using tags, see the
1011
+ # [Tagging best practices][1] whitepaper.
1012
+ #
1013
+ # Each Amazon Web Services tag has two parts.
1014
+ #
1015
+ # * A tag *key* (for example, `CostCenter`, `Environment`, `Project`,
1016
+ # or `Secret`). Tag *keys* are case-sensitive.
1017
+ #
1018
+ # * An optional field known as a tag *value* (for example,
1019
+ # `111122223333`, `Production`, or a team name). Omitting the tag
1020
+ # *value* is the same as using an empty string. Like tag *keys*, tag
1021
+ # *values* are case-sensitive.
1022
+ #
1023
+ # Together these are known as *key*-*value* pairs.
1024
+ #
1025
+ # The string used for a *key* in a tag that you use to define your
1026
+ # resource coverage must begin with the prefix `Devops-guru-`. The tag
1027
+ # *key* might be `Devops-guru-deployment-application` or
1028
+ # `Devops-guru-rds-application`. While *keys* are case-sensitive, the
1029
+ # case of *key* characters don't matter to DevOps Guru. For example,
1030
+ # DevOps Guru works with a *key* named `devops-guru-rds` and a *key*
1031
+ # named `DevOps-Guru-RDS`. Possible *key*/*value* pairs in your
1032
+ # application might be `Devops-Guru-production-application/RDS` or
1033
+ # `Devops-Guru-production-application/containers`.
1034
+ #
1035
+ #
1036
+ #
1037
+ # [1]: https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf
1038
+ # @return [Array<Types::TagHealth>]
1039
+ #
921
1040
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeResourceCollectionHealthResponse AWS API Documentation
922
1041
  #
923
1042
  class DescribeResourceCollectionHealthResponse < Struct.new(
924
1043
  :cloud_formation,
925
1044
  :service,
926
- :next_token)
1045
+ :next_token,
1046
+ :tags)
927
1047
  SENSITIVE = []
928
1048
  include Aws::Structure
929
1049
  end
@@ -982,10 +1102,12 @@ module Aws::DevOpsGuru
982
1102
  #
983
1103
  # @!attribute [rw] resource_collection
984
1104
  # A collection of Amazon Web Services resources supported by DevOps
985
- # Guru. The one type of Amazon Web Services resource collection
986
- # supported is Amazon Web Services CloudFormation stacks. DevOps Guru
987
- # can be configured to analyze only the Amazon Web Services resources
988
- # that are defined in the stacks. You can specify up to 500 Amazon Web
1105
+ # Guru. The two types of Amazon Web Services resource collections
1106
+ # supported are Amazon Web Services CloudFormation stacks and Amazon
1107
+ # Web Services resources that contain the same Amazon Web Services
1108
+ # tag. DevOps Guru can be configured to analyze the Amazon Web
1109
+ # Services resources that are defined in the stacks or that are tagged
1110
+ # using the same tag *key*. You can specify up to 500 Amazon Web
989
1111
  # Services CloudFormation stacks.
990
1112
  # @return [Types::ResourceCollection]
991
1113
  #
@@ -1163,7 +1285,7 @@ module Aws::DevOpsGuru
1163
1285
  # data as a hash:
1164
1286
  #
1165
1287
  # {
1166
- # resource_collection_type: "AWS_CLOUD_FORMATION", # required, accepts AWS_CLOUD_FORMATION, AWS_SERVICE
1288
+ # resource_collection_type: "AWS_CLOUD_FORMATION", # required, accepts AWS_CLOUD_FORMATION, AWS_SERVICE, AWS_TAGS
1167
1289
  # next_token: "UuidNextToken",
1168
1290
  # }
1169
1291
  #
@@ -1189,11 +1311,13 @@ module Aws::DevOpsGuru
1189
1311
 
1190
1312
  # @!attribute [rw] resource_collection
1191
1313
  # The requested list of Amazon Web Services resource collections. The
1192
- # one type of Amazon Web Services resource collection supported is
1193
- # Amazon Web Services CloudFormation stacks. DevOps Guru can be
1194
- # configured to analyze only the Amazon Web Services resources that
1195
- # are defined in the stacks. You can specify up to 500 Amazon Web
1196
- # Services CloudFormation stacks.
1314
+ # two types of Amazon Web Services resource collections supported are
1315
+ # Amazon Web Services CloudFormation stacks and Amazon Web Services
1316
+ # resources that contain the same Amazon Web Services tag. DevOps Guru
1317
+ # can be configured to analyze the Amazon Web Services resources that
1318
+ # are defined in the stacks or that are tagged using the same tag
1319
+ # *key*. You can specify up to 500 Amazon Web Services CloudFormation
1320
+ # stacks.
1197
1321
  # @return [Types::ResourceCollectionFilter]
1198
1322
  #
1199
1323
  # @!attribute [rw] next_token
@@ -1396,6 +1520,12 @@ module Aws::DevOpsGuru
1396
1520
  # cloud_formation: {
1397
1521
  # stack_names: ["StackName"],
1398
1522
  # },
1523
+ # tags: [
1524
+ # {
1525
+ # app_boundary_key: "AppBoundaryKey", # required
1526
+ # tag_values: ["TagValue"], # required
1527
+ # },
1528
+ # ],
1399
1529
  # },
1400
1530
  # }
1401
1531
  #
@@ -1426,10 +1556,12 @@ module Aws::DevOpsGuru
1426
1556
  #
1427
1557
  # @!attribute [rw] resource_collection
1428
1558
  # A collection of Amazon Web Services resources supported by DevOps
1429
- # Guru. The one type of Amazon Web Services resource collection
1430
- # supported is Amazon Web Services CloudFormation stacks. DevOps Guru
1431
- # can be configured to analyze only the Amazon Web Services resources
1432
- # that are defined in the stacks. You can specify up to 500 Amazon Web
1559
+ # Guru. The two types of Amazon Web Services resource collections
1560
+ # supported are Amazon Web Services CloudFormation stacks and Amazon
1561
+ # Web Services resources that contain the same Amazon Web Services
1562
+ # tag. DevOps Guru can be configured to analyze the Amazon Web
1563
+ # Services resources that are defined in the stacks or that are tagged
1564
+ # using the same tag *key*. You can specify up to 500 Amazon Web
1433
1565
  # Services CloudFormation stacks.
1434
1566
  # @return [Types::ResourceCollection]
1435
1567
  #
@@ -1463,6 +1595,12 @@ module Aws::DevOpsGuru
1463
1595
  # cloud_formation: {
1464
1596
  # stack_names: ["StackName"],
1465
1597
  # },
1598
+ # tags: [
1599
+ # {
1600
+ # app_boundary_key: "AppBoundaryKey", # required
1601
+ # tag_values: ["TagValue"], # required
1602
+ # },
1603
+ # ],
1466
1604
  # },
1467
1605
  # },
1468
1606
  # max_results: 1,
@@ -2035,6 +2173,378 @@ module Aws::DevOpsGuru
2035
2173
  include Aws::Structure
2036
2174
  end
2037
2175
 
2176
+ # A logical grouping of Performance Insights metrics for a related
2177
+ # subject area. For example, the `db.sql` dimension group consists of
2178
+ # the following dimensions: `db.sql.id`, `db.sql.db_id`,
2179
+ # `db.sql.statement`, and `db.sql.tokenized_id`.
2180
+ #
2181
+ # <note markdown="1"> Each response element returns a maximum of 500 bytes. For larger
2182
+ # elements, such as SQL statements, only the first 500 bytes are
2183
+ # returned.
2184
+ #
2185
+ # </note>
2186
+ #
2187
+ # Amazon RDS Performance Insights enables you to monitor and explore
2188
+ # different dimensions of database load based on data captured from a
2189
+ # running DB instance. DB load is measured as average active sessions.
2190
+ # Performance Insights provides the data to API consumers as a
2191
+ # two-dimensional time-series dataset. The time dimension provides DB
2192
+ # load data for each time point in the queried time range. Each time
2193
+ # point decomposes overall load in relation to the requested dimensions,
2194
+ # measured at that time point. Examples include SQL, Wait event, User,
2195
+ # and Host.
2196
+ #
2197
+ # * To learn more about Performance Insights and Amazon Aurora DB
2198
+ # instances, go to the [ Amazon Aurora User Guide][1].
2199
+ #
2200
+ # * To learn more about Performance Insights and Amazon RDS DB
2201
+ # instances, go to the [ Amazon RDS User Guide][2].
2202
+ #
2203
+ #
2204
+ #
2205
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.html
2206
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
2207
+ #
2208
+ # @!attribute [rw] group
2209
+ # The name of the dimension group. Its valid values are:
2210
+ #
2211
+ # * `db` - The name of the database to which the client is connected
2212
+ # (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL,
2213
+ # Amazon RDS MySQL, and MariaDB)
2214
+ #
2215
+ # * `db.application` - The name of the application that is connected
2216
+ # to the database (only Aurora PostgreSQL and RDS PostgreSQL)
2217
+ #
2218
+ # * `db.host` - The host name of the connected client (all engines)
2219
+ #
2220
+ # * `db.session_type` - The type of the current session (only Aurora
2221
+ # PostgreSQL and RDS PostgreSQL)
2222
+ #
2223
+ # * `db.sql` - The SQL that is currently executing (all engines)
2224
+ #
2225
+ # * `db.sql_tokenized` - The SQL digest (all engines)
2226
+ #
2227
+ # * `db.wait_event` - The event for which the database backend is
2228
+ # waiting (all engines)
2229
+ #
2230
+ # * `db.wait_event_type` - The type of event for which the database
2231
+ # backend is waiting (all engines)
2232
+ #
2233
+ # * `db.user` - The user logged in to the database (all engines)
2234
+ # @return [String]
2235
+ #
2236
+ # @!attribute [rw] dimensions
2237
+ # A list of specific dimensions from a dimension group. If this
2238
+ # parameter is not present, then it signifies that all of the
2239
+ # dimensions in the group were requested or are present in the
2240
+ # response.
2241
+ #
2242
+ # Valid values for elements in the `Dimensions` array are:
2243
+ #
2244
+ # * `db.application.name` - The name of the application that is
2245
+ # connected to the database (only Aurora PostgreSQL and RDS
2246
+ # PostgreSQL)
2247
+ #
2248
+ # * `db.host.id` - The host ID of the connected client (all engines)
2249
+ #
2250
+ # * `db.host.name` - The host name of the connected client (all
2251
+ # engines)
2252
+ #
2253
+ # * `db.name` - The name of the database to which the client is
2254
+ # connected (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora
2255
+ # MySQL, Amazon RDS MySQL, and MariaDB)
2256
+ #
2257
+ # * `db.session_type.name` - The type of the current session (only
2258
+ # Aurora PostgreSQL and RDS PostgreSQL)
2259
+ #
2260
+ # * `db.sql.id` - The SQL ID generated by Performance Insights (all
2261
+ # engines)
2262
+ #
2263
+ # * `db.sql.db_id` - The SQL ID generated by the database (all
2264
+ # engines)
2265
+ #
2266
+ # * `db.sql.statement` - The SQL text that is being executed (all
2267
+ # engines)
2268
+ #
2269
+ # * `db.sql.tokenized_id`
2270
+ #
2271
+ # * `db.sql_tokenized.id` - The SQL digest ID generated by Performance
2272
+ # Insights (all engines)
2273
+ #
2274
+ # * `db.sql_tokenized.db_id` - SQL digest ID generated by the database
2275
+ # (all engines)
2276
+ #
2277
+ # * `db.sql_tokenized.statement` - The SQL digest text (all engines)
2278
+ #
2279
+ # * `db.user.id` - The ID of the user logged in to the database (all
2280
+ # engines)
2281
+ #
2282
+ # * `db.user.name` - The name of the user logged in to the database
2283
+ # (all engines)
2284
+ #
2285
+ # * `db.wait_event.name` - The event for which the backend is waiting
2286
+ # (all engines)
2287
+ #
2288
+ # * `db.wait_event.type` - The type of event for which the backend is
2289
+ # waiting (all engines)
2290
+ #
2291
+ # * `db.wait_event_type.name` - The name of the event type for which
2292
+ # the backend is waiting (all engines)
2293
+ # @return [Array<String>]
2294
+ #
2295
+ # @!attribute [rw] limit
2296
+ # The maximum number of items to fetch for this dimension group.
2297
+ # @return [Integer]
2298
+ #
2299
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/PerformanceInsightsMetricDimensionGroup AWS API Documentation
2300
+ #
2301
+ class PerformanceInsightsMetricDimensionGroup < Struct.new(
2302
+ :group,
2303
+ :dimensions,
2304
+ :limit)
2305
+ SENSITIVE = []
2306
+ include Aws::Structure
2307
+ end
2308
+
2309
+ # A single query to be processed. Use these parameters to query the
2310
+ # Performance Insights `GetResourceMetrics` API to retrieve the metrics
2311
+ # for an anomaly. For more information, see ` GetResourceMetrics ` in
2312
+ # the *Amazon RDS Performance Insights API Reference*.
2313
+ #
2314
+ # Amazon RDS Performance Insights enables you to monitor and explore
2315
+ # different dimensions of database load based on data captured from a
2316
+ # running DB instance. DB load is measured as average active sessions.
2317
+ # Performance Insights provides the data to API consumers as a
2318
+ # two-dimensional time-series dataset. The time dimension provides DB
2319
+ # load data for each time point in the queried time range. Each time
2320
+ # point decomposes overall load in relation to the requested dimensions,
2321
+ # measured at that time point. Examples include SQL, Wait event, User,
2322
+ # and Host.
2323
+ #
2324
+ # * To learn more about Performance Insights and Amazon Aurora DB
2325
+ # instances, go to the [ Amazon Aurora User Guide][1].
2326
+ #
2327
+ # * To learn more about Performance Insights and Amazon RDS DB
2328
+ # instances, go to the [ Amazon RDS User Guide][2].
2329
+ #
2330
+ #
2331
+ #
2332
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.html
2333
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
2334
+ #
2335
+ # @!attribute [rw] metric
2336
+ # The name of the meteric used used when querying an Performance
2337
+ # Insights `GetResourceMetrics` API for anomaly metrics.
2338
+ #
2339
+ # Valid values for `Metric` are:
2340
+ #
2341
+ # * `db.load.avg` - a scaled representation of the number of active
2342
+ # sessions for the database engine.
2343
+ #
2344
+ # * `db.sampledload.avg` - the raw number of active sessions for the
2345
+ # database engine.
2346
+ #
2347
+ # If the number of active sessions is less than an internal
2348
+ # Performance Insights threshold, `db.load.avg` and
2349
+ # `db.sampledload.avg` are the same value. If the number of active
2350
+ # sessions is greater than the internal threshold, Performance
2351
+ # Insights samples the active sessions, with `db.load.avg` showing the
2352
+ # scaled values, `db.sampledload.avg` showing the raw values, and
2353
+ # `db.sampledload.avg` less than `db.load.avg`. For most use cases,
2354
+ # you can query `db.load.avg` only.
2355
+ # @return [String]
2356
+ #
2357
+ # @!attribute [rw] group_by
2358
+ # The specification for how to aggregate the data points from a
2359
+ # Performance Insights `GetResourceMetrics` API query. The Performance
2360
+ # Insights query returns all of the dimensions within that group,
2361
+ # unless you provide the names of specific dimensions within that
2362
+ # group. You can also request that Performance Insights return a
2363
+ # limited number of values for a dimension.
2364
+ # @return [Types::PerformanceInsightsMetricDimensionGroup]
2365
+ #
2366
+ # @!attribute [rw] filter
2367
+ # One or more filters to apply to a Performance Insights
2368
+ # `GetResourceMetrics` API query. Restrictions:
2369
+ #
2370
+ # * Any number of filters by the same dimension, as specified in the
2371
+ # `GroupBy` parameter.
2372
+ #
2373
+ # * A single filter for any other dimension in this dimension group.
2374
+ # @return [Hash<String,String>]
2375
+ #
2376
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/PerformanceInsightsMetricQuery AWS API Documentation
2377
+ #
2378
+ class PerformanceInsightsMetricQuery < Struct.new(
2379
+ :metric,
2380
+ :group_by,
2381
+ :filter)
2382
+ SENSITIVE = []
2383
+ include Aws::Structure
2384
+ end
2385
+
2386
+ # Details about Performance Insights metrics.
2387
+ #
2388
+ # Amazon RDS Performance Insights enables you to monitor and explore
2389
+ # different dimensions of database load based on data captured from a
2390
+ # running DB instance. DB load is measured as average active sessions.
2391
+ # Performance Insights provides the data to API consumers as a
2392
+ # two-dimensional time-series dataset. The time dimension provides DB
2393
+ # load data for each time point in the queried time range. Each time
2394
+ # point decomposes overall load in relation to the requested dimensions,
2395
+ # measured at that time point. Examples include SQL, Wait event, User,
2396
+ # and Host.
2397
+ #
2398
+ # * To learn more about Performance Insights and Amazon Aurora DB
2399
+ # instances, go to the [ Amazon Aurora User Guide][1].
2400
+ #
2401
+ # * To learn more about Performance Insights and Amazon RDS DB
2402
+ # instances, go to the [ Amazon RDS User Guide][2].
2403
+ #
2404
+ #
2405
+ #
2406
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.html
2407
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
2408
+ #
2409
+ # @!attribute [rw] metric_display_name
2410
+ # The name used for a specific Performance Insights metric.
2411
+ # @return [String]
2412
+ #
2413
+ # @!attribute [rw] unit
2414
+ # The unit of measure for a metric. For example, a session or a
2415
+ # process.
2416
+ # @return [String]
2417
+ #
2418
+ # @!attribute [rw] metric_query
2419
+ # A single query to be processed for the metric. For more information,
2420
+ # see ` PerformanceInsightsMetricQuery `.
2421
+ # @return [Types::PerformanceInsightsMetricQuery]
2422
+ #
2423
+ # @!attribute [rw] reference_data
2424
+ # For more information, see ` PerformanceInsightsReferenceData `.
2425
+ # @return [Array<Types::PerformanceInsightsReferenceData>]
2426
+ #
2427
+ # @!attribute [rw] stats_at_anomaly
2428
+ # The metric statistics during the anomalous period detected by DevOps
2429
+ # Guru;
2430
+ # @return [Array<Types::PerformanceInsightsStat>]
2431
+ #
2432
+ # @!attribute [rw] stats_at_baseline
2433
+ # Typical metric statistics that are not considered anomalous. When
2434
+ # DevOps Guru analyzes metrics, it compares them to `StatsAtBaseline`
2435
+ # to help determine if they are anomalous.
2436
+ # @return [Array<Types::PerformanceInsightsStat>]
2437
+ #
2438
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/PerformanceInsightsMetricsDetail AWS API Documentation
2439
+ #
2440
+ class PerformanceInsightsMetricsDetail < Struct.new(
2441
+ :metric_display_name,
2442
+ :unit,
2443
+ :metric_query,
2444
+ :reference_data,
2445
+ :stats_at_anomaly,
2446
+ :stats_at_baseline)
2447
+ SENSITIVE = []
2448
+ include Aws::Structure
2449
+ end
2450
+
2451
+ # Reference scalar values and other metrics that DevOps Guru displays on
2452
+ # a graph in its console along with the actual metrics it analyzed.
2453
+ # Compare these reference values to your actual metrics to help you
2454
+ # understand anomalous behavior that DevOps Guru detected.
2455
+ #
2456
+ # @!attribute [rw] reference_scalar
2457
+ # A scalar value DevOps Guru for a metric that DevOps Guru compares to
2458
+ # actual metric values. This reference value is used to determine if
2459
+ # an actual metric value should be considered anomalous.
2460
+ # @return [Types::PerformanceInsightsReferenceScalar]
2461
+ #
2462
+ # @!attribute [rw] reference_metric
2463
+ # A metric that DevOps Guru compares to actual metric values. This
2464
+ # reference metric is used to determine if an actual metric should be
2465
+ # considered anomalous.
2466
+ # @return [Types::PerformanceInsightsReferenceMetric]
2467
+ #
2468
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/PerformanceInsightsReferenceComparisonValues AWS API Documentation
2469
+ #
2470
+ class PerformanceInsightsReferenceComparisonValues < Struct.new(
2471
+ :reference_scalar,
2472
+ :reference_metric)
2473
+ SENSITIVE = []
2474
+ include Aws::Structure
2475
+ end
2476
+
2477
+ # Reference data used to evaluate Performance Insights to determine if
2478
+ # its performance is anomalous or not.
2479
+ #
2480
+ # @!attribute [rw] name
2481
+ # The name of the reference data.
2482
+ # @return [String]
2483
+ #
2484
+ # @!attribute [rw] comparison_values
2485
+ # The specific reference values used to evaluate the Performance
2486
+ # Insights. For more information, see `
2487
+ # PerformanceInsightsReferenceComparisonValues `.
2488
+ # @return [Types::PerformanceInsightsReferenceComparisonValues]
2489
+ #
2490
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/PerformanceInsightsReferenceData AWS API Documentation
2491
+ #
2492
+ class PerformanceInsightsReferenceData < Struct.new(
2493
+ :name,
2494
+ :comparison_values)
2495
+ SENSITIVE = []
2496
+ include Aws::Structure
2497
+ end
2498
+
2499
+ # Information about a reference metric used to evaluate Performance
2500
+ # Insights.
2501
+ #
2502
+ # @!attribute [rw] metric_query
2503
+ # A query to be processed on the metric.
2504
+ # @return [Types::PerformanceInsightsMetricQuery]
2505
+ #
2506
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/PerformanceInsightsReferenceMetric AWS API Documentation
2507
+ #
2508
+ class PerformanceInsightsReferenceMetric < Struct.new(
2509
+ :metric_query)
2510
+ SENSITIVE = []
2511
+ include Aws::Structure
2512
+ end
2513
+
2514
+ # A reference value to compare Performance Insights metrics against to
2515
+ # determine if the metrics demonstrate anomalous behavior.
2516
+ #
2517
+ # @!attribute [rw] value
2518
+ # The reference value.
2519
+ # @return [Float]
2520
+ #
2521
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/PerformanceInsightsReferenceScalar AWS API Documentation
2522
+ #
2523
+ class PerformanceInsightsReferenceScalar < Struct.new(
2524
+ :value)
2525
+ SENSITIVE = []
2526
+ include Aws::Structure
2527
+ end
2528
+
2529
+ # A statistic in a Performance Insights collection.
2530
+ #
2531
+ # @!attribute [rw] type
2532
+ # The statistic type.
2533
+ # @return [String]
2534
+ #
2535
+ # @!attribute [rw] value
2536
+ # The value of the statistic.
2537
+ # @return [Float]
2538
+ #
2539
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/PerformanceInsightsStat AWS API Documentation
2540
+ #
2541
+ class PerformanceInsightsStat < Struct.new(
2542
+ :type,
2543
+ :value)
2544
+ SENSITIVE = []
2545
+ include Aws::Structure
2546
+ end
2547
+
2038
2548
  # The time range during which anomalous behavior in a proactive anomaly
2039
2549
  # or an insight is expected to occur.
2040
2550
  #
@@ -2065,7 +2575,14 @@ module Aws::DevOpsGuru
2065
2575
  # @return [String]
2066
2576
  #
2067
2577
  # @!attribute [rw] severity
2068
- # The severity of a proactive anomaly.
2578
+ # The severity of the anomaly. The severity of anomalies that generate
2579
+ # an insight determine that insight's severity. For more information,
2580
+ # see [Understanding insight severities][1] in the *Amazon DevOps Guru
2581
+ # User Guide*.
2582
+ #
2583
+ #
2584
+ #
2585
+ # [1]: https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-insights.html#understanding-insights-severities
2069
2586
  # @return [String]
2070
2587
  #
2071
2588
  # @!attribute [rw] status
@@ -2084,7 +2601,7 @@ module Aws::DevOpsGuru
2084
2601
  # @return [Types::AnomalyTimeRange]
2085
2602
  #
2086
2603
  # @!attribute [rw] anomaly_reported_time_range
2087
- # A `AnomalyReportedTimeRange` object that specifies the time range
2604
+ # An `AnomalyReportedTimeRange` object that specifies the time range
2088
2605
  # between when the anomaly is opened and the time when it is closed.
2089
2606
  # @return [Types::AnomalyReportedTimeRange]
2090
2607
  #
@@ -2106,10 +2623,12 @@ module Aws::DevOpsGuru
2106
2623
  #
2107
2624
  # @!attribute [rw] resource_collection
2108
2625
  # A collection of Amazon Web Services resources supported by DevOps
2109
- # Guru. The one type of Amazon Web Services resource collection
2110
- # supported is Amazon Web Services CloudFormation stacks. DevOps Guru
2111
- # can be configured to analyze only the Amazon Web Services resources
2112
- # that are defined in the stacks. You can specify up to 500 Amazon Web
2626
+ # Guru. The two types of Amazon Web Services resource collections
2627
+ # supported are Amazon Web Services CloudFormation stacks and Amazon
2628
+ # Web Services resources that contain the same Amazon Web Services
2629
+ # tag. DevOps Guru can be configured to analyze the Amazon Web
2630
+ # Services resources that are defined in the stacks or that are tagged
2631
+ # using the same tag *key*. You can specify up to 500 Amazon Web
2113
2632
  # Services CloudFormation stacks.
2114
2633
  # @return [Types::ResourceCollection]
2115
2634
  #
@@ -2145,7 +2664,14 @@ module Aws::DevOpsGuru
2145
2664
  # @return [String]
2146
2665
  #
2147
2666
  # @!attribute [rw] severity
2148
- # The severity of the anomaly.
2667
+ # The severity of the anomaly. The severity of anomalies that generate
2668
+ # an insight determine that insight's severity. For more information,
2669
+ # see [Understanding insight severities][1] in the *Amazon DevOps Guru
2670
+ # User Guide*.
2671
+ #
2672
+ #
2673
+ #
2674
+ # [1]: https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-insights.html#understanding-insights-severities
2149
2675
  # @return [String]
2150
2676
  #
2151
2677
  # @!attribute [rw] status
@@ -2164,7 +2690,7 @@ module Aws::DevOpsGuru
2164
2690
  # @return [Types::AnomalyTimeRange]
2165
2691
  #
2166
2692
  # @!attribute [rw] anomaly_reported_time_range
2167
- # A `AnomalyReportedTimeRange` object that specifies the time range
2693
+ # An `AnomalyReportedTimeRange` object that specifies the time range
2168
2694
  # between when the anomaly is opened and the time when it is closed.
2169
2695
  # @return [Types::AnomalyReportedTimeRange]
2170
2696
  #
@@ -2186,10 +2712,12 @@ module Aws::DevOpsGuru
2186
2712
  #
2187
2713
  # @!attribute [rw] resource_collection
2188
2714
  # A collection of Amazon Web Services resources supported by DevOps
2189
- # Guru. The one type of Amazon Web Services resource collection
2190
- # supported is Amazon Web Services CloudFormation stacks. DevOps Guru
2191
- # can be configured to analyze only the Amazon Web Services resources
2192
- # that are defined in the stacks. You can specify up to 500 Amazon Web
2715
+ # Guru. The two types of Amazon Web Services resource collections
2716
+ # supported are Amazon Web Services CloudFormation stacks and Amazon
2717
+ # Web Services resources that contain the same Amazon Web Services
2718
+ # tag. DevOps Guru can be configured to analyze the Amazon Web
2719
+ # Services resources that are defined in the stacks or that are tagged
2720
+ # using the same tag *key*. You can specify up to 500 Amazon Web
2193
2721
  # Services CloudFormation stacks.
2194
2722
  # @return [Types::ResourceCollection]
2195
2723
  #
@@ -2229,7 +2757,13 @@ module Aws::DevOpsGuru
2229
2757
  # @return [String]
2230
2758
  #
2231
2759
  # @!attribute [rw] severity
2232
- # The severity of the proactive insight.
2760
+ # The severity of the insight. For more information, see
2761
+ # [Understanding insight severities][1] in the *Amazon DevOps Guru
2762
+ # User Guide*.
2763
+ #
2764
+ #
2765
+ #
2766
+ # [1]: https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-insights.html#understanding-insights-severities
2233
2767
  # @return [String]
2234
2768
  #
2235
2769
  # @!attribute [rw] status
@@ -2248,10 +2782,12 @@ module Aws::DevOpsGuru
2248
2782
  #
2249
2783
  # @!attribute [rw] resource_collection
2250
2784
  # A collection of Amazon Web Services resources supported by DevOps
2251
- # Guru. The one type of Amazon Web Services resource collection
2252
- # supported is Amazon Web Services CloudFormation stacks. DevOps Guru
2253
- # can be configured to analyze only the Amazon Web Services resources
2254
- # that are defined in the stacks. You can specify up to 500 Amazon Web
2785
+ # Guru. The two types of Amazon Web Services resource collections
2786
+ # supported are Amazon Web Services CloudFormation stacks and Amazon
2787
+ # Web Services resources that contain the same Amazon Web Services
2788
+ # tag. DevOps Guru can be configured to analyze the Amazon Web
2789
+ # Services resources that are defined in the stacks or that are tagged
2790
+ # using the same tag *key*. You can specify up to 500 Amazon Web
2255
2791
  # Services CloudFormation stacks.
2256
2792
  # @return [Types::ResourceCollection]
2257
2793
  #
@@ -2288,7 +2824,13 @@ module Aws::DevOpsGuru
2288
2824
  # @return [String]
2289
2825
  #
2290
2826
  # @!attribute [rw] severity
2291
- # The severity of the proactive insight.
2827
+ # The severity of the insight. For more information, see
2828
+ # [Understanding insight severities][1] in the *Amazon DevOps Guru
2829
+ # User Guide*.
2830
+ #
2831
+ #
2832
+ #
2833
+ # [1]: https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-insights.html#understanding-insights-severities
2292
2834
  # @return [String]
2293
2835
  #
2294
2836
  # @!attribute [rw] status
@@ -2307,10 +2849,12 @@ module Aws::DevOpsGuru
2307
2849
  #
2308
2850
  # @!attribute [rw] resource_collection
2309
2851
  # A collection of Amazon Web Services resources supported by DevOps
2310
- # Guru. The one type of Amazon Web Services resource collection
2311
- # supported is Amazon Web Services CloudFormation stacks. DevOps Guru
2312
- # can be configured to analyze only the Amazon Web Services resources
2313
- # that are defined in the stacks. You can specify up to 500 Amazon Web
2852
+ # Guru. The two types of Amazon Web Services resource collections
2853
+ # supported are Amazon Web Services CloudFormation stacks and Amazon
2854
+ # Web Services resources that contain the same Amazon Web Services
2855
+ # tag. DevOps Guru can be configured to analyze the Amazon Web
2856
+ # Services resources that are defined in the stacks or that are tagged
2857
+ # using the same tag *key*. You can specify up to 500 Amazon Web
2314
2858
  # Services CloudFormation stacks.
2315
2859
  # @return [Types::ResourceCollection]
2316
2860
  #
@@ -2318,6 +2862,11 @@ module Aws::DevOpsGuru
2318
2862
  # A collection of the names of Amazon Web Services services.
2319
2863
  # @return [Types::ServiceCollection]
2320
2864
  #
2865
+ # @!attribute [rw] associated_resource_arns
2866
+ # The Amazon Resource Names (ARNs) of the Amazon Web Services
2867
+ # resources that generated this insight.
2868
+ # @return [Array<String>]
2869
+ #
2321
2870
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ProactiveInsightSummary AWS API Documentation
2322
2871
  #
2323
2872
  class ProactiveInsightSummary < Struct.new(
@@ -2328,7 +2877,8 @@ module Aws::DevOpsGuru
2328
2877
  :insight_time_range,
2329
2878
  :prediction_time_range,
2330
2879
  :resource_collection,
2331
- :service_collection)
2880
+ :service_collection,
2881
+ :associated_resource_arns)
2332
2882
  SENSITIVE = []
2333
2883
  include Aws::Structure
2334
2884
  end
@@ -2353,7 +2903,13 @@ module Aws::DevOpsGuru
2353
2903
  # @return [String]
2354
2904
  #
2355
2905
  # @!attribute [rw] severity
2356
- # An array of severity values used to search for insights.
2906
+ # An array of severity values used to search for insights. For more
2907
+ # information, see [Understanding insight severities][1] in the
2908
+ # *Amazon DevOps Guru User Guide*.
2909
+ #
2910
+ #
2911
+ #
2912
+ # [1]: https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-insights.html#understanding-insights-severities
2357
2913
  # @return [String]
2358
2914
  #
2359
2915
  # @!attribute [rw] status
@@ -2372,10 +2928,12 @@ module Aws::DevOpsGuru
2372
2928
  #
2373
2929
  # @!attribute [rw] resource_collection
2374
2930
  # A collection of Amazon Web Services resources supported by DevOps
2375
- # Guru. The one type of Amazon Web Services resource collection
2376
- # supported is Amazon Web Services CloudFormation stacks. DevOps Guru
2377
- # can be configured to analyze only the Amazon Web Services resources
2378
- # that are defined in the stacks. You can specify up to 500 Amazon Web
2931
+ # Guru. The two types of Amazon Web Services resource collections
2932
+ # supported are Amazon Web Services CloudFormation stacks and Amazon
2933
+ # Web Services resources that contain the same Amazon Web Services
2934
+ # tag. DevOps Guru can be configured to analyze the Amazon Web
2935
+ # Services resources that are defined in the stacks or that are tagged
2936
+ # using the same tag *key*. You can specify up to 500 Amazon Web
2379
2937
  # Services CloudFormation stacks.
2380
2938
  # @return [Types::ResourceCollection]
2381
2939
  #
@@ -2435,7 +2993,14 @@ module Aws::DevOpsGuru
2435
2993
  # @return [String]
2436
2994
  #
2437
2995
  # @!attribute [rw] severity
2438
- # The severity of the anomaly.
2996
+ # The severity of the anomaly. The severity of anomalies that generate
2997
+ # an insight determine that insight's severity. For more information,
2998
+ # see [Understanding insight severities][1] in the *Amazon DevOps Guru
2999
+ # User Guide*.
3000
+ #
3001
+ #
3002
+ #
3003
+ # [1]: https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-insights.html#understanding-insights-severities
2439
3004
  # @return [String]
2440
3005
  #
2441
3006
  # @!attribute [rw] status
@@ -2450,7 +3015,7 @@ module Aws::DevOpsGuru
2450
3015
  # @return [Types::AnomalyTimeRange]
2451
3016
  #
2452
3017
  # @!attribute [rw] anomaly_reported_time_range
2453
- # A `AnomalyReportedTimeRange` object that specifies the time range
3018
+ # An `AnomalyReportedTimeRange` object that specifies the time range
2454
3019
  # between when the anomaly is opened and the time when it is closed.
2455
3020
  # @return [Types::AnomalyReportedTimeRange]
2456
3021
  #
@@ -2467,13 +3032,43 @@ module Aws::DevOpsGuru
2467
3032
  #
2468
3033
  # @!attribute [rw] resource_collection
2469
3034
  # A collection of Amazon Web Services resources supported by DevOps
2470
- # Guru. The one type of Amazon Web Services resource collection
2471
- # supported is Amazon Web Services CloudFormation stacks. DevOps Guru
2472
- # can be configured to analyze only the Amazon Web Services resources
2473
- # that are defined in the stacks. You can specify up to 500 Amazon Web
3035
+ # Guru. The two types of Amazon Web Services resource collections
3036
+ # supported are Amazon Web Services CloudFormation stacks and Amazon
3037
+ # Web Services resources that contain the same Amazon Web Services
3038
+ # tag. DevOps Guru can be configured to analyze the Amazon Web
3039
+ # Services resources that are defined in the stacks or that are tagged
3040
+ # using the same tag *key*. You can specify up to 500 Amazon Web
2474
3041
  # Services CloudFormation stacks.
2475
3042
  # @return [Types::ResourceCollection]
2476
3043
  #
3044
+ # @!attribute [rw] type
3045
+ # The type of the reactive anomaly. It can be one of the following
3046
+ # types.
3047
+ #
3048
+ # * `CAUSAL` - the anomaly can cause a new insight.
3049
+ #
3050
+ # * `CONTEXTUAL` - the anomaly contains additional information about
3051
+ # an insight or its causal anomaly.
3052
+ # @return [String]
3053
+ #
3054
+ # @!attribute [rw] name
3055
+ # The name of the reactive anomaly.
3056
+ # @return [String]
3057
+ #
3058
+ # @!attribute [rw] description
3059
+ # A description of the reactive anomaly.
3060
+ # @return [String]
3061
+ #
3062
+ # @!attribute [rw] causal_anomaly_id
3063
+ # The ID of the causal anomaly that is associated with this reactive
3064
+ # anomaly. The ID of a `CAUSAL` anomaly is always `NULL`.
3065
+ # @return [String]
3066
+ #
3067
+ # @!attribute [rw] anomaly_resources
3068
+ # The Amazon Web Services resources in which anomalous behavior was
3069
+ # detected by DevOps Guru.
3070
+ # @return [Array<Types::AnomalyResource>]
3071
+ #
2477
3072
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ReactiveAnomaly AWS API Documentation
2478
3073
  #
2479
3074
  class ReactiveAnomaly < Struct.new(
@@ -2484,7 +3079,12 @@ module Aws::DevOpsGuru
2484
3079
  :anomaly_reported_time_range,
2485
3080
  :source_details,
2486
3081
  :associated_insight_id,
2487
- :resource_collection)
3082
+ :resource_collection,
3083
+ :type,
3084
+ :name,
3085
+ :description,
3086
+ :causal_anomaly_id,
3087
+ :anomaly_resources)
2488
3088
  SENSITIVE = []
2489
3089
  include Aws::Structure
2490
3090
  end
@@ -2497,7 +3097,14 @@ module Aws::DevOpsGuru
2497
3097
  # @return [String]
2498
3098
  #
2499
3099
  # @!attribute [rw] severity
2500
- # The severity of the reactive anomaly.
3100
+ # The severity of the anomaly. The severity of anomalies that generate
3101
+ # an insight determine that insight's severity. For more information,
3102
+ # see [Understanding insight severities][1] in the *Amazon DevOps Guru
3103
+ # User Guide*.
3104
+ #
3105
+ #
3106
+ #
3107
+ # [1]: https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-insights.html#understanding-insights-severities
2501
3108
  # @return [String]
2502
3109
  #
2503
3110
  # @!attribute [rw] status
@@ -2512,7 +3119,7 @@ module Aws::DevOpsGuru
2512
3119
  # @return [Types::AnomalyTimeRange]
2513
3120
  #
2514
3121
  # @!attribute [rw] anomaly_reported_time_range
2515
- # A `AnomalyReportedTimeRange` object that specifies the time range
3122
+ # An `AnomalyReportedTimeRange` object that specifies the time range
2516
3123
  # between when the anomaly is opened and the time when it is closed.
2517
3124
  # @return [Types::AnomalyReportedTimeRange]
2518
3125
  #
@@ -2529,13 +3136,43 @@ module Aws::DevOpsGuru
2529
3136
  #
2530
3137
  # @!attribute [rw] resource_collection
2531
3138
  # A collection of Amazon Web Services resources supported by DevOps
2532
- # Guru. The one type of Amazon Web Services resource collection
2533
- # supported is Amazon Web Services CloudFormation stacks. DevOps Guru
2534
- # can be configured to analyze only the Amazon Web Services resources
2535
- # that are defined in the stacks. You can specify up to 500 Amazon Web
3139
+ # Guru. The two types of Amazon Web Services resource collections
3140
+ # supported are Amazon Web Services CloudFormation stacks and Amazon
3141
+ # Web Services resources that contain the same Amazon Web Services
3142
+ # tag. DevOps Guru can be configured to analyze the Amazon Web
3143
+ # Services resources that are defined in the stacks or that are tagged
3144
+ # using the same tag *key*. You can specify up to 500 Amazon Web
2536
3145
  # Services CloudFormation stacks.
2537
3146
  # @return [Types::ResourceCollection]
2538
3147
  #
3148
+ # @!attribute [rw] type
3149
+ # The type of the reactive anomaly. It can be one of the following
3150
+ # types.
3151
+ #
3152
+ # * `CAUSAL` - the anomaly can cause a new insight.
3153
+ #
3154
+ # * `CONTEXTUAL` - the anomaly contains additional information about
3155
+ # an insight or its causal anomaly.
3156
+ # @return [String]
3157
+ #
3158
+ # @!attribute [rw] name
3159
+ # The name of the reactive anomaly.
3160
+ # @return [String]
3161
+ #
3162
+ # @!attribute [rw] description
3163
+ # A description of the reactive anomaly.
3164
+ # @return [String]
3165
+ #
3166
+ # @!attribute [rw] causal_anomaly_id
3167
+ # The ID of the causal anomaly that is associated with this reactive
3168
+ # anomaly. The ID of a `CAUSAL` anomaly is always `NULL`.
3169
+ # @return [String]
3170
+ #
3171
+ # @!attribute [rw] anomaly_resources
3172
+ # The Amazon Web Services resources in which anomalous behavior was
3173
+ # detected by DevOps Guru.
3174
+ # @return [Array<Types::AnomalyResource>]
3175
+ #
2539
3176
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ReactiveAnomalySummary AWS API Documentation
2540
3177
  #
2541
3178
  class ReactiveAnomalySummary < Struct.new(
@@ -2546,7 +3183,12 @@ module Aws::DevOpsGuru
2546
3183
  :anomaly_reported_time_range,
2547
3184
  :source_details,
2548
3185
  :associated_insight_id,
2549
- :resource_collection)
3186
+ :resource_collection,
3187
+ :type,
3188
+ :name,
3189
+ :description,
3190
+ :causal_anomaly_id,
3191
+ :anomaly_resources)
2550
3192
  SENSITIVE = []
2551
3193
  include Aws::Structure
2552
3194
  end
@@ -2563,7 +3205,13 @@ module Aws::DevOpsGuru
2563
3205
  # @return [String]
2564
3206
  #
2565
3207
  # @!attribute [rw] severity
2566
- # The severity of a reactive insight.
3208
+ # The severity of the insight. For more information, see
3209
+ # [Understanding insight severities][1] in the *Amazon DevOps Guru
3210
+ # User Guide*.
3211
+ #
3212
+ #
3213
+ #
3214
+ # [1]: https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-insights.html#understanding-insights-severities
2567
3215
  # @return [String]
2568
3216
  #
2569
3217
  # @!attribute [rw] status
@@ -2577,10 +3225,12 @@ module Aws::DevOpsGuru
2577
3225
  #
2578
3226
  # @!attribute [rw] resource_collection
2579
3227
  # A collection of Amazon Web Services resources supported by DevOps
2580
- # Guru. The one type of Amazon Web Services resource collection
2581
- # supported is Amazon Web Services CloudFormation stacks. DevOps Guru
2582
- # can be configured to analyze only the Amazon Web Services resources
2583
- # that are defined in the stacks. You can specify up to 500 Amazon Web
3228
+ # Guru. The two types of Amazon Web Services resource collections
3229
+ # supported are Amazon Web Services CloudFormation stacks and Amazon
3230
+ # Web Services resources that contain the same Amazon Web Services
3231
+ # tag. DevOps Guru can be configured to analyze the Amazon Web
3232
+ # Services resources that are defined in the stacks or that are tagged
3233
+ # using the same tag *key*. You can specify up to 500 Amazon Web
2584
3234
  # Services CloudFormation stacks.
2585
3235
  # @return [Types::ResourceCollection]
2586
3236
  #
@@ -2616,7 +3266,13 @@ module Aws::DevOpsGuru
2616
3266
  # @return [String]
2617
3267
  #
2618
3268
  # @!attribute [rw] severity
2619
- # The severity of a reactive insight.
3269
+ # The severity of the insight. For more information, see
3270
+ # [Understanding insight severities][1] in the *Amazon DevOps Guru
3271
+ # User Guide*.
3272
+ #
3273
+ #
3274
+ #
3275
+ # [1]: https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-insights.html#understanding-insights-severities
2620
3276
  # @return [String]
2621
3277
  #
2622
3278
  # @!attribute [rw] status
@@ -2630,10 +3286,12 @@ module Aws::DevOpsGuru
2630
3286
  #
2631
3287
  # @!attribute [rw] resource_collection
2632
3288
  # A collection of Amazon Web Services resources supported by DevOps
2633
- # Guru. The one type of Amazon Web Services resource collection
2634
- # supported is Amazon Web Services CloudFormation stacks. DevOps Guru
2635
- # can be configured to analyze only the Amazon Web Services resources
2636
- # that are defined in the stacks. You can specify up to 500 Amazon Web
3289
+ # Guru. The two types of Amazon Web Services resource collections
3290
+ # supported are Amazon Web Services CloudFormation stacks and Amazon
3291
+ # Web Services resources that contain the same Amazon Web Services
3292
+ # tag. DevOps Guru can be configured to analyze the Amazon Web
3293
+ # Services resources that are defined in the stacks or that are tagged
3294
+ # using the same tag *key*. You can specify up to 500 Amazon Web
2637
3295
  # Services CloudFormation stacks.
2638
3296
  # @return [Types::ResourceCollection]
2639
3297
  #
@@ -2641,6 +3299,11 @@ module Aws::DevOpsGuru
2641
3299
  # A collection of the names of Amazon Web Services services.
2642
3300
  # @return [Types::ServiceCollection]
2643
3301
  #
3302
+ # @!attribute [rw] associated_resource_arns
3303
+ # The Amazon Resource Names (ARNs) of the Amazon Web Services
3304
+ # resources that generated this insight.
3305
+ # @return [Array<String>]
3306
+ #
2644
3307
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ReactiveInsightSummary AWS API Documentation
2645
3308
  #
2646
3309
  class ReactiveInsightSummary < Struct.new(
@@ -2650,7 +3313,8 @@ module Aws::DevOpsGuru
2650
3313
  :status,
2651
3314
  :insight_time_range,
2652
3315
  :resource_collection,
2653
- :service_collection)
3316
+ :service_collection,
3317
+ :associated_resource_arns)
2654
3318
  SENSITIVE = []
2655
3319
  include Aws::Structure
2656
3320
  end
@@ -2675,7 +3339,13 @@ module Aws::DevOpsGuru
2675
3339
  # @return [String]
2676
3340
  #
2677
3341
  # @!attribute [rw] severity
2678
- # An array of severity values used to search for insights.
3342
+ # An array of severity values used to search for insights. For more
3343
+ # information, see [Understanding insight severities][1] in the
3344
+ # *Amazon DevOps Guru User Guide*.
3345
+ #
3346
+ #
3347
+ #
3348
+ # [1]: https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-insights.html#understanding-insights-severities
2679
3349
  # @return [String]
2680
3350
  #
2681
3351
  # @!attribute [rw] status
@@ -2689,10 +3359,12 @@ module Aws::DevOpsGuru
2689
3359
  #
2690
3360
  # @!attribute [rw] resource_collection
2691
3361
  # A collection of Amazon Web Services resources supported by DevOps
2692
- # Guru. The one type of Amazon Web Services resource collection
2693
- # supported is Amazon Web Services CloudFormation stacks. DevOps Guru
2694
- # can be configured to analyze only the Amazon Web Services resources
2695
- # that are defined in the stacks. You can specify up to 500 Amazon Web
3362
+ # Guru. The two types of Amazon Web Services resource collections
3363
+ # supported are Amazon Web Services CloudFormation stacks and Amazon
3364
+ # Web Services resources that contain the same Amazon Web Services
3365
+ # tag. DevOps Guru can be configured to analyze the Amazon Web
3366
+ # Services resources that are defined in the stacks or that are tagged
3367
+ # using the same tag *key*. You can specify up to 500 Amazon Web
2696
3368
  # Services CloudFormation stacks.
2697
3369
  # @return [Types::ResourceCollection]
2698
3370
  #
@@ -2772,11 +3444,17 @@ module Aws::DevOpsGuru
2772
3444
  # metrics.
2773
3445
  # @return [Array<Types::RecommendationRelatedAnomalySourceDetail>]
2774
3446
  #
3447
+ # @!attribute [rw] anomaly_id
3448
+ # The ID of an anomaly that generated the insight with this
3449
+ # recommendation.
3450
+ # @return [String]
3451
+ #
2775
3452
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/RecommendationRelatedAnomaly AWS API Documentation
2776
3453
  #
2777
3454
  class RecommendationRelatedAnomaly < Struct.new(
2778
3455
  :resources,
2779
- :source_details)
3456
+ :source_details,
3457
+ :anomaly_id)
2780
3458
  SENSITIVE = []
2781
3459
  include Aws::Structure
2782
3460
  end
@@ -2789,7 +3467,16 @@ module Aws::DevOpsGuru
2789
3467
  # @return [String]
2790
3468
  #
2791
3469
  # @!attribute [rw] type
2792
- # The type of the resource.
3470
+ # The type of the resource. Resource types take the same form that is
3471
+ # used by Amazon Web Services CloudFormation resource type
3472
+ # identifiers, `service-provider::service-name::data-type-name`. For
3473
+ # example, `AWS::RDS::DBCluster`. For more information, see [Amazon
3474
+ # Web Services resource and property types reference][1] in the
3475
+ # *Amazon Web Services CloudFormation User Guide*.
3476
+ #
3477
+ #
3478
+ #
3479
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html
2793
3480
  # @return [String]
2794
3481
  #
2795
3482
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/RecommendationRelatedAnomalyResource AWS API Documentation
@@ -2909,11 +3596,13 @@ module Aws::DevOpsGuru
2909
3596
  class RemoveNotificationChannelResponse < Aws::EmptyStructure; end
2910
3597
 
2911
3598
  # A collection of Amazon Web Services resources supported by DevOps
2912
- # Guru. The one type of Amazon Web Services resource collection
2913
- # supported is Amazon Web Services CloudFormation stacks. DevOps Guru
2914
- # can be configured to analyze only the Amazon Web Services resources
2915
- # that are defined in the stacks. You can specify up to 500 Amazon Web
2916
- # Services CloudFormation stacks.
3599
+ # Guru. The two types of Amazon Web Services resource collections
3600
+ # supported are Amazon Web Services CloudFormation stacks and Amazon Web
3601
+ # Services resources that contain the same Amazon Web Services tag.
3602
+ # DevOps Guru can be configured to analyze the Amazon Web Services
3603
+ # resources that are defined in the stacks or that are tagged using the
3604
+ # same tag *key*. You can specify up to 500 Amazon Web Services
3605
+ # CloudFormation stacks.
2917
3606
  #
2918
3607
  # @note When making an API call, you may pass ResourceCollection
2919
3608
  # data as a hash:
@@ -2922,6 +3611,12 @@ module Aws::DevOpsGuru
2922
3611
  # cloud_formation: {
2923
3612
  # stack_names: ["StackName"],
2924
3613
  # },
3614
+ # tags: [
3615
+ # {
3616
+ # app_boundary_key: "AppBoundaryKey", # required
3617
+ # tag_values: ["TagValue"], # required
3618
+ # },
3619
+ # ],
2925
3620
  # }
2926
3621
  #
2927
3622
  # @!attribute [rw] cloud_formation
@@ -2931,10 +3626,50 @@ module Aws::DevOpsGuru
2931
3626
  # CloudFormation stacks.
2932
3627
  # @return [Types::CloudFormationCollection]
2933
3628
  #
3629
+ # @!attribute [rw] tags
3630
+ # The Amazon Web Services tags that are used by resources in the
3631
+ # resource collection.
3632
+ #
3633
+ # Tags help you identify and organize your Amazon Web Services
3634
+ # resources. Many Amazon Web Services services support tagging, so you
3635
+ # can assign the same tag to resources from different services to
3636
+ # indicate that the resources are related. For example, you can assign
3637
+ # the same tag to an Amazon DynamoDB table resource that you assign to
3638
+ # an Lambda function. For more information about using tags, see the
3639
+ # [Tagging best practices][1] whitepaper.
3640
+ #
3641
+ # Each Amazon Web Services tag has two parts.
3642
+ #
3643
+ # * A tag *key* (for example, `CostCenter`, `Environment`, `Project`,
3644
+ # or `Secret`). Tag *keys* are case-sensitive.
3645
+ #
3646
+ # * An optional field known as a tag *value* (for example,
3647
+ # `111122223333`, `Production`, or a team name). Omitting the tag
3648
+ # *value* is the same as using an empty string. Like tag *keys*, tag
3649
+ # *values* are case-sensitive.
3650
+ #
3651
+ # Together these are known as *key*-*value* pairs.
3652
+ #
3653
+ # The string used for a *key* in a tag that you use to define your
3654
+ # resource coverage must begin with the prefix `Devops-guru-`. The tag
3655
+ # *key* might be `Devops-guru-deployment-application` or
3656
+ # `Devops-guru-rds-application`. While *keys* are case-sensitive, the
3657
+ # case of *key* characters don't matter to DevOps Guru. For example,
3658
+ # DevOps Guru works with a *key* named `devops-guru-rds` and a *key*
3659
+ # named `DevOps-Guru-RDS`. Possible *key*/*value* pairs in your
3660
+ # application might be `Devops-Guru-production-application/RDS` or
3661
+ # `Devops-Guru-production-application/containers`.
3662
+ #
3663
+ #
3664
+ #
3665
+ # [1]: https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf
3666
+ # @return [Array<Types::TagCollection>]
3667
+ #
2934
3668
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ResourceCollection AWS API Documentation
2935
3669
  #
2936
3670
  class ResourceCollection < Struct.new(
2937
- :cloud_formation)
3671
+ :cloud_formation,
3672
+ :tags)
2938
3673
  SENSITIVE = []
2939
3674
  include Aws::Structure
2940
3675
  end
@@ -2953,10 +3688,50 @@ module Aws::DevOpsGuru
2953
3688
  # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html
2954
3689
  # @return [Types::CloudFormationCollectionFilter]
2955
3690
  #
3691
+ # @!attribute [rw] tags
3692
+ # The Amazon Web Services tags used to filter the resources in the
3693
+ # resource collection.
3694
+ #
3695
+ # Tags help you identify and organize your Amazon Web Services
3696
+ # resources. Many Amazon Web Services services support tagging, so you
3697
+ # can assign the same tag to resources from different services to
3698
+ # indicate that the resources are related. For example, you can assign
3699
+ # the same tag to an Amazon DynamoDB table resource that you assign to
3700
+ # an Lambda function. For more information about using tags, see the
3701
+ # [Tagging best practices][1] whitepaper.
3702
+ #
3703
+ # Each Amazon Web Services tag has two parts.
3704
+ #
3705
+ # * A tag *key* (for example, `CostCenter`, `Environment`, `Project`,
3706
+ # or `Secret`). Tag *keys* are case-sensitive.
3707
+ #
3708
+ # * An optional field known as a tag *value* (for example,
3709
+ # `111122223333`, `Production`, or a team name). Omitting the tag
3710
+ # *value* is the same as using an empty string. Like tag *keys*, tag
3711
+ # *values* are case-sensitive.
3712
+ #
3713
+ # Together these are known as *key*-*value* pairs.
3714
+ #
3715
+ # The string used for a *key* in a tag that you use to define your
3716
+ # resource coverage must begin with the prefix `Devops-guru-`. The tag
3717
+ # *key* might be `Devops-guru-deployment-application` or
3718
+ # `Devops-guru-rds-application`. While *keys* are case-sensitive, the
3719
+ # case of *key* characters don't matter to DevOps Guru. For example,
3720
+ # DevOps Guru works with a *key* named `devops-guru-rds` and a *key*
3721
+ # named `DevOps-Guru-RDS`. Possible *key*/*value* pairs in your
3722
+ # application might be `Devops-Guru-production-application/RDS` or
3723
+ # `Devops-Guru-production-application/containers`.
3724
+ #
3725
+ #
3726
+ #
3727
+ # [1]: https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf
3728
+ # @return [Array<Types::TagCollectionFilter>]
3729
+ #
2956
3730
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ResourceCollectionFilter AWS API Documentation
2957
3731
  #
2958
3732
  class ResourceCollectionFilter < Struct.new(
2959
- :cloud_formation)
3733
+ :cloud_formation,
3734
+ :tags)
2960
3735
  SENSITIVE = []
2961
3736
  include Aws::Structure
2962
3737
  end
@@ -2998,6 +3773,12 @@ module Aws::DevOpsGuru
2998
3773
  # cloud_formation: {
2999
3774
  # stack_names: ["StackName"],
3000
3775
  # },
3776
+ # tags: [
3777
+ # {
3778
+ # app_boundary_key: "AppBoundaryKey", # required
3779
+ # tag_values: ["TagValue"], # required
3780
+ # },
3781
+ # ],
3001
3782
  # },
3002
3783
  # service_collection: {
3003
3784
  # service_names: ["API_GATEWAY"], # accepts API_GATEWAY, APPLICATION_ELB, AUTO_SCALING_GROUP, CLOUD_FRONT, DYNAMO_DB, EC2, ECS, EKS, ELASTIC_BEANSTALK, ELASTI_CACHE, ELB, ES, KINESIS, LAMBDA, NAT_GATEWAY, NETWORK_ELB, RDS, REDSHIFT, ROUTE_53, S3, SAGE_MAKER, SNS, SQS, STEP_FUNCTIONS, SWF
@@ -3014,10 +3795,12 @@ module Aws::DevOpsGuru
3014
3795
  #
3015
3796
  # @!attribute [rw] resource_collection
3016
3797
  # A collection of Amazon Web Services resources supported by DevOps
3017
- # Guru. The one type of Amazon Web Services resource collection
3018
- # supported is Amazon Web Services CloudFormation stacks. DevOps Guru
3019
- # can be configured to analyze only the Amazon Web Services resources
3020
- # that are defined in the stacks. You can specify up to 500 Amazon Web
3798
+ # Guru. The two types of Amazon Web Services resource collections
3799
+ # supported are Amazon Web Services CloudFormation stacks and Amazon
3800
+ # Web Services resources that contain the same Amazon Web Services
3801
+ # tag. DevOps Guru can be configured to analyze the Amazon Web
3802
+ # Services resources that are defined in the stacks or that are tagged
3803
+ # using the same tag *key*. You can specify up to 500 Amazon Web
3021
3804
  # Services CloudFormation stacks.
3022
3805
  # @return [Types::ResourceCollection]
3023
3806
  #
@@ -3051,6 +3834,12 @@ module Aws::DevOpsGuru
3051
3834
  # cloud_formation: {
3052
3835
  # stack_names: ["StackName"],
3053
3836
  # },
3837
+ # tags: [
3838
+ # {
3839
+ # app_boundary_key: "AppBoundaryKey", # required
3840
+ # tag_values: ["TagValue"], # required
3841
+ # },
3842
+ # ],
3054
3843
  # },
3055
3844
  # service_collection: {
3056
3845
  # service_names: ["API_GATEWAY"], # accepts API_GATEWAY, APPLICATION_ELB, AUTO_SCALING_GROUP, CLOUD_FRONT, DYNAMO_DB, EC2, ECS, EKS, ELASTIC_BEANSTALK, ELASTI_CACHE, ELB, ES, KINESIS, LAMBDA, NAT_GATEWAY, NETWORK_ELB, RDS, REDSHIFT, ROUTE_53, S3, SAGE_MAKER, SNS, SQS, STEP_FUNCTIONS, SWF
@@ -3135,6 +3924,12 @@ module Aws::DevOpsGuru
3135
3924
  # cloud_formation: {
3136
3925
  # stack_names: ["StackName"],
3137
3926
  # },
3927
+ # tags: [
3928
+ # {
3929
+ # app_boundary_key: "AppBoundaryKey", # required
3930
+ # tag_values: ["TagValue"], # required
3931
+ # },
3932
+ # ],
3138
3933
  # },
3139
3934
  # service_collection: {
3140
3935
  # service_names: ["API_GATEWAY"], # accepts API_GATEWAY, APPLICATION_ELB, AUTO_SCALING_GROUP, CLOUD_FRONT, DYNAMO_DB, EC2, ECS, EKS, ELASTIC_BEANSTALK, ELASTI_CACHE, ELB, ES, KINESIS, LAMBDA, NAT_GATEWAY, NETWORK_ELB, RDS, REDSHIFT, ROUTE_53, S3, SAGE_MAKER, SNS, SQS, STEP_FUNCTIONS, SWF
@@ -3151,10 +3946,12 @@ module Aws::DevOpsGuru
3151
3946
  #
3152
3947
  # @!attribute [rw] resource_collection
3153
3948
  # A collection of Amazon Web Services resources supported by DevOps
3154
- # Guru. The one type of Amazon Web Services resource collection
3155
- # supported is Amazon Web Services CloudFormation stacks. DevOps Guru
3156
- # can be configured to analyze only the Amazon Web Services resources
3157
- # that are defined in the stacks. You can specify up to 500 Amazon Web
3949
+ # Guru. The two types of Amazon Web Services resource collections
3950
+ # supported are Amazon Web Services CloudFormation stacks and Amazon
3951
+ # Web Services resources that contain the same Amazon Web Services
3952
+ # tag. DevOps Guru can be configured to analyze the Amazon Web
3953
+ # Services resources that are defined in the stacks or that are tagged
3954
+ # using the same tag *key*. You can specify up to 500 Amazon Web
3158
3955
  # Services CloudFormation stacks.
3159
3956
  # @return [Types::ResourceCollection]
3160
3957
  #
@@ -3189,6 +3986,12 @@ module Aws::DevOpsGuru
3189
3986
  # cloud_formation: {
3190
3987
  # stack_names: ["StackName"],
3191
3988
  # },
3989
+ # tags: [
3990
+ # {
3991
+ # app_boundary_key: "AppBoundaryKey", # required
3992
+ # tag_values: ["TagValue"], # required
3993
+ # },
3994
+ # ],
3192
3995
  # },
3193
3996
  # service_collection: {
3194
3997
  # service_names: ["API_GATEWAY"], # accepts API_GATEWAY, APPLICATION_ELB, AUTO_SCALING_GROUP, CLOUD_FRONT, DYNAMO_DB, EC2, ECS, EKS, ELASTIC_BEANSTALK, ELASTI_CACHE, ELB, ES, KINESIS, LAMBDA, NAT_GATEWAY, NETWORK_ELB, RDS, REDSHIFT, ROUTE_53, S3, SAGE_MAKER, SNS, SQS, STEP_FUNCTIONS, SWF
@@ -3464,6 +4267,12 @@ module Aws::DevOpsGuru
3464
4267
  # cloud_formation: {
3465
4268
  # stack_names: ["StackName"],
3466
4269
  # },
4270
+ # tags: [
4271
+ # {
4272
+ # app_boundary_key: "AppBoundaryKey", # required
4273
+ # tag_values: ["TagValue"], # required
4274
+ # },
4275
+ # ],
3467
4276
  # },
3468
4277
  # client_token: "ClientToken",
3469
4278
  # }
@@ -3521,6 +4330,234 @@ module Aws::DevOpsGuru
3521
4330
  include Aws::Structure
3522
4331
  end
3523
4332
 
4333
+ # A collection of Amazon Web Services stags.
4334
+ #
4335
+ # Tags help you identify and organize your Amazon Web Services
4336
+ # resources. Many Amazon Web Services services support tagging, so you
4337
+ # can assign the same tag to resources from different services to
4338
+ # indicate that the resources are related. For example, you can assign
4339
+ # the same tag to an Amazon DynamoDB table resource that you assign to
4340
+ # an Lambda function. For more information about using tags, see the
4341
+ # [Tagging best practices][1] whitepaper.
4342
+ #
4343
+ # Each Amazon Web Services tag has two parts.
4344
+ #
4345
+ # * A tag *key* (for example, `CostCenter`, `Environment`, `Project`, or
4346
+ # `Secret`). Tag *keys* are case-sensitive.
4347
+ #
4348
+ # * An optional field known as a tag *value* (for example,
4349
+ # `111122223333`, `Production`, or a team name). Omitting the tag
4350
+ # *value* is the same as using an empty string. Like tag *keys*, tag
4351
+ # *values* are case-sensitive.
4352
+ #
4353
+ # Together these are known as *key*-*value* pairs.
4354
+ #
4355
+ # The string used for a *key* in a tag that you use to define your
4356
+ # resource coverage must begin with the prefix `Devops-guru-`. The tag
4357
+ # *key* might be `Devops-guru-deployment-application` or
4358
+ # `Devops-guru-rds-application`. While *keys* are case-sensitive, the
4359
+ # case of *key* characters don't matter to DevOps Guru. For example,
4360
+ # DevOps Guru works with a *key* named `devops-guru-rds` and a *key*
4361
+ # named `DevOps-Guru-RDS`. Possible *key*/*value* pairs in your
4362
+ # application might be `Devops-Guru-production-application/RDS` or
4363
+ # `Devops-Guru-production-application/containers`.
4364
+ #
4365
+ #
4366
+ #
4367
+ # [1]: https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf
4368
+ #
4369
+ # @note When making an API call, you may pass TagCollection
4370
+ # data as a hash:
4371
+ #
4372
+ # {
4373
+ # app_boundary_key: "AppBoundaryKey", # required
4374
+ # tag_values: ["TagValue"], # required
4375
+ # }
4376
+ #
4377
+ # @!attribute [rw] app_boundary_key
4378
+ # An Amazon Web Services tag *key* that is used to identify the Amazon
4379
+ # Web Services resources that DevOps Guru analyzes. All Amazon Web
4380
+ # Services resources in your account and Region tagged with this *key*
4381
+ # make up your DevOps Guru application and analysis boundary.
4382
+ #
4383
+ # The string used for a *key* in a tag that you use to define your
4384
+ # resource coverage must begin with the prefix `Devops-guru-`. The tag
4385
+ # *key* might be `Devops-guru-deployment-application` or
4386
+ # `Devops-guru-rds-application`. While *keys* are case-sensitive, the
4387
+ # case of *key* characters don't matter to DevOps Guru. For example,
4388
+ # DevOps Guru works with a *key* named `devops-guru-rds` and a *key*
4389
+ # named `DevOps-Guru-RDS`. Possible *key*/*value* pairs in your
4390
+ # application might be `Devops-Guru-production-application/RDS` or
4391
+ # `Devops-Guru-production-application/containers`.
4392
+ # @return [String]
4393
+ #
4394
+ # @!attribute [rw] tag_values
4395
+ # The values in an Amazon Web Services tag collection.
4396
+ #
4397
+ # The tag's *value* is an optional field used to associate a string
4398
+ # with the tag *key* (for example, `111122223333`, `Production`, or a
4399
+ # team name). The *key* and *value* are the tag's *key* pair.
4400
+ # Omitting the tag *value* is the same as using an empty string. Like
4401
+ # tag *keys*, tag *values* are case-sensitive. You can specify a
4402
+ # maximum of 256 characters for a tag value.
4403
+ # @return [Array<String>]
4404
+ #
4405
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/TagCollection AWS API Documentation
4406
+ #
4407
+ class TagCollection < Struct.new(
4408
+ :app_boundary_key,
4409
+ :tag_values)
4410
+ SENSITIVE = []
4411
+ include Aws::Structure
4412
+ end
4413
+
4414
+ # A collection of Amazon Web Services tags used to filter insights. This
4415
+ # is used to return insights generated from only resources that contain
4416
+ # the tags in the tag collection.
4417
+ #
4418
+ # @!attribute [rw] app_boundary_key
4419
+ # An Amazon Web Services tag *key* that is used to identify the Amazon
4420
+ # Web Services resources that DevOps Guru analyzes. All Amazon Web
4421
+ # Services resources in your account and Region tagged with this *key*
4422
+ # make up your DevOps Guru application and analysis boundary.
4423
+ #
4424
+ # The string used for a *key* in a tag that you use to define your
4425
+ # resource coverage must begin with the prefix `Devops-guru-`. The tag
4426
+ # *key* might be `Devops-guru-deployment-application` or
4427
+ # `Devops-guru-rds-application`. While *keys* are case-sensitive, the
4428
+ # case of *key* characters don't matter to DevOps Guru. For example,
4429
+ # DevOps Guru works with a *key* named `devops-guru-rds` and a *key*
4430
+ # named `DevOps-Guru-RDS`. Possible *key*/*value* pairs in your
4431
+ # application might be `Devops-Guru-production-application/RDS` or
4432
+ # `Devops-Guru-production-application/containers`.
4433
+ # @return [String]
4434
+ #
4435
+ # @!attribute [rw] tag_values
4436
+ # The values in an Amazon Web Services tag collection.
4437
+ #
4438
+ # The tag's *value* is an optional field used to associate a string
4439
+ # with the tag *key* (for example, `111122223333`, `Production`, or a
4440
+ # team name). The *key* and *value* are the tag's *key* pair.
4441
+ # Omitting the tag *value* is the same as using an empty string. Like
4442
+ # tag *keys*, tag *values* are case-sensitive. You can specify a
4443
+ # maximum of 256 characters for a tag value.
4444
+ # @return [Array<String>]
4445
+ #
4446
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/TagCollectionFilter AWS API Documentation
4447
+ #
4448
+ class TagCollectionFilter < Struct.new(
4449
+ :app_boundary_key,
4450
+ :tag_values)
4451
+ SENSITIVE = []
4452
+ include Aws::Structure
4453
+ end
4454
+
4455
+ # Information about a collection of Amazon Web Services resources that
4456
+ # are identified by an Amazon Web Services tag. This collection of
4457
+ # resources is used to create a monthly cost estimate for DevOps Guru to
4458
+ # analyze Amazon Web Services resources. The maximum number of tags you
4459
+ # can specify for a cost estimate is one. The estimate created is for
4460
+ # the cost to analyze the Amazon Web Services resources defined by the
4461
+ # tag. For more information, see [Stacks][1] in the *Amazon Web Services
4462
+ # CloudFormation User Guide*.
4463
+ #
4464
+ #
4465
+ #
4466
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html
4467
+ #
4468
+ # @note When making an API call, you may pass TagCostEstimationResourceCollectionFilter
4469
+ # data as a hash:
4470
+ #
4471
+ # {
4472
+ # app_boundary_key: "AppBoundaryKey", # required
4473
+ # tag_values: ["TagValue"], # required
4474
+ # }
4475
+ #
4476
+ # @!attribute [rw] app_boundary_key
4477
+ # An Amazon Web Services tag *key* that is used to identify the Amazon
4478
+ # Web Services resources that DevOps Guru analyzes. All Amazon Web
4479
+ # Services resources in your account and Region tagged with this *key*
4480
+ # make up your DevOps Guru application and analysis boundary.
4481
+ #
4482
+ # The string used for a *key* in a tag that you use to define your
4483
+ # resource coverage must begin with the prefix `Devops-guru-`. The tag
4484
+ # *key* might be `Devops-guru-deployment-application` or
4485
+ # `Devops-guru-rds-application`. While *keys* are case-sensitive, the
4486
+ # case of *key* characters don't matter to DevOps Guru. For example,
4487
+ # DevOps Guru works with a *key* named `devops-guru-rds` and a *key*
4488
+ # named `DevOps-Guru-RDS`. Possible *key*/*value* pairs in your
4489
+ # application might be `Devops-Guru-production-application/RDS` or
4490
+ # `Devops-Guru-production-application/containers`.
4491
+ # @return [String]
4492
+ #
4493
+ # @!attribute [rw] tag_values
4494
+ # The values in an Amazon Web Services tag collection.
4495
+ #
4496
+ # The tag's *value* is an optional field used to associate a string
4497
+ # with the tag *key* (for example, `111122223333`, `Production`, or a
4498
+ # team name). The *key* and *value* are the tag's *key* pair.
4499
+ # Omitting the tag *value* is the same as using an empty string. Like
4500
+ # tag *keys*, tag *values* are case-sensitive. You can specify a
4501
+ # maximum of 256 characters for a tag value.
4502
+ # @return [Array<String>]
4503
+ #
4504
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/TagCostEstimationResourceCollectionFilter AWS API Documentation
4505
+ #
4506
+ class TagCostEstimationResourceCollectionFilter < Struct.new(
4507
+ :app_boundary_key,
4508
+ :tag_values)
4509
+ SENSITIVE = []
4510
+ include Aws::Structure
4511
+ end
4512
+
4513
+ # Information about the health of Amazon Web Services resources in your
4514
+ # account that are specified by an Amazon Web Services tag *key*.
4515
+ #
4516
+ # @!attribute [rw] app_boundary_key
4517
+ # An Amazon Web Services tag *key* that is used to identify the Amazon
4518
+ # Web Services resources that DevOps Guru analyzes. All Amazon Web
4519
+ # Services resources in your account and Region tagged with this *key*
4520
+ # make up your DevOps Guru application and analysis boundary.
4521
+ #
4522
+ # The string used for a *key* in a tag that you use to define your
4523
+ # resource coverage must begin with the prefix `Devops-guru-`. The tag
4524
+ # *key* might be `Devops-guru-deployment-application` or
4525
+ # `Devops-guru-rds-application`. While *keys* are case-sensitive, the
4526
+ # case of *key* characters don't matter to DevOps Guru. For example,
4527
+ # DevOps Guru works with a *key* named `devops-guru-rds` and a *key*
4528
+ # named `DevOps-Guru-RDS`. Possible *key*/*value* pairs in your
4529
+ # application might be `Devops-Guru-production-application/RDS` or
4530
+ # `Devops-Guru-production-application/containers`.
4531
+ # @return [String]
4532
+ #
4533
+ # @!attribute [rw] tag_value
4534
+ # The value in an Amazon Web Services tag.
4535
+ #
4536
+ # The tag's *value* is an optional field used to associate a string
4537
+ # with the tag *key* (for example, `111122223333`, `Production`, or a
4538
+ # team name). The *key* and *value* are the tag's *key* pair.
4539
+ # Omitting the tag *value* is the same as using an empty string. Like
4540
+ # tag *keys*, tag *values* are case-sensitive. You can specify a
4541
+ # maximum of 256 characters for a tag value.
4542
+ # @return [String]
4543
+ #
4544
+ # @!attribute [rw] insight
4545
+ # Information about the health of the Amazon Web Services resources in
4546
+ # your account that are specified by an Amazon Web Services tag,
4547
+ # including the number of open proactive, open reactive insights, and
4548
+ # the Mean Time to Recover (MTTR) of closed insights.
4549
+ # @return [Types::InsightHealth]
4550
+ #
4551
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/TagHealth AWS API Documentation
4552
+ #
4553
+ class TagHealth < Struct.new(
4554
+ :app_boundary_key,
4555
+ :tag_value,
4556
+ :insight)
4557
+ SENSITIVE = []
4558
+ include Aws::Structure
4559
+ end
4560
+
3524
4561
  # The request was denied due to a request throttling.
3525
4562
  #
3526
4563
  # @!attribute [rw] message
@@ -3605,17 +4642,63 @@ module Aws::DevOpsGuru
3605
4642
  # cloud_formation: {
3606
4643
  # stack_names: ["StackName"],
3607
4644
  # },
4645
+ # tags: [
4646
+ # {
4647
+ # app_boundary_key: "AppBoundaryKey", # required
4648
+ # tag_values: ["TagValue"], # required
4649
+ # },
4650
+ # ],
3608
4651
  # }
3609
4652
  #
3610
4653
  # @!attribute [rw] cloud_formation
3611
- # An collection of Amazon Web Services CloudFormation stacks. You can
4654
+ # A collection of Amazon Web Services CloudFormation stacks. You can
3612
4655
  # specify up to 500 Amazon Web Services CloudFormation stacks.
3613
4656
  # @return [Types::UpdateCloudFormationCollectionFilter]
3614
4657
  #
4658
+ # @!attribute [rw] tags
4659
+ # The updated Amazon Web Services tags used to filter the resources in
4660
+ # the resource collection.
4661
+ #
4662
+ # Tags help you identify and organize your Amazon Web Services
4663
+ # resources. Many Amazon Web Services services support tagging, so you
4664
+ # can assign the same tag to resources from different services to
4665
+ # indicate that the resources are related. For example, you can assign
4666
+ # the same tag to an Amazon DynamoDB table resource that you assign to
4667
+ # an Lambda function. For more information about using tags, see the
4668
+ # [Tagging best practices][1] whitepaper.
4669
+ #
4670
+ # Each Amazon Web Services tag has two parts.
4671
+ #
4672
+ # * A tag *key* (for example, `CostCenter`, `Environment`, `Project`,
4673
+ # or `Secret`). Tag *keys* are case-sensitive.
4674
+ #
4675
+ # * An optional field known as a tag *value* (for example,
4676
+ # `111122223333`, `Production`, or a team name). Omitting the tag
4677
+ # *value* is the same as using an empty string. Like tag *keys*, tag
4678
+ # *values* are case-sensitive.
4679
+ #
4680
+ # Together these are known as *key*-*value* pairs.
4681
+ #
4682
+ # The string used for a *key* in a tag that you use to define your
4683
+ # resource coverage must begin with the prefix `Devops-guru-`. The tag
4684
+ # *key* might be `Devops-guru-deployment-application` or
4685
+ # `Devops-guru-rds-application`. While *keys* are case-sensitive, the
4686
+ # case of *key* characters don't matter to DevOps Guru. For example,
4687
+ # DevOps Guru works with a *key* named `devops-guru-rds` and a *key*
4688
+ # named `DevOps-Guru-RDS`. Possible *key*/*value* pairs in your
4689
+ # application might be `Devops-Guru-production-application/RDS` or
4690
+ # `Devops-Guru-production-application/containers`.
4691
+ #
4692
+ #
4693
+ #
4694
+ # [1]: https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf
4695
+ # @return [Array<Types::UpdateTagCollectionFilter>]
4696
+ #
3615
4697
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/UpdateResourceCollectionFilter AWS API Documentation
3616
4698
  #
3617
4699
  class UpdateResourceCollectionFilter < Struct.new(
3618
- :cloud_formation)
4700
+ :cloud_formation,
4701
+ :tags)
3619
4702
  SENSITIVE = []
3620
4703
  include Aws::Structure
3621
4704
  end
@@ -3629,6 +4712,12 @@ module Aws::DevOpsGuru
3629
4712
  # cloud_formation: {
3630
4713
  # stack_names: ["StackName"],
3631
4714
  # },
4715
+ # tags: [
4716
+ # {
4717
+ # app_boundary_key: "AppBoundaryKey", # required
4718
+ # tag_values: ["TagValue"], # required
4719
+ # },
4720
+ # ],
3632
4721
  # },
3633
4722
  # }
3634
4723
  #
@@ -3711,6 +4800,54 @@ module Aws::DevOpsGuru
3711
4800
  #
3712
4801
  class UpdateServiceIntegrationResponse < Aws::EmptyStructure; end
3713
4802
 
4803
+ # A new collection of Amazon Web Services resources that are defined by
4804
+ # an Amazon Web Services tag or tag *key*/*value* pair.
4805
+ #
4806
+ # @note When making an API call, you may pass UpdateTagCollectionFilter
4807
+ # data as a hash:
4808
+ #
4809
+ # {
4810
+ # app_boundary_key: "AppBoundaryKey", # required
4811
+ # tag_values: ["TagValue"], # required
4812
+ # }
4813
+ #
4814
+ # @!attribute [rw] app_boundary_key
4815
+ # An Amazon Web Services tag *key* that is used to identify the Amazon
4816
+ # Web Services resources that DevOps Guru analyzes. All Amazon Web
4817
+ # Services resources in your account and Region tagged with this *key*
4818
+ # make up your DevOps Guru application and analysis boundary.
4819
+ #
4820
+ # The string used for a *key* in a tag that you use to define your
4821
+ # resource coverage must begin with the prefix `Devops-guru-`. The tag
4822
+ # *key* might be `Devops-guru-deployment-application` or
4823
+ # `Devops-guru-rds-application`. While *keys* are case-sensitive, the
4824
+ # case of *key* characters don't matter to DevOps Guru. For example,
4825
+ # DevOps Guru works with a *key* named `devops-guru-rds` and a *key*
4826
+ # named `DevOps-Guru-RDS`. Possible *key*/*value* pairs in your
4827
+ # application might be `Devops-Guru-production-application/RDS` or
4828
+ # `Devops-Guru-production-application/containers`.
4829
+ # @return [String]
4830
+ #
4831
+ # @!attribute [rw] tag_values
4832
+ # The values in an Amazon Web Services tag collection.
4833
+ #
4834
+ # The tag's *value* is an optional field used to associate a string
4835
+ # with the tag *key* (for example, `111122223333`, `Production`, or a
4836
+ # team name). The *key* and *value* are the tag's *key* pair.
4837
+ # Omitting the tag *value* is the same as using an empty string. Like
4838
+ # tag *keys*, tag *values* are case-sensitive. You can specify a
4839
+ # maximum of 256 characters for a tag value.
4840
+ # @return [Array<String>]
4841
+ #
4842
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/UpdateTagCollectionFilter AWS API Documentation
4843
+ #
4844
+ class UpdateTagCollectionFilter < Struct.new(
4845
+ :app_boundary_key,
4846
+ :tag_values)
4847
+ SENSITIVE = []
4848
+ include Aws::Structure
4849
+ end
4850
+
3714
4851
  # Contains information about data passed in to a field during a request
3715
4852
  # that is not valid.
3716
4853
  #