aws-sdk-internetmonitor 1.7.0 → 1.9.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: b8e075459bdf44c48cbac221944a7b21e6edf7769167ca5ffbe101c387eb86d2
4
- data.tar.gz: 41e249ab9a1efb2f080df87dca0f54f77eded2b164380cf7e3222c5d423315f5
3
+ metadata.gz: 30db1a4f38d1e7ea5b9e11c9d22d8eb4c790b675173d3665ccfb45f71bf1de3e
4
+ data.tar.gz: d8a992c640568415b9715a3b41bc3faf2e7cf8634a7ed6d17773c1473d994472
5
5
  SHA512:
6
- metadata.gz: fa3cda4783f9bf7382027c4ff0b00b0e204afab28f98ab1adaad7426486e04897bfeda5fc56c8205b3d112e99cda1b09a96f14282dcff6fe2e0b0dccae9f9f79
7
- data.tar.gz: 597e751840f69c1f71ea30cb5e60d84cb96f1820a00b43bfd4dd3840006a1efbae161f2f51ab42c0db4c972e16c0af1a5401c3c765f93170627dd49c3e03ed54
6
+ metadata.gz: d9a3da4b7f674d3e6f84fcd0c2d314ec777565f55ccd70d6abb0d56b531f8ff9e8c99f729e92406a6b6aa3886481ea76eec723876ff721ad60c20760f3cf19a9
7
+ data.tar.gz: e81fbf0f89ce0a2d45fb3aab5d1184bd7b2a32194736270d94e8f5070904e39a2676242480df0ea43f9c2d4fc74ccf9c7d4129f297b546dac114ae2b686fe242
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.9.0 (2023-09-13)
5
+ ------------------
6
+
7
+ * Feature - This release updates the Amazon CloudWatch Internet Monitor API domain name.
8
+
9
+ 1.8.0 (2023-08-01)
10
+ ------------------
11
+
12
+ * Feature - This release adds a new feature for Amazon CloudWatch Internet Monitor that enables customers to set custom thresholds, for performance and availability drops, for impact limited to a single city-network to trigger creation of a health event.
13
+
4
14
  1.7.0 (2023-07-11)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.7.0
1
+ 1.9.0
@@ -390,21 +390,23 @@ module Aws::InternetMonitor
390
390
 
391
391
  # Creates a monitor in Amazon CloudWatch Internet Monitor. A monitor is
392
392
  # built based on information from the application resources that you
393
- # add: Amazon Virtual Private Clouds (VPCs), Amazon CloudFront
394
- # distributions, and WorkSpaces directories. Internet Monitor then
395
- # publishes internet measurements from Amazon Web Services that are
396
- # specific to the *city-networks*, that is, the locations and ASNs
393
+ # add: VPCs, Network Load Balancers (NLBs), Amazon CloudFront
394
+ # distributions, and Amazon WorkSpaces directories. Internet Monitor
395
+ # then publishes internet measurements from Amazon Web Services that are
396
+ # specific to the *city-networks*. That is, the locations and ASNs
397
397
  # (typically internet service providers or ISPs), where clients access
398
398
  # your application. For more information, see [Using Amazon CloudWatch
399
399
  # Internet Monitor][1] in the *Amazon CloudWatch User Guide*.
400
400
  #
401
- # When you create a monitor, you set a maximum limit for the number of
402
- # city-networks where client traffic is monitored. The city-network
403
- # maximum that you choose is the limit, but you only pay for the number
404
- # of city-networks that are actually monitored. You can change the
405
- # maximum at any time by updating your monitor. For more information,
406
- # see [Choosing a city-network maximum value][2] in the *Amazon
407
- # CloudWatch User Guide*.
401
+ # When you create a monitor, you choose the percentage of traffic that
402
+ # you want to monitor. You can also set a maximum limit for the number
403
+ # of city-networks where client traffic is monitored, that caps the
404
+ # total traffic that Internet Monitor monitors. A city-network maximum
405
+ # is the limit of city-networks, but you only pay for the number of
406
+ # city-networks that are actually monitored. You can update your monitor
407
+ # at any time to change the percentage of traffic to monitor or the
408
+ # city-networks maximum. For more information, see [Choosing a
409
+ # city-network maximum value][2] in the *Amazon CloudWatch User Guide*.
408
410
  #
409
411
  #
410
412
  #
@@ -416,14 +418,15 @@ module Aws::InternetMonitor
416
418
  #
417
419
  # @option params [Array<String>] :resources
418
420
  # The resources to include in a monitor, which you provide as a set of
419
- # Amazon Resource Names (ARNs).
421
+ # Amazon Resource Names (ARNs). Resources can be VPCs, NLBs, Amazon
422
+ # CloudFront distributions, or Amazon WorkSpaces directories.
420
423
  #
421
- # You can add a combination of Amazon Virtual Private Clouds (VPCs) and
422
- # Amazon CloudFront distributions, or you can add Amazon WorkSpaces
423
- # directories. You can't add all three types of resources.
424
+ # You can add a combination of VPCs and CloudFront distributions, or you
425
+ # can add WorkSpaces directories, or you can add NLBs. You can't add
426
+ # NLBs or WorkSpaces directories together with any other resources.
424
427
  #
425
- # <note markdown="1"> If you add only VPC resources, at least one VPC must have an Internet
426
- # Gateway attached to it, to make sure that it has internet
428
+ # <note markdown="1"> If you add only Amazon VPC resources, at least one VPC must have an
429
+ # Internet Gateway attached to it, to make sure that it has internet
427
430
  # connectivity.
428
431
  #
429
432
  # </note>
@@ -443,9 +446,9 @@ module Aws::InternetMonitor
443
446
  # @option params [Integer] :max_city_networks_to_monitor
444
447
  # The maximum number of city-networks to monitor for your resources. A
445
448
  # city-network is the location (city) where clients access your
446
- # application resources from and the network or ASN, such as an internet
447
- # service provider (ISP), that clients access the resources through.
448
- # This limit helps control billing costs.
449
+ # application resources from and the ASN or network provider, such as an
450
+ # internet service provider (ISP), that clients access the resources
451
+ # through. Setting this limit can help control billing costs.
449
452
  #
450
453
  # To learn more, see [Choosing a city-network maximum value ][1] in the
451
454
  # Amazon CloudWatch Internet Monitor section of the *CloudWatch User
@@ -461,14 +464,33 @@ module Aws::InternetMonitor
461
464
  #
462
465
  # @option params [Integer] :traffic_percentage_to_monitor
463
466
  # The percentage of the internet-facing traffic for your application
464
- # that you want to monitor with this monitor.
467
+ # that you want to monitor with this monitor. If you set a city-networks
468
+ # maximum, that limit overrides the traffic percentage that you set.
469
+ #
470
+ # To learn more, see [Choosing an application traffic percentage to
471
+ # monitor ][1] in the Amazon CloudWatch Internet Monitor section of the
472
+ # *CloudWatch User Guide*.
473
+ #
474
+ #
475
+ #
476
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMTrafficPercentage.html
465
477
  #
466
478
  # @option params [Types::HealthEventsConfig] :health_events_config
467
- # Defines the health event threshold percentages, for performance score
468
- # and availability score. Internet Monitor creates a health event when
469
- # there's an internet issue that affects your application end users
470
- # where a health score percentage is at or below a set threshold. If you
471
- # don't set a health event threshold, the default calue is 95%.
479
+ # Defines the threshold percentages and other configuration information
480
+ # for when Amazon CloudWatch Internet Monitor creates a health event.
481
+ # Internet Monitor creates a health event when an internet issue that
482
+ # affects your application end users has a health score percentage that
483
+ # is at or below a specific threshold, and, sometimes, when other
484
+ # criteria are met.
485
+ #
486
+ # If you don't set a health event threshold, the default value is 95%.
487
+ #
488
+ # For more information, see [ Change health event thresholds][1] in the
489
+ # Internet Monitor section of the *CloudWatch User Guide*.
490
+ #
491
+ #
492
+ #
493
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview
472
494
  #
473
495
  # @return [Types::CreateMonitorOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
474
496
  #
@@ -496,6 +518,16 @@ module Aws::InternetMonitor
496
518
  # health_events_config: {
497
519
  # availability_score_threshold: 1.0,
498
520
  # performance_score_threshold: 1.0,
521
+ # availability_local_health_events_config: {
522
+ # status: "ENABLED", # accepts ENABLED, DISABLED
523
+ # health_score_threshold: 1.0,
524
+ # min_traffic_impact: 1.0,
525
+ # },
526
+ # performance_local_health_events_config: {
527
+ # status: "ENABLED", # accepts ENABLED, DISABLED
528
+ # health_score_threshold: 1.0,
529
+ # min_traffic_impact: 1.0,
530
+ # },
499
531
  # },
500
532
  # })
501
533
  #
@@ -537,12 +569,12 @@ module Aws::InternetMonitor
537
569
 
538
570
  # Gets information the Amazon CloudWatch Internet Monitor has created
539
571
  # and stored about a health event for a specified monitor. This
540
- # information includes the impacted locations, and all of the
541
- # information related to the event by location.
572
+ # information includes the impacted locations, and all the information
573
+ # related to the event, by location.
542
574
  #
543
- # The information returned includes the performance, availability, and
544
- # round-trip time impact, information about the network providers, the
545
- # event type, and so on.
575
+ # The information returned includes the impact on performance,
576
+ # availability, and round-trip time, information about the network
577
+ # providers (ASNs), the event type, and so on.
546
578
  #
547
579
  # Information rolled up at the global traffic level is also returned,
548
580
  # including the impact type and total traffic impact.
@@ -615,7 +647,7 @@ module Aws::InternetMonitor
615
647
  # resp.impacted_locations[0].internet_health.performance.round_trip_time.p95 #=> Float
616
648
  # resp.status #=> String, one of "ACTIVE", "RESOLVED"
617
649
  # resp.percent_of_total_traffic_impacted #=> Float
618
- # resp.impact_type #=> String, one of "AVAILABILITY", "PERFORMANCE"
650
+ # resp.impact_type #=> String, one of "AVAILABILITY", "PERFORMANCE", "LOCAL_AVAILABILITY", "LOCAL_PERFORMANCE"
619
651
  # resp.health_score_threshold #=> Float
620
652
  #
621
653
  # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/GetHealthEvent AWS API Documentation
@@ -677,6 +709,12 @@ module Aws::InternetMonitor
677
709
  # resp.traffic_percentage_to_monitor #=> Integer
678
710
  # resp.health_events_config.availability_score_threshold #=> Float
679
711
  # resp.health_events_config.performance_score_threshold #=> Float
712
+ # resp.health_events_config.availability_local_health_events_config.status #=> String, one of "ENABLED", "DISABLED"
713
+ # resp.health_events_config.availability_local_health_events_config.health_score_threshold #=> Float
714
+ # resp.health_events_config.availability_local_health_events_config.min_traffic_impact #=> Float
715
+ # resp.health_events_config.performance_local_health_events_config.status #=> String, one of "ENABLED", "DISABLED"
716
+ # resp.health_events_config.performance_local_health_events_config.health_score_threshold #=> Float
717
+ # resp.health_events_config.performance_local_health_events_config.min_traffic_impact #=> Float
680
718
  #
681
719
  # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/GetMonitor AWS API Documentation
682
720
  #
@@ -688,9 +726,8 @@ module Aws::InternetMonitor
688
726
  end
689
727
 
690
728
  # Lists all health events for a monitor in Amazon CloudWatch Internet
691
- # Monitor. Returns all information for health events including the
692
- # client location information the network cause and status, event start
693
- # and end time, percentage of total traffic impacted, and status.
729
+ # Monitor. Returns information for health events including the event
730
+ # start and end time and the status.
694
731
  #
695
732
  # <note markdown="1"> Health events that have start times during the time frame that is
696
733
  # requested are not included in the list of health events.
@@ -776,7 +813,7 @@ module Aws::InternetMonitor
776
813
  # resp.health_events[0].impacted_locations[0].internet_health.performance.round_trip_time.p95 #=> Float
777
814
  # resp.health_events[0].status #=> String, one of "ACTIVE", "RESOLVED"
778
815
  # resp.health_events[0].percent_of_total_traffic_impacted #=> Float
779
- # resp.health_events[0].impact_type #=> String, one of "AVAILABILITY", "PERFORMANCE"
816
+ # resp.health_events[0].impact_type #=> String, one of "AVAILABILITY", "PERFORMANCE", "LOCAL_AVAILABILITY", "LOCAL_PERFORMANCE"
780
817
  # resp.health_events[0].health_score_threshold #=> Float
781
818
  # resp.next_token #=> String
782
819
  #
@@ -935,10 +972,11 @@ module Aws::InternetMonitor
935
972
  req.send_request(options)
936
973
  end
937
974
 
938
- # Updates a monitor. You can update a monitor to change the maximum
939
- # number of city-networks (locations and ASNs or internet service
940
- # providers), to add or remove resources, or to change the status of the
941
- # monitor. Note that you can't change the name of a monitor.
975
+ # Updates a monitor. You can update a monitor to change the percentage
976
+ # of traffic to monitor or the maximum number of city-networks
977
+ # (locations and ASNs), to add or remove resources, or to change the
978
+ # status of the monitor. Note that you can't change the name of a
979
+ # monitor.
942
980
  #
943
981
  # The city-network maximum that you choose is the limit, but you only
944
982
  # pay for the number of city-networks that are actually monitored. For
@@ -954,15 +992,16 @@ module Aws::InternetMonitor
954
992
  #
955
993
  # @option params [Array<String>] :resources_to_add
956
994
  # The resources to include in a monitor, which you provide as a set of
957
- # Amazon Resource Names (ARNs).
995
+ # Amazon Resource Names (ARNs). Resources can be VPCs, NLBs, Amazon
996
+ # CloudFront distributions, or Amazon WorkSpaces directories.
958
997
  #
959
- # You can add a combination of Amazon Virtual Private Clouds (VPCs) and
960
- # Amazon CloudFront distributions, or you can add Amazon WorkSpaces
961
- # directories. You can't add all three types of resources.
998
+ # You can add a combination of VPCs and CloudFront distributions, or you
999
+ # can add WorkSpaces directories, or you can add NLBs. You can't add
1000
+ # NLBs or WorkSpaces directories together with any other resources.
962
1001
  #
963
- # <note markdown="1"> If you add only VPC resources, at least one VPC must have an Internet
964
- # Gateway attached to it, to make sure that it has internet
965
- # connectivity.
1002
+ # <note markdown="1"> If you add only Amazon Virtual Private Clouds resources, at least one
1003
+ # VPC must have an Internet Gateway attached to it, to make sure that it
1004
+ # has internet connectivity.
966
1005
  #
967
1006
  # </note>
968
1007
  #
@@ -984,10 +1023,11 @@ module Aws::InternetMonitor
984
1023
  # not need to pass this option.**
985
1024
  #
986
1025
  # @option params [Integer] :max_city_networks_to_monitor
987
- # The maximum number of city-networks to monitor for your resources. A
1026
+ # The maximum number of city-networks to monitor for your application. A
988
1027
  # city-network is the location (city) where clients access your
989
- # application resources from and the network or ASN, such as an internet
990
- # service provider, that clients access the resources through.
1028
+ # application resources from and the ASN or network provider, such as an
1029
+ # internet service provider (ISP), that clients access the resources
1030
+ # through. Setting this limit can help control billing costs.
991
1031
  #
992
1032
  # @option params [Types::InternetMeasurementsLogDelivery] :internet_measurements_log_delivery
993
1033
  # Publish internet measurements for Internet Monitor to another
@@ -996,13 +1036,29 @@ module Aws::InternetMonitor
996
1036
  #
997
1037
  # @option params [Integer] :traffic_percentage_to_monitor
998
1038
  # The percentage of the internet-facing traffic for your application
999
- # that you want to monitor with this monitor.
1039
+ # that you want to monitor with this monitor. If you set a city-networks
1040
+ # maximum, that limit overrides the traffic percentage that you set.
1041
+ #
1042
+ # To learn more, see [Choosing an application traffic percentage to
1043
+ # monitor ][1] in the Amazon CloudWatch Internet Monitor section of the
1044
+ # *CloudWatch User Guide*.
1045
+ #
1046
+ #
1047
+ #
1048
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMTrafficPercentage.html
1000
1049
  #
1001
1050
  # @option params [Types::HealthEventsConfig] :health_events_config
1002
- # The list of health event thresholds. A health event threshold
1003
- # percentage, for performance and availability, determines when Internet
1004
- # Monitor creates a health event when there's an internet issue that
1005
- # affects your application end users.
1051
+ # The list of health score thresholds. A threshold percentage for health
1052
+ # scores, along with other configuration information, determines when
1053
+ # Internet Monitor creates a health event when there's an internet
1054
+ # issue that affects your application end users.
1055
+ #
1056
+ # For more information, see [ Change health event thresholds][1] in the
1057
+ # Internet Monitor section of the *CloudWatch User Guide*.
1058
+ #
1059
+ #
1060
+ #
1061
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview
1006
1062
  #
1007
1063
  # @return [Types::UpdateMonitorOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1008
1064
  #
@@ -1029,6 +1085,16 @@ module Aws::InternetMonitor
1029
1085
  # health_events_config: {
1030
1086
  # availability_score_threshold: 1.0,
1031
1087
  # performance_score_threshold: 1.0,
1088
+ # availability_local_health_events_config: {
1089
+ # status: "ENABLED", # accepts ENABLED, DISABLED
1090
+ # health_score_threshold: 1.0,
1091
+ # min_traffic_impact: 1.0,
1092
+ # },
1093
+ # performance_local_health_events_config: {
1094
+ # status: "ENABLED", # accepts ENABLED, DISABLED
1095
+ # health_score_threshold: 1.0,
1096
+ # min_traffic_impact: 1.0,
1097
+ # },
1032
1098
  # },
1033
1099
  # })
1034
1100
  #
@@ -1059,7 +1125,7 @@ module Aws::InternetMonitor
1059
1125
  params: params,
1060
1126
  config: config)
1061
1127
  context[:gem_name] = 'aws-sdk-internetmonitor'
1062
- context[:gem_version] = '1.7.0'
1128
+ context[:gem_version] = '1.9.0'
1063
1129
  Seahorse::Client::Request.new(handlers, context)
1064
1130
  end
1065
1131
 
@@ -46,6 +46,8 @@ module Aws::InternetMonitor
46
46
  ListMonitorsOutput = Shapes::StructureShape.new(name: 'ListMonitorsOutput')
47
47
  ListTagsForResourceInput = Shapes::StructureShape.new(name: 'ListTagsForResourceInput')
48
48
  ListTagsForResourceOutput = Shapes::StructureShape.new(name: 'ListTagsForResourceOutput')
49
+ LocalHealthEventsConfig = Shapes::StructureShape.new(name: 'LocalHealthEventsConfig')
50
+ LocalHealthEventsConfigStatus = Shapes::StringShape.new(name: 'LocalHealthEventsConfigStatus')
49
51
  LogDeliveryStatus = Shapes::StringShape.new(name: 'LogDeliveryStatus')
50
52
  Long = Shapes::IntegerShape.new(name: 'Long')
51
53
  MaxCityNetworksToMonitor = Shapes::IntegerShape.new(name: 'MaxCityNetworksToMonitor')
@@ -170,6 +172,8 @@ module Aws::InternetMonitor
170
172
 
171
173
  HealthEventsConfig.add_member(:availability_score_threshold, Shapes::ShapeRef.new(shape: Percentage, location_name: "AvailabilityScoreThreshold"))
172
174
  HealthEventsConfig.add_member(:performance_score_threshold, Shapes::ShapeRef.new(shape: Percentage, location_name: "PerformanceScoreThreshold"))
175
+ HealthEventsConfig.add_member(:availability_local_health_events_config, Shapes::ShapeRef.new(shape: LocalHealthEventsConfig, location_name: "AvailabilityLocalHealthEventsConfig"))
176
+ HealthEventsConfig.add_member(:performance_local_health_events_config, Shapes::ShapeRef.new(shape: LocalHealthEventsConfig, location_name: "PerformanceLocalHealthEventsConfig"))
173
177
  HealthEventsConfig.struct_class = Types::HealthEventsConfig
174
178
 
175
179
  ImpactedLocation.add_member(:as_name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "ASName"))
@@ -233,6 +237,11 @@ module Aws::InternetMonitor
233
237
  ListTagsForResourceOutput.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
234
238
  ListTagsForResourceOutput.struct_class = Types::ListTagsForResourceOutput
235
239
 
240
+ LocalHealthEventsConfig.add_member(:status, Shapes::ShapeRef.new(shape: LocalHealthEventsConfigStatus, location_name: "Status"))
241
+ LocalHealthEventsConfig.add_member(:health_score_threshold, Shapes::ShapeRef.new(shape: Percentage, location_name: "HealthScoreThreshold"))
242
+ LocalHealthEventsConfig.add_member(:min_traffic_impact, Shapes::ShapeRef.new(shape: Percentage, location_name: "MinTrafficImpact"))
243
+ LocalHealthEventsConfig.struct_class = Types::LocalHealthEventsConfig
244
+
236
245
  Monitor.add_member(:monitor_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location_name: "MonitorName"))
237
246
  Monitor.add_member(:monitor_arn, Shapes::ShapeRef.new(shape: MonitorArn, required: true, location_name: "MonitorArn"))
238
247
  Monitor.add_member(:status, Shapes::ShapeRef.new(shape: MonitorConfigState, required: true, location_name: "Status"))
@@ -15,6 +15,11 @@ module Aws::InternetMonitor
15
15
  #
16
16
  # @return [String]
17
17
  #
18
+ # @!attribute use_dual_stack
19
+ # When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
20
+ #
21
+ # @return [Boolean]
22
+ #
18
23
  # @!attribute use_fips
19
24
  # When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.
20
25
  #
@@ -27,6 +32,7 @@ module Aws::InternetMonitor
27
32
  #
28
33
  EndpointParameters = Struct.new(
29
34
  :region,
35
+ :use_dual_stack,
30
36
  :use_fips,
31
37
  :endpoint,
32
38
  ) do
@@ -36,6 +42,7 @@ module Aws::InternetMonitor
36
42
  class << self
37
43
  PARAM_MAP = {
38
44
  'Region' => :region,
45
+ 'UseDualStack' => :use_dual_stack,
39
46
  'UseFIPS' => :use_fips,
40
47
  'Endpoint' => :endpoint,
41
48
  }.freeze
@@ -43,6 +50,11 @@ module Aws::InternetMonitor
43
50
 
44
51
  def initialize(options = {})
45
52
  self[:region] = options[:region]
53
+ self[:use_dual_stack] = options[:use_dual_stack]
54
+ self[:use_dual_stack] = false if self[:use_dual_stack].nil?
55
+ if self[:use_dual_stack].nil?
56
+ raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
57
+ end
46
58
  self[:use_fips] = options[:use_fips]
47
59
  self[:use_fips] = false if self[:use_fips].nil?
48
60
  if self[:use_fips].nil?
@@ -11,24 +11,25 @@ module Aws::InternetMonitor
11
11
  class EndpointProvider
12
12
  def resolve_endpoint(parameters)
13
13
  region = parameters.region
14
+ use_dual_stack = parameters.use_dual_stack
14
15
  use_fips = parameters.use_fips
15
16
  endpoint = parameters.endpoint
16
17
  if Aws::Endpoints::Matchers.set?(endpoint)
17
18
  if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
18
19
  raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
19
20
  end
21
+ if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
22
+ raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
23
+ end
20
24
  return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
21
25
  end
22
26
  if Aws::Endpoints::Matchers.set?(region)
23
27
  if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
24
- if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
25
- if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
26
- if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
27
- return Aws::Endpoints::Endpoint.new(url: "https://internetmonitor-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
28
- end
29
- raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
28
+ if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
29
+ if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
30
+ return Aws::Endpoints::Endpoint.new(url: "https://internetmonitor-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
30
31
  end
31
- return Aws::Endpoints::Endpoint.new(url: "https://internetmonitor.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
32
+ raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
32
33
  end
33
34
  if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
34
35
  if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
@@ -36,6 +37,12 @@ module Aws::InternetMonitor
36
37
  end
37
38
  raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
38
39
  end
40
+ if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
41
+ if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
42
+ return Aws::Endpoints::Endpoint.new(url: "https://internetmonitor.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
43
+ end
44
+ raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
45
+ end
39
46
  return Aws::Endpoints::Endpoint.new(url: "https://internetmonitor.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
40
47
  end
41
48
  end
@@ -19,6 +19,7 @@ module Aws::InternetMonitor
19
19
  end
20
20
  Aws::InternetMonitor::EndpointParameters.new(
21
21
  region: context.config.region,
22
+ use_dual_stack: context.config.use_dualstack_endpoint,
22
23
  use_fips: context.config.use_fips_endpoint,
23
24
  endpoint: endpoint,
24
25
  )
@@ -32,6 +33,7 @@ module Aws::InternetMonitor
32
33
  end
33
34
  Aws::InternetMonitor::EndpointParameters.new(
34
35
  region: context.config.region,
36
+ use_dual_stack: context.config.use_dualstack_endpoint,
35
37
  use_fips: context.config.use_fips_endpoint,
36
38
  endpoint: endpoint,
37
39
  )
@@ -45,6 +47,7 @@ module Aws::InternetMonitor
45
47
  end
46
48
  Aws::InternetMonitor::EndpointParameters.new(
47
49
  region: context.config.region,
50
+ use_dual_stack: context.config.use_dualstack_endpoint,
48
51
  use_fips: context.config.use_fips_endpoint,
49
52
  endpoint: endpoint,
50
53
  )
@@ -58,6 +61,7 @@ module Aws::InternetMonitor
58
61
  end
59
62
  Aws::InternetMonitor::EndpointParameters.new(
60
63
  region: context.config.region,
64
+ use_dual_stack: context.config.use_dualstack_endpoint,
61
65
  use_fips: context.config.use_fips_endpoint,
62
66
  endpoint: endpoint,
63
67
  )
@@ -71,6 +75,7 @@ module Aws::InternetMonitor
71
75
  end
72
76
  Aws::InternetMonitor::EndpointParameters.new(
73
77
  region: context.config.region,
78
+ use_dual_stack: context.config.use_dualstack_endpoint,
74
79
  use_fips: context.config.use_fips_endpoint,
75
80
  endpoint: endpoint,
76
81
  )
@@ -84,6 +89,7 @@ module Aws::InternetMonitor
84
89
  end
85
90
  Aws::InternetMonitor::EndpointParameters.new(
86
91
  region: context.config.region,
92
+ use_dual_stack: context.config.use_dualstack_endpoint,
87
93
  use_fips: context.config.use_fips_endpoint,
88
94
  endpoint: endpoint,
89
95
  )
@@ -97,6 +103,7 @@ module Aws::InternetMonitor
97
103
  end
98
104
  Aws::InternetMonitor::EndpointParameters.new(
99
105
  region: context.config.region,
106
+ use_dual_stack: context.config.use_dualstack_endpoint,
100
107
  use_fips: context.config.use_fips_endpoint,
101
108
  endpoint: endpoint,
102
109
  )
@@ -110,6 +117,7 @@ module Aws::InternetMonitor
110
117
  end
111
118
  Aws::InternetMonitor::EndpointParameters.new(
112
119
  region: context.config.region,
120
+ use_dual_stack: context.config.use_dualstack_endpoint,
113
121
  use_fips: context.config.use_fips_endpoint,
114
122
  endpoint: endpoint,
115
123
  )
@@ -123,6 +131,7 @@ module Aws::InternetMonitor
123
131
  end
124
132
  Aws::InternetMonitor::EndpointParameters.new(
125
133
  region: context.config.region,
134
+ use_dual_stack: context.config.use_dualstack_endpoint,
126
135
  use_fips: context.config.use_fips_endpoint,
127
136
  endpoint: endpoint,
128
137
  )
@@ -136,6 +145,7 @@ module Aws::InternetMonitor
136
145
  end
137
146
  Aws::InternetMonitor::EndpointParameters.new(
138
147
  region: context.config.region,
148
+ use_dual_stack: context.config.use_dualstack_endpoint,
139
149
  use_fips: context.config.use_fips_endpoint,
140
150
  endpoint: endpoint,
141
151
  )
@@ -23,16 +23,17 @@ module Aws::InternetMonitor
23
23
  include Aws::Structure
24
24
  end
25
25
 
26
- # Measurements about the availability for your application on the
27
- # internet, calculated by Amazon CloudWatch Internet Monitor. Amazon Web
28
- # Services has substantial historical data about internet performance
29
- # and availability between Amazon Web Services services and different
30
- # network providers and geographies. By applying statistical analysis to
31
- # the data, Internet Monitor can detect when the performance and
32
- # availability for your application has dropped, compared to an
33
- # estimated baseline that's already calculated. To make it easier to
34
- # see those drops, we report that information to you in the form of
35
- # health scores: a performance score and an availability score.
26
+ # Amazon CloudWatch Internet Monitor calculates measurements about the
27
+ # availability for your application's internet traffic between client
28
+ # locations and Amazon Web Services. Amazon Web Services has substantial
29
+ # historical data about internet performance and availability between
30
+ # Amazon Web Services services and different network providers and
31
+ # geographies. By applying statistical analysis to the data, Internet
32
+ # Monitor can detect when the performance and availability for your
33
+ # application has dropped, compared to an estimated baseline that's
34
+ # already calculated. To make it easier to see those drops, we report
35
+ # that information to you in the form of health scores: a performance
36
+ # score and an availability score.
36
37
  #
37
38
  # Availability in Internet Monitor represents the estimated percentage
38
39
  # of traffic that is not seeing an availability drop. For example, an
@@ -70,11 +71,15 @@ module Aws::InternetMonitor
70
71
  # @return [Float]
71
72
  #
72
73
  # @!attribute [rw] percent_of_total_traffic_impacted
73
- # The percentage of impact caused by a health event for total traffic
74
- # globally.
74
+ # The impact on total traffic that a health event has, in increased
75
+ # latency or reduced availability. This is the percentage of how much
76
+ # latency has increased or availability has decreased during the
77
+ # event, compared to what is typical for traffic from this client
78
+ # location to the Amazon Web Services location using this client
79
+ # network.
75
80
  #
76
81
  # For information about how Internet Monitor calculates impact, see
77
- # [Inside Internet Monitor][1] in the Amazon CloudWatch Internet
82
+ # [How Internet Monitor works][1] in the Amazon CloudWatch Internet
78
83
  # Monitor section of the Amazon CloudWatch User Guide.
79
84
  #
80
85
  #
@@ -137,13 +142,15 @@ module Aws::InternetMonitor
137
142
  #
138
143
  # @!attribute [rw] resources
139
144
  # The resources to include in a monitor, which you provide as a set of
140
- # Amazon Resource Names (ARNs).
145
+ # Amazon Resource Names (ARNs). Resources can be VPCs, NLBs, Amazon
146
+ # CloudFront distributions, or Amazon WorkSpaces directories.
141
147
  #
142
- # You can add a combination of Amazon Virtual Private Clouds (VPCs)
143
- # and Amazon CloudFront distributions, or you can add Amazon
144
- # WorkSpaces directories. You can't add all three types of resources.
148
+ # You can add a combination of VPCs and CloudFront distributions, or
149
+ # you can add WorkSpaces directories, or you can add NLBs. You can't
150
+ # add NLBs or WorkSpaces directories together with any other
151
+ # resources.
145
152
  #
146
- # <note markdown="1"> If you add only VPC resources, at least one VPC must have an
153
+ # <note markdown="1"> If you add only Amazon VPC resources, at least one VPC must have an
147
154
  # Internet Gateway attached to it, to make sure that it has internet
148
155
  # connectivity.
149
156
  #
@@ -167,9 +174,10 @@ module Aws::InternetMonitor
167
174
  # @!attribute [rw] max_city_networks_to_monitor
168
175
  # The maximum number of city-networks to monitor for your resources. A
169
176
  # city-network is the location (city) where clients access your
170
- # application resources from and the network or ASN, such as an
171
- # internet service provider (ISP), that clients access the resources
172
- # through. This limit helps control billing costs.
177
+ # application resources from and the ASN or network provider, such as
178
+ # an internet service provider (ISP), that clients access the
179
+ # resources through. Setting this limit can help control billing
180
+ # costs.
173
181
  #
174
182
  # To learn more, see [Choosing a city-network maximum value ][1] in
175
183
  # the Amazon CloudWatch Internet Monitor section of the *CloudWatch
@@ -187,16 +195,36 @@ module Aws::InternetMonitor
187
195
  #
188
196
  # @!attribute [rw] traffic_percentage_to_monitor
189
197
  # The percentage of the internet-facing traffic for your application
190
- # that you want to monitor with this monitor.
198
+ # that you want to monitor with this monitor. If you set a
199
+ # city-networks maximum, that limit overrides the traffic percentage
200
+ # that you set.
201
+ #
202
+ # To learn more, see [Choosing an application traffic percentage to
203
+ # monitor ][1] in the Amazon CloudWatch Internet Monitor section of
204
+ # the *CloudWatch User Guide*.
205
+ #
206
+ #
207
+ #
208
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMTrafficPercentage.html
191
209
  # @return [Integer]
192
210
  #
193
211
  # @!attribute [rw] health_events_config
194
- # Defines the health event threshold percentages, for performance
195
- # score and availability score. Internet Monitor creates a health
196
- # event when there's an internet issue that affects your application
197
- # end users where a health score percentage is at or below a set
198
- # threshold. If you don't set a health event threshold, the default
199
- # calue is 95%.
212
+ # Defines the threshold percentages and other configuration
213
+ # information for when Amazon CloudWatch Internet Monitor creates a
214
+ # health event. Internet Monitor creates a health event when an
215
+ # internet issue that affects your application end users has a health
216
+ # score percentage that is at or below a specific threshold, and,
217
+ # sometimes, when other criteria are met.
218
+ #
219
+ # If you don't set a health event threshold, the default value is
220
+ # 95%.
221
+ #
222
+ # For more information, see [ Change health event thresholds][1] in
223
+ # the Internet Monitor section of the *CloudWatch User Guide*.
224
+ #
225
+ #
226
+ #
227
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview
200
228
  # @return [Types::HealthEventsConfig]
201
229
  #
202
230
  # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/CreateMonitorInput AWS API Documentation
@@ -300,7 +328,12 @@ module Aws::InternetMonitor
300
328
  # @return [String]
301
329
  #
302
330
  # @!attribute [rw] percent_of_total_traffic_impacted
303
- # The impact on total traffic that a health event has.
331
+ # The impact on total traffic that a health event has, in increased
332
+ # latency or reduced availability. This is the percentage of how much
333
+ # latency has increased or availability has decreased during the
334
+ # event, compared to what is typical for traffic from this client
335
+ # location to the Amazon Web Services location using this client
336
+ # network.
304
337
  # @return [Float]
305
338
  #
306
339
  # @!attribute [rw] impact_type
@@ -308,8 +341,10 @@ module Aws::InternetMonitor
308
341
  # @return [String]
309
342
  #
310
343
  # @!attribute [rw] health_score_threshold
311
- # The threshold percentage for health events when Amazon CloudWatch
312
- # Internet Monitor creates a health event.
344
+ # The threshold percentage for a health score that determines, along
345
+ # with other configuration information, when Internet Monitor creates
346
+ # a health event when there's an internet issue that affects your
347
+ # application end users.
313
348
  # @return [Float]
314
349
  #
315
350
  # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/GetHealthEventOutput AWS API Documentation
@@ -351,8 +386,8 @@ module Aws::InternetMonitor
351
386
  # @return [String]
352
387
  #
353
388
  # @!attribute [rw] resources
354
- # The resources that have been added for the monitor. Resources are
355
- # listed by their Amazon Resource Names (ARNs).
389
+ # The resources monitored by the monitor. Resources are listed by
390
+ # their Amazon Resource Names (ARNs).
356
391
  # @return [Array<String>]
357
392
  #
358
393
  # @!attribute [rw] status
@@ -383,9 +418,9 @@ module Aws::InternetMonitor
383
418
  # @!attribute [rw] max_city_networks_to_monitor
384
419
  # The maximum number of city-networks to monitor for your resources. A
385
420
  # city-network is the location (city) where clients access your
386
- # application resources from and the network or ASN, such as an
387
- # internet service provider (ISP), that clients access the resources
388
- # through. This limit helps control billing costs.
421
+ # application resources from and the ASN or network provider, such as
422
+ # an internet service provider (ISP), that clients access the
423
+ # resources through. This limit can help control billing costs.
389
424
  #
390
425
  # To learn more, see [Choosing a city-network maximum value ][1] in
391
426
  # the Amazon CloudWatch Internet Monitor section of the *CloudWatch
@@ -404,15 +439,31 @@ module Aws::InternetMonitor
404
439
  #
405
440
  # @!attribute [rw] traffic_percentage_to_monitor
406
441
  # The percentage of the internet-facing traffic for your application
407
- # that you want to monitor with this monitor.
442
+ # to monitor with this monitor. If you set a city-networks maximum,
443
+ # that limit overrides the traffic percentage that you set.
444
+ #
445
+ # To learn more, see [Choosing an application traffic percentage to
446
+ # monitor ][1] in the Amazon CloudWatch Internet Monitor section of
447
+ # the *CloudWatch User Guide*.
448
+ #
449
+ #
450
+ #
451
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMTrafficPercentage.html
408
452
  # @return [Integer]
409
453
  #
410
454
  # @!attribute [rw] health_events_config
411
- # The list of health event thresholds. A health event threshold
412
- # percentage, for performance and availability, determines the level
413
- # of impact at which Amazon CloudWatch Internet Monitor creates a
414
- # health event when there's an internet issue that affects your
415
- # application end users.
455
+ # The list of health event threshold configurations. The threshold
456
+ # percentage for a health score determines, along with other
457
+ # configuration information, when Internet Monitor creates a health
458
+ # event when there's an internet issue that affects your application
459
+ # end users.
460
+ #
461
+ # For more information, see [ Change health event thresholds][1] in
462
+ # the Internet Monitor section of the *CloudWatch User Guide*.
463
+ #
464
+ #
465
+ #
466
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview
416
467
  # @return [Types::HealthEventsConfig]
417
468
  #
418
469
  # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/GetMonitorOutput AWS API Documentation
@@ -473,8 +524,12 @@ module Aws::InternetMonitor
473
524
  # @return [String]
474
525
  #
475
526
  # @!attribute [rw] percent_of_total_traffic_impacted
476
- # The impact on global traffic monitored by this monitor for this
477
- # health event.
527
+ # The impact on total traffic that a health event has, in increased
528
+ # latency or reduced availability. This is the percentage of how much
529
+ # latency has increased or availability has decreased during the
530
+ # event, compared to what is typical for traffic from this client
531
+ # location to the Amazon Web Services location using this client
532
+ # network.
478
533
  # @return [Float]
479
534
  #
480
535
  # @!attribute [rw] impact_type
@@ -505,12 +560,35 @@ module Aws::InternetMonitor
505
560
  include Aws::Structure
506
561
  end
507
562
 
508
- # A complex type for the configuration. Defines the health event
509
- # threshold percentages, for performance score and availability score.
510
- # Amazon CloudWatch Internet Monitor creates a health event when
511
- # there's an internet issue that affects your application end users
512
- # where a health score percentage is at or below a set threshold. If you
513
- # don't set a health event threshold, the default value is 95%.
563
+ # A complex type with the configuration information that determines the
564
+ # threshold and other conditions for when Internet Monitor creates a
565
+ # health event for an overall performance or availability issue, across
566
+ # an application's geographies.
567
+ #
568
+ # Defines the percentages, for overall performance scores and
569
+ # availability scores for an application, that are the thresholds for
570
+ # when Amazon CloudWatch Internet Monitor creates a health event. You
571
+ # can override the defaults to set a custom threshold for overall
572
+ # performance or availability scores, or both.
573
+ #
574
+ # You can also set thresholds for local health scores,, where Internet
575
+ # Monitor creates a health event when scores cross a threshold for one
576
+ # or more city-networks, in addition to creating an event when an
577
+ # overall score crosses a threshold.
578
+ #
579
+ # If you don't set a health event threshold, the default value is 95%.
580
+ #
581
+ # For local thresholds, you also set a minimum percentage of overall
582
+ # traffic that is impacted by an issue before Internet Monitor creates
583
+ # an event. In addition, you can disable local thresholds, for
584
+ # performance scores, availability scores, or both.
585
+ #
586
+ # For more information, see [ Change health event thresholds][1] in the
587
+ # Internet Monitor section of the *CloudWatch User Guide*.
588
+ #
589
+ #
590
+ #
591
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview
514
592
  #
515
593
  # @!attribute [rw] availability_score_threshold
516
594
  # The health event threshold percentage set for availability scores.
@@ -520,11 +598,25 @@ module Aws::InternetMonitor
520
598
  # The health event threshold percentage set for performance scores.
521
599
  # @return [Float]
522
600
  #
601
+ # @!attribute [rw] availability_local_health_events_config
602
+ # The configuration that determines the threshold and other conditions
603
+ # for when Internet Monitor creates a health event for a local
604
+ # availability issue.
605
+ # @return [Types::LocalHealthEventsConfig]
606
+ #
607
+ # @!attribute [rw] performance_local_health_events_config
608
+ # The configuration that determines the threshold and other conditions
609
+ # for when Internet Monitor creates a health event for a local
610
+ # performance issue.
611
+ # @return [Types::LocalHealthEventsConfig]
612
+ #
523
613
  # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/HealthEventsConfig AWS API Documentation
524
614
  #
525
615
  class HealthEventsConfig < Struct.new(
526
616
  :availability_score_threshold,
527
- :performance_score_threshold)
617
+ :performance_score_threshold,
618
+ :availability_local_health_events_config,
619
+ :performance_local_health_events_config)
528
620
  SENSITIVE = []
529
621
  include Aws::Structure
530
622
  end
@@ -663,9 +755,9 @@ module Aws::InternetMonitor
663
755
  # geographies. By applying statistical analysis to the data, Internet
664
756
  # Monitor can detect when the performance and availability for your
665
757
  # application has dropped, compared to an estimated baseline that's
666
- # already calculated. To make it easier to see those drops, we report
667
- # that information to you in the form of health scores: a performance
668
- # score and an availability score.
758
+ # already calculated. To make it easier to see those drops, Internet
759
+ # Monitor reports the information to you in the form of health scores: a
760
+ # performance score and an availability score.
669
761
  #
670
762
  # @!attribute [rw] availability
671
763
  # Availability in Internet Monitor represents the estimated percentage
@@ -872,6 +964,52 @@ module Aws::InternetMonitor
872
964
  include Aws::Structure
873
965
  end
874
966
 
967
+ # A complex type with the configuration information that determines the
968
+ # threshold and other conditions for when Internet Monitor creates a
969
+ # health event for a local performance or availability issue, when
970
+ # scores cross a threshold for one or more city-networks.
971
+ #
972
+ # Defines the percentages, for performance scores or availability
973
+ # scores, that are the local thresholds for when Amazon CloudWatch
974
+ # Internet Monitor creates a health event. Also defines whether a local
975
+ # threshold is enabled or disabled, and the minimum percentage of
976
+ # overall traffic that must be impacted by an issue before Internet
977
+ # Monitor creates an event when a threshold is crossed for a local
978
+ # health score.
979
+ #
980
+ # For more information, see [ Change health event thresholds][1] in the
981
+ # Internet Monitor section of the *CloudWatch User Guide*.
982
+ #
983
+ #
984
+ #
985
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview
986
+ #
987
+ # @!attribute [rw] status
988
+ # The status of whether Internet Monitor creates a health event based
989
+ # on a threshold percentage set for a local health score. The status
990
+ # can be `ENABLED` or `DISABLED`.
991
+ # @return [String]
992
+ #
993
+ # @!attribute [rw] health_score_threshold
994
+ # The health event threshold percentage set for a local health score.
995
+ # @return [Float]
996
+ #
997
+ # @!attribute [rw] min_traffic_impact
998
+ # The minimum percentage of overall traffic for an application that
999
+ # must be impacted by an issue before Internet Monitor creates an
1000
+ # event when a threshold is crossed for a local health score.
1001
+ # @return [Float]
1002
+ #
1003
+ # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/LocalHealthEventsConfig AWS API Documentation
1004
+ #
1005
+ class LocalHealthEventsConfig < Struct.new(
1006
+ :status,
1007
+ :health_score_threshold,
1008
+ :min_traffic_impact)
1009
+ SENSITIVE = []
1010
+ include Aws::Structure
1011
+ end
1012
+
875
1013
  # The description of and information about a monitor in Amazon
876
1014
  # CloudWatch Internet Monitor.
877
1015
  #
@@ -962,16 +1100,17 @@ module Aws::InternetMonitor
962
1100
  include Aws::Structure
963
1101
  end
964
1102
 
965
- # Measurements about the performance for your application on the
966
- # internet calculated by Amazon CloudWatch Internet Monitor. Amazon Web
967
- # Services has substantial historical data about internet performance
968
- # and availability between Amazon Web Services services and different
969
- # network providers and geographies. By applying statistical analysis to
970
- # the data, Internet Monitor can detect when the performance and
971
- # availability for your application has dropped, compared to an
972
- # estimated baseline that's already calculated. To make it easier to
973
- # see those drops, we report that information to you in the form of
974
- # health scores: a performance score and an availability score.
1103
+ # Amazon CloudWatch Internet Monitor calculates measurements about the
1104
+ # performance for your application's internet traffic between client
1105
+ # locations and Amazon Web Services. Amazon Web Services has substantial
1106
+ # historical data about internet performance and availability between
1107
+ # Amazon Web Services services and different network providers and
1108
+ # geographies. By applying statistical analysis to the data, Internet
1109
+ # Monitor can detect when the performance and availability for your
1110
+ # application has dropped, compared to an estimated baseline that's
1111
+ # already calculated. To make it easier to see those drops, we report
1112
+ # that information to you in the form of health scores: a performance
1113
+ # score and an availability score.
975
1114
  #
976
1115
  # Performance in Internet Monitor represents the estimated percentage of
977
1116
  # traffic that is not seeing a performance drop. For example, a
@@ -1009,10 +1148,12 @@ module Aws::InternetMonitor
1009
1148
  # @return [Float]
1010
1149
  #
1011
1150
  # @!attribute [rw] percent_of_total_traffic_impacted
1012
- # How much performance impact was caused by a health event for total
1013
- # traffic globally. For performance, this is the percentage of how
1014
- # much latency increased during the event compared to typical
1015
- # performance for your application traffic globally.
1151
+ # The impact on total traffic that a health event has, in increased
1152
+ # latency or reduced availability. This is the percentage of how much
1153
+ # latency has increased or availability has decreased during the
1154
+ # event, compared to what is typical for traffic from this client
1155
+ # location to the Amazon Web Services location using this client
1156
+ # network.
1016
1157
  #
1017
1158
  # For more information, see [When Amazon Web Services creates and
1018
1159
  # resolves health events][1] in the Amazon CloudWatch Internet Monitor
@@ -1210,15 +1351,17 @@ module Aws::InternetMonitor
1210
1351
  #
1211
1352
  # @!attribute [rw] resources_to_add
1212
1353
  # The resources to include in a monitor, which you provide as a set of
1213
- # Amazon Resource Names (ARNs).
1354
+ # Amazon Resource Names (ARNs). Resources can be VPCs, NLBs, Amazon
1355
+ # CloudFront distributions, or Amazon WorkSpaces directories.
1214
1356
  #
1215
- # You can add a combination of Amazon Virtual Private Clouds (VPCs)
1216
- # and Amazon CloudFront distributions, or you can add Amazon
1217
- # WorkSpaces directories. You can't add all three types of resources.
1357
+ # You can add a combination of VPCs and CloudFront distributions, or
1358
+ # you can add WorkSpaces directories, or you can add NLBs. You can't
1359
+ # add NLBs or WorkSpaces directories together with any other
1360
+ # resources.
1218
1361
  #
1219
- # <note markdown="1"> If you add only VPC resources, at least one VPC must have an
1220
- # Internet Gateway attached to it, to make sure that it has internet
1221
- # connectivity.
1362
+ # <note markdown="1"> If you add only Amazon Virtual Private Clouds resources, at least
1363
+ # one VPC must have an Internet Gateway attached to it, to make sure
1364
+ # that it has internet connectivity.
1222
1365
  #
1223
1366
  # </note>
1224
1367
  # @return [Array<String>]
@@ -1244,11 +1387,12 @@ module Aws::InternetMonitor
1244
1387
  # @return [String]
1245
1388
  #
1246
1389
  # @!attribute [rw] max_city_networks_to_monitor
1247
- # The maximum number of city-networks to monitor for your resources. A
1248
- # city-network is the location (city) where clients access your
1249
- # application resources from and the network or ASN, such as an
1250
- # internet service provider, that clients access the resources
1251
- # through.
1390
+ # The maximum number of city-networks to monitor for your application.
1391
+ # A city-network is the location (city) where clients access your
1392
+ # application resources from and the ASN or network provider, such as
1393
+ # an internet service provider (ISP), that clients access the
1394
+ # resources through. Setting this limit can help control billing
1395
+ # costs.
1252
1396
  # @return [Integer]
1253
1397
  #
1254
1398
  # @!attribute [rw] internet_measurements_log_delivery
@@ -1259,14 +1403,31 @@ module Aws::InternetMonitor
1259
1403
  #
1260
1404
  # @!attribute [rw] traffic_percentage_to_monitor
1261
1405
  # The percentage of the internet-facing traffic for your application
1262
- # that you want to monitor with this monitor.
1406
+ # that you want to monitor with this monitor. If you set a
1407
+ # city-networks maximum, that limit overrides the traffic percentage
1408
+ # that you set.
1409
+ #
1410
+ # To learn more, see [Choosing an application traffic percentage to
1411
+ # monitor ][1] in the Amazon CloudWatch Internet Monitor section of
1412
+ # the *CloudWatch User Guide*.
1413
+ #
1414
+ #
1415
+ #
1416
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMTrafficPercentage.html
1263
1417
  # @return [Integer]
1264
1418
  #
1265
1419
  # @!attribute [rw] health_events_config
1266
- # The list of health event thresholds. A health event threshold
1267
- # percentage, for performance and availability, determines when
1268
- # Internet Monitor creates a health event when there's an internet
1269
- # issue that affects your application end users.
1420
+ # The list of health score thresholds. A threshold percentage for
1421
+ # health scores, along with other configuration information,
1422
+ # determines when Internet Monitor creates a health event when
1423
+ # there's an internet issue that affects your application end users.
1424
+ #
1425
+ # For more information, see [ Change health event thresholds][1] in
1426
+ # the Internet Monitor section of the *CloudWatch User Guide*.
1427
+ #
1428
+ #
1429
+ #
1430
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview
1270
1431
  # @return [Types::HealthEventsConfig]
1271
1432
  #
1272
1433
  # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/UpdateMonitorInput AWS API Documentation
@@ -53,6 +53,6 @@ require_relative 'aws-sdk-internetmonitor/customizations'
53
53
  # @!group service
54
54
  module Aws::InternetMonitor
55
55
 
56
- GEM_VERSION = '1.7.0'
56
+ GEM_VERSION = '1.9.0'
57
57
 
58
58
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-internetmonitor
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.7.0
4
+ version: 1.9.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-07-11 00:00:00.000000000 Z
11
+ date: 2023-09-13 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core