All Superinterfaces:: software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:: CfnMonitorProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.94.0 (build b380f01)", date="2024-03-14T22:21:56.441Z") @Stability(Stable) public interface CfnMonitorProps extends software.amazon.jsii.JsiiSerializable

Properties for defining a CfnMonitor.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.internetmonitor.*;
 CfnMonitorProps cfnMonitorProps = CfnMonitorProps.builder()
         .monitorName("monitorName")
         // the properties below are optional
         .healthEventsConfig(HealthEventsConfigProperty.builder()
                 .availabilityLocalHealthEventsConfig(LocalHealthEventsConfigProperty.builder()
                         .healthScoreThreshold(123)
                         .minTrafficImpact(123)
                         .status("status")
                         .build())
                 .availabilityScoreThreshold(123)
                 .performanceLocalHealthEventsConfig(LocalHealthEventsConfigProperty.builder()
                         .healthScoreThreshold(123)
                         .minTrafficImpact(123)
                         .status("status")
                         .build())
                 .performanceScoreThreshold(123)
                 .build())
         .internetMeasurementsLogDelivery(InternetMeasurementsLogDeliveryProperty.builder()
                 .s3Config(S3ConfigProperty.builder()
                         .bucketName("bucketName")
                         .bucketPrefix("bucketPrefix")
                         .logDeliveryStatus("logDeliveryStatus")
                         .build())
                 .build())
         .maxCityNetworksToMonitor(123)
         .resources(List.of("resources"))
         .resourcesToAdd(List.of("resourcesToAdd"))
         .resourcesToRemove(List.of("resourcesToRemove"))
         .status("status")
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .trafficPercentageToMonitor(123)
         .build();

See Also:

Nested Class Summary

Nested Classes

Modifier and Type

Interface

Description

static final class

CfnMonitorProps.Builder

A builder for CfnMonitorProps

static final class

CfnMonitorProps.Jsii$Proxy

An implementation for CfnMonitorProps
Method Summary

Modifier and Type

Method

Description

static CfnMonitorProps.Builder

builder()

default Object

getHealthEventsConfig()

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.

default Object

getInternetMeasurementsLogDelivery()

Publish internet measurements for a monitor for all city-networks (up to the 500,000 service limit) to another location, such as an Amazon S3 bucket.

default Number

getMaxCityNetworksToMonitor()

The maximum number of city-networks to monitor for your resources.

String

getMonitorName()

The name of the monitor.

default List<String>

getResources()

The resources that have been added for the monitor, listed by their Amazon Resource Names (ARNs).

default List<String>

getResourcesToAdd()

The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs).

default List<String>

getResourcesToRemove()

The resources to remove from a monitor, which you provide as a set of Amazon Resource Names (ARNs).

default String

getStatus()

The status of a monitor.

default List<CfnTag>

getTags()

The tags for a monitor, listed as a set of key:value pairs.

default Number

getTrafficPercentageToMonitor()

The percentage of the internet-facing traffic for your application that you want to monitor.

Methods inherited from interface software.amazon.jsii.JsiiSerializable
$jsii$toJson

Method Details
- getMonitorName
  
  @Stability(Stable) @NotNull String getMonitorName()
  
  The name of the monitor.
  A monitor name can contain only alphanumeric characters, dashes (-), periods (.), and underscores (_).
  See Also:
  
  http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-internetmonitor-monitor.html#cfn-internetmonitor-monitor-monitorname
- getHealthEventsConfig
  
  @Stability(Stable) @Nullable default Object getHealthEventsConfig()
  
  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 in the Internet Monitor section of the CloudWatch User Guide .
  See Also:
  
  http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-internetmonitor-monitor.html#cfn-internetmonitor-monitor-healtheventsconfig
- getInternetMeasurementsLogDelivery
  
  @Stability(Stable) @Nullable default Object getInternetMeasurementsLogDelivery()
  
  Publish internet measurements for a monitor for all city-networks (up to the 500,000 service limit) to another location, such as an Amazon S3 bucket.
  Measurements are also published to Amazon CloudWatch Logs for the first 500 (by traffic volume) city-networks (client locations and ASNs, typically internet service providers or ISPs).
  See Also:
  
  http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-internetmonitor-monitor.html#cfn-internetmonitor-monitor-internetmeasurementslogdelivery
- getMaxCityNetworksToMonitor
  
  @Stability(Stable) @Nullable default Number getMaxCityNetworksToMonitor()
  
  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, such as an internet service provider, that clients access the resources through.
  For more information, see Choosing a city-network maximum value in Using Amazon CloudWatch Internet Monitor .
  See Also:
  
  http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-internetmonitor-monitor.html#cfn-internetmonitor-monitor-maxcitynetworkstomonitor
- getResources
  
  @Stability(Stable) @Nullable default List<String> getResources()
  
  The resources that have been added for the monitor, listed by their Amazon Resource Names (ARNs).
  Use this option to add or remove resources when making an update.
  
  Be aware that if you include content in the Resources field when you update a monitor, the ResourcesToAdd and ResourcesToRemove fields must be empty.
  See Also:
  
  http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-internetmonitor-monitor.html#cfn-internetmonitor-monitor-resources
- getResourcesToAdd
  
  @Stability(Stable) @Nullable default List<String> getResourcesToAdd()
  
  The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs).
  Resources can be Amazon Virtual Private Cloud VPCs, Network Load Balancers (NLBs), Amazon CloudFront distributions, or Amazon WorkSpaces directories.
  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.
  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.
  
  You can specify this field for a monitor update only if the Resources field is empty.
  See Also:
  
  http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-internetmonitor-monitor.html#cfn-internetmonitor-monitor-resourcestoadd
- getResourcesToRemove
  
  @Stability(Stable) @Nullable default List<String> getResourcesToRemove()
  
  The resources to remove from a monitor, which you provide as a set of Amazon Resource Names (ARNs).
  
  You can specify this field for a monitor update only if the Resources field is empty.
  See Also:
  
  http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-internetmonitor-monitor.html#cfn-internetmonitor-monitor-resourcestoremove
- getStatus
  
  @Stability(Stable) @Nullable default String getStatus()
  
  The status of a monitor.
  The accepted values that you can specify for Status are ACTIVE and INACTIVE .
  See Also:
  
  http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-internetmonitor-monitor.html#cfn-internetmonitor-monitor-status
- getTags
  
  @Stability(Stable) @Nullable default List<CfnTag> getTags()
  
  The tags for a monitor, listed as a set of key:value pairs.
  See Also:
  
  http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-internetmonitor-monitor.html#cfn-internetmonitor-monitor-tags
- getTrafficPercentageToMonitor
  
  @Stability(Stable) @Nullable default Number getTrafficPercentageToMonitor()
  
  The percentage of the internet-facing traffic for your application that you want to monitor.
  You can also, optionally, set a limit for the number of city-networks (client locations and ASNs, typically internet service providers) that Internet Monitor will monitor traffic for. The city-networks maximum limit caps the number of city-networks that Internet Monitor monitors for your application, regardless of the percentage of traffic that you choose to monitor.
  See Also:
  
  http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-internetmonitor-monitor.html#cfn-internetmonitor-monitor-trafficpercentagetomonitor
- builder
  
  @Stability(Stable) static CfnMonitorProps.Builder builder()
  
  Returns:
  
  a CfnMonitorProps.Builder of CfnMonitorProps

Interface CfnMonitorProps

Nested Class Summary

Method Summary

Methods inherited from interface software.amazon.jsii.JsiiSerializable

Method Details

getMonitorName

getHealthEventsConfig

getInternetMeasurementsLogDelivery

getMaxCityNetworksToMonitor

getResources

getResourcesToAdd

getResourcesToRemove

getStatus

getTags

getTrafficPercentageToMonitor

builder