aws-sdk-internetmonitor 1.7.0 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8e075459bdf44c48cbac221944a7b21e6edf7769167ca5ffbe101c387eb86d2
-  data.tar.gz: 41e249ab9a1efb2f080df87dca0f54f77eded2b164380cf7e3222c5d423315f5
+  metadata.gz: e8844a9f6145cfe082619fe22135fdb02a15714a4e1b9910c90197cc29c4e3d1
+  data.tar.gz: f99b5d76c49cd1d603bd5c4f7b3eafb33de832d2017d64d697b2161878052500
 SHA512:
-  metadata.gz: fa3cda4783f9bf7382027c4ff0b00b0e204afab28f98ab1adaad7426486e04897bfeda5fc56c8205b3d112e99cda1b09a96f14282dcff6fe2e0b0dccae9f9f79
-  data.tar.gz: 597e751840f69c1f71ea30cb5e60d84cb96f1820a00b43bfd4dd3840006a1efbae161f2f51ab42c0db4c972e16c0af1a5401c3c765f93170627dd49c3e03ed54
+  metadata.gz: bdd74612ef437146fa14768ffab3ef2a023f0fc5afa8ecd253dbc0f326f060fa2b6d178e47a551fd545dab0fcc29f83235815862415bba4f2f92efb993c15eaf
+  data.tar.gz: 920075267d6495a3dc71787889e01c3bc212ec02f2cf2f8495f94d1f8d37be272c5fe68008d814e87f0c4185e9351628de4716269420385531750d3c99f2f59a

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.8.0 (2023-08-01)
+------------------
+
+* 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.
+
 1.7.0 (2023-07-11)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.7.0
+1.8.0

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

@@ -390,21 +390,23 @@ module Aws::InternetMonitor
 
     # Creates a monitor in Amazon CloudWatch Internet Monitor. A monitor is
     # built based on information from the application resources that you
-    # add: Amazon Virtual Private Clouds (VPCs), Amazon CloudFront
-    # distributions, and WorkSpaces directories. Internet Monitor then
-    # publishes internet measurements from Amazon Web Services that are
-    # specific to the *city-networks*, that is, the locations and ASNs
+    # add: VPCs, Network Load Balancers (NLBs), Amazon CloudFront
+    # distributions, and Amazon WorkSpaces directories. Internet Monitor
+    # then publishes internet measurements from Amazon Web Services that are
+    # specific to the *city-networks*. That is, the locations and ASNs
     # (typically internet service providers or ISPs), where clients access
     # your application. For more information, see [Using Amazon CloudWatch
     # Internet Monitor][1] in the *Amazon CloudWatch User Guide*.
     #
-    # When you create a monitor, you set a maximum limit for the number of
-    # city-networks where client traffic is monitored. The city-network
-    # maximum that you choose is the limit, but you only pay for the number
-    # of city-networks that are actually monitored. You can change the
-    # maximum at any time by updating your monitor. For more information,
-    # see [Choosing a city-network maximum value][2] in the *Amazon
-    # CloudWatch User Guide*.
+    # When you create a monitor, you choose the percentage of traffic that
+    # you want to monitor. You can also set a maximum limit for the number
+    # of city-networks where client traffic is monitored, that caps the
+    # total traffic that Internet Monitor monitors. A city-network maximum
+    # is the limit of city-networks, but you only pay for the number of
+    # city-networks that are actually monitored. You can update your monitor
+    # at any time to change the percentage of traffic to monitor or the
+    # city-networks maximum. For more information, see [Choosing a
+    # city-network maximum value][2] in the *Amazon CloudWatch User Guide*.
     #
     #
     #
@@ -416,14 +418,15 @@ module Aws::InternetMonitor
     #
     # @option params [Array<String>] :resources
     #   The resources to include in a monitor, which you provide as a set of
-    #   Amazon Resource Names (ARNs).
+    #   Amazon Resource Names (ARNs). Resources can be VPCs, NLBs, Amazon
+    #   CloudFront distributions, or Amazon WorkSpaces directories.
     #
-    #   You can add a combination of Amazon Virtual Private Clouds (VPCs) and
-    #   Amazon CloudFront distributions, or you can add Amazon WorkSpaces
-    #   directories. You can't add all three types of resources.
+    #   You can add a combination of VPCs and CloudFront distributions, or you
+    #   can add WorkSpaces directories, or you can add NLBs. You can't add
+    #   NLBs or WorkSpaces directories together with any other resources.
     #
-    #   <note markdown="1"> If you add only VPC resources, at least one VPC must have an Internet
-    #   Gateway attached to it, to make sure that it has internet
+    #   <note markdown="1"> If you add only Amazon VPC resources, at least one VPC must have an
+    #   Internet Gateway attached to it, to make sure that it has internet
     #   connectivity.
     #
     #    </note>
@@ -443,9 +446,9 @@ module Aws::InternetMonitor
     # @option params [Integer] :max_city_networks_to_monitor
     #   The maximum number of city-networks to monitor for your resources. A
     #   city-network is the location (city) where clients access your
-    #   application resources from and the network or ASN, such as an internet
-    #   service provider (ISP), that clients access the resources through.
-    #   This limit helps control billing costs.
+    #   application resources from and the ASN or network provider, such as an
+    #   internet service provider (ISP), that clients access the resources
+    #   through. Setting this limit can help control billing costs.
     #
     #   To learn more, see [Choosing a city-network maximum value ][1] in the
     #   Amazon CloudWatch Internet Monitor section of the *CloudWatch User
@@ -461,14 +464,33 @@ module Aws::InternetMonitor
     #
     # @option params [Integer] :traffic_percentage_to_monitor
     #   The percentage of the internet-facing traffic for your application
-    #   that you want to monitor with this monitor.
+    #   that you want to monitor with this monitor. If you set a city-networks
+    #   maximum, that limit overrides the traffic percentage that you set.
+    #
+    #   To learn more, see [Choosing an application traffic percentage to
+    #   monitor ][1] in the Amazon CloudWatch Internet Monitor section of the
+    #   *CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMTrafficPercentage.html
     #
     # @option params [Types::HealthEventsConfig] :health_events_config
-    #   Defines the health event threshold percentages, for performance score
-    #   and availability score. Internet Monitor creates a health event when
-    #   there's an internet issue that affects your application end users
-    #   where a health score percentage is at or below a set threshold. If you
-    #   don't set a health event threshold, the default calue is 95%.
+    #   Defines the threshold percentages and other configuration information
+    #   for when Amazon CloudWatch Internet Monitor creates a health event.
+    #   Internet Monitor creates a health event when an internet issue that
+    #   affects your application end users has a health score percentage that
+    #   is at or below a specific threshold, and, sometimes, when other
+    #   criteria are met.
+    #
+    #   If you don't set a health event threshold, the default value is 95%.
+    #
+    #   For more information, see [ Change health event thresholds][1] in the
+    #   Internet Monitor section of the *CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview
     #
     # @return [Types::CreateMonitorOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -496,6 +518,16 @@ module Aws::InternetMonitor
     #     health_events_config: {
     #       availability_score_threshold: 1.0,
     #       performance_score_threshold: 1.0,
+    #       availability_local_health_events_config: {
+    #         status: "ENABLED", # accepts ENABLED, DISABLED
+    #         health_score_threshold: 1.0,
+    #         min_traffic_impact: 1.0,
+    #       },
+    #       performance_local_health_events_config: {
+    #         status: "ENABLED", # accepts ENABLED, DISABLED
+    #         health_score_threshold: 1.0,
+    #         min_traffic_impact: 1.0,
+    #       },
     #     },
     #   })
     #
@@ -537,12 +569,12 @@ module Aws::InternetMonitor
 
     # Gets information the Amazon CloudWatch Internet Monitor has created
     # and stored about a health event for a specified monitor. This
-    # information includes the impacted locations, and all of the
-    # information related to the event by location.
+    # information includes the impacted locations, and all the information
+    # related to the event, by location.
     #
-    # The information returned includes the performance, availability, and
-    # round-trip time impact, information about the network providers, the
-    # event type, and so on.
+    # The information returned includes the impact on performance,
+    # availability, and round-trip time, information about the network
+    # providers (ASNs), the event type, and so on.
     #
     # Information rolled up at the global traffic level is also returned,
     # including the impact type and total traffic impact.
@@ -615,7 +647,7 @@ module Aws::InternetMonitor
     #   resp.impacted_locations[0].internet_health.performance.round_trip_time.p95 #=> Float
     #   resp.status #=> String, one of "ACTIVE", "RESOLVED"
     #   resp.percent_of_total_traffic_impacted #=> Float
-    #   resp.impact_type #=> String, one of "AVAILABILITY", "PERFORMANCE"
+    #   resp.impact_type #=> String, one of "AVAILABILITY", "PERFORMANCE", "LOCAL_AVAILABILITY", "LOCAL_PERFORMANCE"
     #   resp.health_score_threshold #=> Float
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/GetHealthEvent AWS API Documentation
@@ -677,6 +709,12 @@ module Aws::InternetMonitor
     #   resp.traffic_percentage_to_monitor #=> Integer
     #   resp.health_events_config.availability_score_threshold #=> Float
     #   resp.health_events_config.performance_score_threshold #=> Float
+    #   resp.health_events_config.availability_local_health_events_config.status #=> String, one of "ENABLED", "DISABLED"
+    #   resp.health_events_config.availability_local_health_events_config.health_score_threshold #=> Float
+    #   resp.health_events_config.availability_local_health_events_config.min_traffic_impact #=> Float
+    #   resp.health_events_config.performance_local_health_events_config.status #=> String, one of "ENABLED", "DISABLED"
+    #   resp.health_events_config.performance_local_health_events_config.health_score_threshold #=> Float
+    #   resp.health_events_config.performance_local_health_events_config.min_traffic_impact #=> Float
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/GetMonitor AWS API Documentation
     #
@@ -688,9 +726,8 @@ module Aws::InternetMonitor
     end
 
     # Lists all health events for a monitor in Amazon CloudWatch Internet
-    # Monitor. Returns all information for health events including the
-    # client location information the network cause and status, event start
-    # and end time, percentage of total traffic impacted, and status.
+    # Monitor. Returns information for health events including the event
+    # start and end time and the status.
     #
     # <note markdown="1"> Health events that have start times during the time frame that is
     # requested are not included in the list of health events.
@@ -776,7 +813,7 @@ module Aws::InternetMonitor
     #   resp.health_events[0].impacted_locations[0].internet_health.performance.round_trip_time.p95 #=> Float
     #   resp.health_events[0].status #=> String, one of "ACTIVE", "RESOLVED"
     #   resp.health_events[0].percent_of_total_traffic_impacted #=> Float
-    #   resp.health_events[0].impact_type #=> String, one of "AVAILABILITY", "PERFORMANCE"
+    #   resp.health_events[0].impact_type #=> String, one of "AVAILABILITY", "PERFORMANCE", "LOCAL_AVAILABILITY", "LOCAL_PERFORMANCE"
     #   resp.health_events[0].health_score_threshold #=> Float
     #   resp.next_token #=> String
     #
@@ -935,10 +972,11 @@ module Aws::InternetMonitor
       req.send_request(options)
     end
 
-    # Updates a monitor. You can update a monitor to change the maximum
-    # number of city-networks (locations and ASNs or internet service
-    # providers), to add or remove resources, or to change the status of the
-    # monitor. Note that you can't change the name of a monitor.
+    # Updates a monitor. You can update a monitor to change the percentage
+    # of traffic to monitor or the maximum number of city-networks
+    # (locations and ASNs), to add or remove resources, or to change the
+    # status of the monitor. Note that you can't change the name of a
+    # monitor.
     #
     # The city-network maximum that you choose is the limit, but you only
     # pay for the number of city-networks that are actually monitored. For
@@ -954,15 +992,16 @@ module Aws::InternetMonitor
     #
     # @option params [Array<String>] :resources_to_add
     #   The resources to include in a monitor, which you provide as a set of
-    #   Amazon Resource Names (ARNs).
+    #   Amazon Resource Names (ARNs). Resources can be VPCs, NLBs, Amazon
+    #   CloudFront distributions, or Amazon WorkSpaces directories.
     #
-    #   You can add a combination of Amazon Virtual Private Clouds (VPCs) and
-    #   Amazon CloudFront distributions, or you can add Amazon WorkSpaces
-    #   directories. You can't add all three types of resources.
+    #   You can add a combination of VPCs and CloudFront distributions, or you
+    #   can add WorkSpaces directories, or you can add NLBs. You can't add
+    #   NLBs or WorkSpaces directories together with any other resources.
     #
-    #   <note markdown="1"> If you add only VPC resources, at least one VPC must have an Internet
-    #   Gateway attached to it, to make sure that it has internet
-    #   connectivity.
+    #   <note markdown="1"> If you add only Amazon Virtual Private Clouds resources, at least one
+    #   VPC must have an Internet Gateway attached to it, to make sure that it
+    #   has internet connectivity.
     #
     #    </note>
     #
@@ -984,10 +1023,11 @@ module Aws::InternetMonitor
     #   not need to pass this option.**
     #
     # @option params [Integer] :max_city_networks_to_monitor
-    #   The maximum number of city-networks to monitor for your resources. A
+    #   The maximum number of city-networks to monitor for your application. A
     #   city-network is the location (city) where clients access your
-    #   application resources from and the network or ASN, such as an internet
-    #   service provider, that clients access the resources through.
+    #   application resources from and the ASN or network provider, such as an
+    #   internet service provider (ISP), that clients access the resources
+    #   through. Setting this limit can help control billing costs.
     #
     # @option params [Types::InternetMeasurementsLogDelivery] :internet_measurements_log_delivery
     #   Publish internet measurements for Internet Monitor to another
@@ -996,13 +1036,29 @@ module Aws::InternetMonitor
     #
     # @option params [Integer] :traffic_percentage_to_monitor
     #   The percentage of the internet-facing traffic for your application
-    #   that you want to monitor with this monitor.
+    #   that you want to monitor with this monitor. If you set a city-networks
+    #   maximum, that limit overrides the traffic percentage that you set.
+    #
+    #   To learn more, see [Choosing an application traffic percentage to
+    #   monitor ][1] in the Amazon CloudWatch Internet Monitor section of the
+    #   *CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMTrafficPercentage.html
     #
     # @option params [Types::HealthEventsConfig] :health_events_config
-    #   The list of health event thresholds. A health event threshold
-    #   percentage, for performance and availability, determines when Internet
-    #   Monitor creates a health event when there's an internet issue that
-    #   affects your application end users.
+    #   The list of health score thresholds. A threshold percentage for health
+    #   scores, along with other configuration information, determines when
+    #   Internet Monitor creates a health event when there's an internet
+    #   issue that affects your application end users.
+    #
+    #   For more information, see [ Change health event thresholds][1] in the
+    #   Internet Monitor section of the *CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview
     #
     # @return [Types::UpdateMonitorOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1029,6 +1085,16 @@ module Aws::InternetMonitor
     #     health_events_config: {
     #       availability_score_threshold: 1.0,
     #       performance_score_threshold: 1.0,
+    #       availability_local_health_events_config: {
+    #         status: "ENABLED", # accepts ENABLED, DISABLED
+    #         health_score_threshold: 1.0,
+    #         min_traffic_impact: 1.0,
+    #       },
+    #       performance_local_health_events_config: {
+    #         status: "ENABLED", # accepts ENABLED, DISABLED
+    #         health_score_threshold: 1.0,
+    #         min_traffic_impact: 1.0,
+    #       },
     #     },
     #   })
     #
@@ -1059,7 +1125,7 @@ module Aws::InternetMonitor
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-internetmonitor'
-      context[:gem_version] = '1.7.0'
+      context[:gem_version] = '1.8.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -46,6 +46,8 @@ module Aws::InternetMonitor
     ListMonitorsOutput = Shapes::StructureShape.new(name: 'ListMonitorsOutput')
     ListTagsForResourceInput = Shapes::StructureShape.new(name: 'ListTagsForResourceInput')
     ListTagsForResourceOutput = Shapes::StructureShape.new(name: 'ListTagsForResourceOutput')
+    LocalHealthEventsConfig = Shapes::StructureShape.new(name: 'LocalHealthEventsConfig')
+    LocalHealthEventsConfigStatus = Shapes::StringShape.new(name: 'LocalHealthEventsConfigStatus')
     LogDeliveryStatus = Shapes::StringShape.new(name: 'LogDeliveryStatus')
     Long = Shapes::IntegerShape.new(name: 'Long')
     MaxCityNetworksToMonitor = Shapes::IntegerShape.new(name: 'MaxCityNetworksToMonitor')
@@ -170,6 +172,8 @@ module Aws::InternetMonitor
 
     HealthEventsConfig.add_member(:availability_score_threshold, Shapes::ShapeRef.new(shape: Percentage, location_name: "AvailabilityScoreThreshold"))
     HealthEventsConfig.add_member(:performance_score_threshold, Shapes::ShapeRef.new(shape: Percentage, location_name: "PerformanceScoreThreshold"))
+    HealthEventsConfig.add_member(:availability_local_health_events_config, Shapes::ShapeRef.new(shape: LocalHealthEventsConfig, location_name: "AvailabilityLocalHealthEventsConfig"))
+    HealthEventsConfig.add_member(:performance_local_health_events_config, Shapes::ShapeRef.new(shape: LocalHealthEventsConfig, location_name: "PerformanceLocalHealthEventsConfig"))
     HealthEventsConfig.struct_class = Types::HealthEventsConfig
 
     ImpactedLocation.add_member(:as_name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "ASName"))
@@ -233,6 +237,11 @@ module Aws::InternetMonitor
     ListTagsForResourceOutput.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
     ListTagsForResourceOutput.struct_class = Types::ListTagsForResourceOutput
 
+    LocalHealthEventsConfig.add_member(:status, Shapes::ShapeRef.new(shape: LocalHealthEventsConfigStatus, location_name: "Status"))
+    LocalHealthEventsConfig.add_member(:health_score_threshold, Shapes::ShapeRef.new(shape: Percentage, location_name: "HealthScoreThreshold"))
+    LocalHealthEventsConfig.add_member(:min_traffic_impact, Shapes::ShapeRef.new(shape: Percentage, location_name: "MinTrafficImpact"))
+    LocalHealthEventsConfig.struct_class = Types::LocalHealthEventsConfig
+
     Monitor.add_member(:monitor_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location_name: "MonitorName"))
     Monitor.add_member(:monitor_arn, Shapes::ShapeRef.new(shape: MonitorArn, required: true, location_name: "MonitorArn"))
     Monitor.add_member(:status, Shapes::ShapeRef.new(shape: MonitorConfigState, required: true, location_name: "Status"))

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

@@ -23,16 +23,17 @@ module Aws::InternetMonitor
       include Aws::Structure
     end
 
-    # Measurements about the availability for your application on the
-    # internet, calculated by Amazon CloudWatch Internet Monitor. Amazon Web
-    # Services has substantial historical data about internet performance
-    # and availability between Amazon Web Services services and different
-    # network providers and geographies. By applying statistical analysis to
-    # the data, Internet Monitor can detect when the performance and
-    # availability for your application has dropped, compared to an
-    # estimated baseline that's already calculated. To make it easier to
-    # see those drops, we report that information to you in the form of
-    # health scores: a performance score and an availability score.
+    # Amazon CloudWatch Internet Monitor calculates measurements about the
+    # availability for your application's internet traffic between client
+    # locations and Amazon Web Services. Amazon Web Services has substantial
+    # historical data about internet performance and availability between
+    # Amazon Web Services services and different network providers and
+    # geographies. By applying statistical analysis to the data, Internet
+    # Monitor can detect when the performance and availability for your
+    # application has dropped, compared to an estimated baseline that's
+    # already calculated. To make it easier to see those drops, we report
+    # that information to you in the form of health scores: a performance
+    # score and an availability score.
     #
     # Availability in Internet Monitor represents the estimated percentage
     # of traffic that is not seeing an availability drop. For example, an
@@ -70,11 +71,15 @@ module Aws::InternetMonitor
     #   @return [Float]
     #
     # @!attribute [rw] percent_of_total_traffic_impacted
-    #   The percentage of impact caused by a health event for total traffic
-    #   globally.
+    #   The impact on total traffic that a health event has, in increased
+    #   latency or reduced availability. This is the percentage of how much
+    #   latency has increased or availability has decreased during the
+    #   event, compared to what is typical for traffic from this client
+    #   location to the Amazon Web Services location using this client
+    #   network.
     #
     #   For information about how Internet Monitor calculates impact, see
-    #   [Inside Internet Monitor][1] in the Amazon CloudWatch Internet
+    #   [How Internet Monitor works][1] in the Amazon CloudWatch Internet
     #   Monitor section of the Amazon CloudWatch User Guide.
     #
     #
@@ -137,13 +142,15 @@ module Aws::InternetMonitor
     #
     # @!attribute [rw] resources
     #   The resources to include in a monitor, which you provide as a set of
-    #   Amazon Resource Names (ARNs).
+    #   Amazon Resource Names (ARNs). Resources can be VPCs, NLBs, Amazon
+    #   CloudFront distributions, or Amazon WorkSpaces directories.
     #
-    #   You can add a combination of Amazon Virtual Private Clouds (VPCs)
-    #   and Amazon CloudFront distributions, or you can add Amazon
-    #   WorkSpaces directories. You can't add all three types of resources.
+    #   You can add a combination of VPCs and CloudFront distributions, or
+    #   you can add WorkSpaces directories, or you can add NLBs. You can't
+    #   add NLBs or WorkSpaces directories together with any other
+    #   resources.
     #
-    #   <note markdown="1"> If you add only VPC resources, at least one VPC must have an
+    #   <note markdown="1"> If you add only Amazon VPC resources, at least one VPC must have an
     #   Internet Gateway attached to it, to make sure that it has internet
     #   connectivity.
     #
@@ -167,9 +174,10 @@ module Aws::InternetMonitor
     # @!attribute [rw] max_city_networks_to_monitor
     #   The maximum number of city-networks to monitor for your resources. A
     #   city-network is the location (city) where clients access your
-    #   application resources from and the network or ASN, such as an
-    #   internet service provider (ISP), that clients access the resources
-    #   through. This limit helps control billing costs.
+    #   application resources from and the ASN or network provider, such as
+    #   an internet service provider (ISP), that clients access the
+    #   resources through. Setting this limit can help control billing
+    #   costs.
     #
     #   To learn more, see [Choosing a city-network maximum value ][1] in
     #   the Amazon CloudWatch Internet Monitor section of the *CloudWatch
@@ -187,16 +195,36 @@ module Aws::InternetMonitor
     #
     # @!attribute [rw] traffic_percentage_to_monitor
     #   The percentage of the internet-facing traffic for your application
-    #   that you want to monitor with this monitor.
+    #   that you want to monitor with this monitor. If you set a
+    #   city-networks maximum, that limit overrides the traffic percentage
+    #   that you set.
+    #
+    #   To learn more, see [Choosing an application traffic percentage to
+    #   monitor ][1] in the Amazon CloudWatch Internet Monitor section of
+    #   the *CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMTrafficPercentage.html
     #   @return [Integer]
     #
     # @!attribute [rw] health_events_config
-    #   Defines the health event threshold percentages, for performance
-    #   score and availability score. Internet Monitor creates a health
-    #   event when there's an internet issue that affects your application
-    #   end users where a health score percentage is at or below a set
-    #   threshold. If you don't set a health event threshold, the default
-    #   calue is 95%.
+    #   Defines the threshold percentages and other configuration
+    #   information for when Amazon CloudWatch Internet Monitor creates a
+    #   health event. Internet Monitor creates a health event when an
+    #   internet issue that affects your application end users has a health
+    #   score percentage that is at or below a specific threshold, and,
+    #   sometimes, when other criteria are met.
+    #
+    #   If you don't set a health event threshold, the default value is
+    #   95%.
+    #
+    #   For more information, see [ Change health event thresholds][1] in
+    #   the Internet Monitor section of the *CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview
     #   @return [Types::HealthEventsConfig]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/CreateMonitorInput AWS API Documentation
@@ -300,7 +328,12 @@ module Aws::InternetMonitor
     #   @return [String]
     #
     # @!attribute [rw] percent_of_total_traffic_impacted
-    #   The impact on total traffic that a health event has.
+    #   The impact on total traffic that a health event has, in increased
+    #   latency or reduced availability. This is the percentage of how much
+    #   latency has increased or availability has decreased during the
+    #   event, compared to what is typical for traffic from this client
+    #   location to the Amazon Web Services location using this client
+    #   network.
     #   @return [Float]
     #
     # @!attribute [rw] impact_type
@@ -308,8 +341,10 @@ module Aws::InternetMonitor
     #   @return [String]
     #
     # @!attribute [rw] health_score_threshold
-    #   The threshold percentage for health events when Amazon CloudWatch
-    #   Internet Monitor creates a health event.
+    #   The threshold percentage for a health score that determines, along
+    #   with other configuration information, when Internet Monitor creates
+    #   a health event when there's an internet issue that affects your
+    #   application end users.
     #   @return [Float]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/GetHealthEventOutput AWS API Documentation
@@ -351,8 +386,8 @@ module Aws::InternetMonitor
     #   @return [String]
     #
     # @!attribute [rw] resources
-    #   The resources that have been added for the monitor. Resources are
-    #   listed by their Amazon Resource Names (ARNs).
+    #   The resources monitored by the monitor. Resources are listed by
+    #   their Amazon Resource Names (ARNs).
     #   @return [Array<String>]
     #
     # @!attribute [rw] status
@@ -383,9 +418,9 @@ module Aws::InternetMonitor
     # @!attribute [rw] max_city_networks_to_monitor
     #   The maximum number of city-networks to monitor for your resources. A
     #   city-network is the location (city) where clients access your
-    #   application resources from and the network or ASN, such as an
-    #   internet service provider (ISP), that clients access the resources
-    #   through. This limit helps control billing costs.
+    #   application resources from and the ASN or network provider, such as
+    #   an internet service provider (ISP), that clients access the
+    #   resources through. This limit can help control billing costs.
     #
     #   To learn more, see [Choosing a city-network maximum value ][1] in
     #   the Amazon CloudWatch Internet Monitor section of the *CloudWatch
@@ -404,15 +439,31 @@ module Aws::InternetMonitor
     #
     # @!attribute [rw] traffic_percentage_to_monitor
     #   The percentage of the internet-facing traffic for your application
-    #   that you want to monitor with this monitor.
+    #   to monitor with this monitor. If you set a city-networks maximum,
+    #   that limit overrides the traffic percentage that you set.
+    #
+    #   To learn more, see [Choosing an application traffic percentage to
+    #   monitor ][1] in the Amazon CloudWatch Internet Monitor section of
+    #   the *CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMTrafficPercentage.html
     #   @return [Integer]
     #
     # @!attribute [rw] health_events_config
-    #   The list of health event thresholds. A health event threshold
-    #   percentage, for performance and availability, determines the level
-    #   of impact at which Amazon CloudWatch Internet Monitor creates a
-    #   health event when there's an internet issue that affects your
-    #   application end users.
+    #   The list of health event threshold configurations. The threshold
+    #   percentage for a health score determines, along with other
+    #   configuration information, when Internet Monitor creates a health
+    #   event when there's an internet issue that affects your application
+    #   end users.
+    #
+    #   For more information, see [ Change health event thresholds][1] in
+    #   the Internet Monitor section of the *CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview
     #   @return [Types::HealthEventsConfig]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/GetMonitorOutput AWS API Documentation
@@ -473,8 +524,12 @@ module Aws::InternetMonitor
     #   @return [String]
     #
     # @!attribute [rw] percent_of_total_traffic_impacted
-    #   The impact on global traffic monitored by this monitor for this
-    #   health event.
+    #   The impact on total traffic that a health event has, in increased
+    #   latency or reduced availability. This is the percentage of how much
+    #   latency has increased or availability has decreased during the
+    #   event, compared to what is typical for traffic from this client
+    #   location to the Amazon Web Services location using this client
+    #   network.
     #   @return [Float]
     #
     # @!attribute [rw] impact_type
@@ -505,12 +560,35 @@ module Aws::InternetMonitor
       include Aws::Structure
     end
 
-    # A complex type for the configuration. Defines the health event
-    # threshold percentages, for performance score and availability score.
-    # Amazon CloudWatch Internet Monitor creates a health event when
-    # there's an internet issue that affects your application end users
-    # where a health score percentage is at or below a set threshold. If you
-    # don't set a health event threshold, the default value is 95%.
+    # A complex type with the configuration information that determines the
+    # threshold and other conditions for when Internet Monitor creates a
+    # health event for an overall performance or availability issue, across
+    # an application's geographies.
+    #
+    # Defines the percentages, for overall performance scores and
+    # availability scores for an application, that are the thresholds for
+    # when Amazon CloudWatch Internet Monitor creates a health event. You
+    # can override the defaults to set a custom threshold for overall
+    # performance or availability scores, or both.
+    #
+    # You can also set thresholds for local health scores,, where Internet
+    # Monitor creates a health event when scores cross a threshold for one
+    # or more city-networks, in addition to creating an event when an
+    # overall score crosses a threshold.
+    #
+    # If you don't set a health event threshold, the default value is 95%.
+    #
+    # For local thresholds, you also set a minimum percentage of overall
+    # traffic that is impacted by an issue before Internet Monitor creates
+    # an event. In addition, you can disable local thresholds, for
+    # performance scores, availability scores, or both.
+    #
+    # For more information, see [ Change health event thresholds][1] in the
+    # Internet Monitor section of the *CloudWatch User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview
     #
     # @!attribute [rw] availability_score_threshold
     #   The health event threshold percentage set for availability scores.
@@ -520,11 +598,25 @@ module Aws::InternetMonitor
     #   The health event threshold percentage set for performance scores.
     #   @return [Float]
     #
+    # @!attribute [rw] availability_local_health_events_config
+    #   The configuration that determines the threshold and other conditions
+    #   for when Internet Monitor creates a health event for a local
+    #   availability issue.
+    #   @return [Types::LocalHealthEventsConfig]
+    #
+    # @!attribute [rw] performance_local_health_events_config
+    #   The configuration that determines the threshold and other conditions
+    #   for when Internet Monitor creates a health event for a local
+    #   performance issue.
+    #   @return [Types::LocalHealthEventsConfig]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/HealthEventsConfig AWS API Documentation
     #
     class HealthEventsConfig < Struct.new(
       :availability_score_threshold,
-      :performance_score_threshold)
+      :performance_score_threshold,
+      :availability_local_health_events_config,
+      :performance_local_health_events_config)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -663,9 +755,9 @@ module Aws::InternetMonitor
     # geographies. By applying statistical analysis to the data, Internet
     # Monitor can detect when the performance and availability for your
     # application has dropped, compared to an estimated baseline that's
-    # already calculated. To make it easier to see those drops, we report
-    # that information to you in the form of health scores: a performance
-    # score and an availability score.
+    # already calculated. To make it easier to see those drops, Internet
+    # Monitor reports the information to you in the form of health scores: a
+    # performance score and an availability score.
     #
     # @!attribute [rw] availability
     #   Availability in Internet Monitor represents the estimated percentage
@@ -872,6 +964,52 @@ module Aws::InternetMonitor
       include Aws::Structure
     end
 
+    # A complex type with the configuration information that determines the
+    # threshold and other conditions for when Internet Monitor creates a
+    # health event for a local performance or availability issue, when
+    # scores cross a threshold for one or more city-networks.
+    #
+    # Defines the percentages, for performance scores or availability
+    # scores, that are the local thresholds for when Amazon CloudWatch
+    # Internet Monitor creates a health event. Also defines whether a local
+    # threshold is enabled or disabled, and the minimum percentage of
+    # overall traffic that must be impacted by an issue before Internet
+    # Monitor creates an event when a threshold is crossed for a local
+    # health score.
+    #
+    # For more information, see [ Change health event thresholds][1] in the
+    # Internet Monitor section of the *CloudWatch User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview
+    #
+    # @!attribute [rw] status
+    #   The status of whether Internet Monitor creates a health event based
+    #   on a threshold percentage set for a local health score. The status
+    #   can be `ENABLED` or `DISABLED`.
+    #   @return [String]
+    #
+    # @!attribute [rw] health_score_threshold
+    #   The health event threshold percentage set for a local health score.
+    #   @return [Float]
+    #
+    # @!attribute [rw] min_traffic_impact
+    #   The minimum percentage of overall traffic for an application that
+    #   must be impacted by an issue before Internet Monitor creates an
+    #   event when a threshold is crossed for a local health score.
+    #   @return [Float]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/LocalHealthEventsConfig AWS API Documentation
+    #
+    class LocalHealthEventsConfig < Struct.new(
+      :status,
+      :health_score_threshold,
+      :min_traffic_impact)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The description of and information about a monitor in Amazon
     # CloudWatch Internet Monitor.
     #
@@ -962,16 +1100,17 @@ module Aws::InternetMonitor
       include Aws::Structure
     end
 
-    # Measurements about the performance for your application on the
-    # internet calculated by Amazon CloudWatch Internet Monitor. Amazon Web
-    # Services has substantial historical data about internet performance
-    # and availability between Amazon Web Services services and different
-    # network providers and geographies. By applying statistical analysis to
-    # the data, Internet Monitor can detect when the performance and
-    # availability for your application has dropped, compared to an
-    # estimated baseline that's already calculated. To make it easier to
-    # see those drops, we report that information to you in the form of
-    # health scores: a performance score and an availability score.
+    # Amazon CloudWatch Internet Monitor calculates measurements about the
+    # performance for your application's internet traffic between client
+    # locations and Amazon Web Services. Amazon Web Services has substantial
+    # historical data about internet performance and availability between
+    # Amazon Web Services services and different network providers and
+    # geographies. By applying statistical analysis to the data, Internet
+    # Monitor can detect when the performance and availability for your
+    # application has dropped, compared to an estimated baseline that's
+    # already calculated. To make it easier to see those drops, we report
+    # that information to you in the form of health scores: a performance
+    # score and an availability score.
     #
     # Performance in Internet Monitor represents the estimated percentage of
     # traffic that is not seeing a performance drop. For example, a
@@ -1009,10 +1148,12 @@ module Aws::InternetMonitor
     #   @return [Float]
     #
     # @!attribute [rw] percent_of_total_traffic_impacted
-    #   How much performance impact was caused by a health event for total
-    #   traffic globally. For performance, this is the percentage of how
-    #   much latency increased during the event compared to typical
-    #   performance for your application traffic globally.
+    #   The impact on total traffic that a health event has, in increased
+    #   latency or reduced availability. This is the percentage of how much
+    #   latency has increased or availability has decreased during the
+    #   event, compared to what is typical for traffic from this client
+    #   location to the Amazon Web Services location using this client
+    #   network.
     #
     #   For more information, see [When Amazon Web Services creates and
     #   resolves health events][1] in the Amazon CloudWatch Internet Monitor
@@ -1210,15 +1351,17 @@ module Aws::InternetMonitor
     #
     # @!attribute [rw] resources_to_add
     #   The resources to include in a monitor, which you provide as a set of
-    #   Amazon Resource Names (ARNs).
+    #   Amazon Resource Names (ARNs). Resources can be VPCs, NLBs, Amazon
+    #   CloudFront distributions, or Amazon WorkSpaces directories.
     #
-    #   You can add a combination of Amazon Virtual Private Clouds (VPCs)
-    #   and Amazon CloudFront distributions, or you can add Amazon
-    #   WorkSpaces directories. You can't add all three types of resources.
+    #   You can add a combination of VPCs and CloudFront distributions, or
+    #   you can add WorkSpaces directories, or you can add NLBs. You can't
+    #   add NLBs or WorkSpaces directories together with any other
+    #   resources.
     #
-    #   <note markdown="1"> If you add only VPC resources, at least one VPC must have an
-    #   Internet Gateway attached to it, to make sure that it has internet
-    #   connectivity.
+    #   <note markdown="1"> If you add only Amazon Virtual Private Clouds resources, at least
+    #   one VPC must have an Internet Gateway attached to it, to make sure
+    #   that it has internet connectivity.
     #
     #    </note>
     #   @return [Array<String>]
@@ -1244,11 +1387,12 @@ module Aws::InternetMonitor
     #   @return [String]
     #
     # @!attribute [rw] max_city_networks_to_monitor
-    #   The maximum number of city-networks to monitor for your resources. A
-    #   city-network is the location (city) where clients access your
-    #   application resources from and the network or ASN, such as an
-    #   internet service provider, that clients access the resources
-    #   through.
+    #   The maximum number of city-networks to monitor for your application.
+    #   A city-network is the location (city) where clients access your
+    #   application resources from and the ASN or network provider, such as
+    #   an internet service provider (ISP), that clients access the
+    #   resources through. Setting this limit can help control billing
+    #   costs.
     #   @return [Integer]
     #
     # @!attribute [rw] internet_measurements_log_delivery
@@ -1259,14 +1403,31 @@ module Aws::InternetMonitor
     #
     # @!attribute [rw] traffic_percentage_to_monitor
     #   The percentage of the internet-facing traffic for your application
-    #   that you want to monitor with this monitor.
+    #   that you want to monitor with this monitor. If you set a
+    #   city-networks maximum, that limit overrides the traffic percentage
+    #   that you set.
+    #
+    #   To learn more, see [Choosing an application traffic percentage to
+    #   monitor ][1] in the Amazon CloudWatch Internet Monitor section of
+    #   the *CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMTrafficPercentage.html
     #   @return [Integer]
     #
     # @!attribute [rw] health_events_config
-    #   The list of health event thresholds. A health event threshold
-    #   percentage, for performance and availability, determines when
-    #   Internet Monitor creates a health event when there's an internet
-    #   issue that affects your application end users.
+    #   The list of health score thresholds. A threshold percentage for
+    #   health scores, along with other configuration information,
+    #   determines when Internet Monitor creates a health event when
+    #   there's an internet issue that affects your application end users.
+    #
+    #   For more information, see [ Change health event thresholds][1] in
+    #   the Internet Monitor section of the *CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-overview.html#IMUpdateThresholdFromOverview
     #   @return [Types::HealthEventsConfig]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/UpdateMonitorInput AWS API Documentation

data/lib/aws-sdk-internetmonitor.rb

@@ -53,6 +53,6 @@ require_relative 'aws-sdk-internetmonitor/customizations'
 # @!group service
 module Aws::InternetMonitor
 
-  GEM_VERSION = '1.7.0'
+  GEM_VERSION = '1.8.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-internetmonitor
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.8.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-11 00:00:00.000000000 Z
+date: 2023-08-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core