aws-sdk-devopsguru 1.16.0 → 1.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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
  #