software.amazon.awscdk.services.synthetics

Class Canary

java.lang.Object

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

software.amazon.awscdk.services.synthetics.Canary

All Implemented Interfaces:

IConstruct, IDependable, IResource, IConnectable

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-03-28T21:34:23.082Z")
public class Canary
extends Resource
implements IConnectable

(experimental) Define a new Canary.

Example:

 Canary canary = Canary.Builder.create(this, "MyCanary")
         .schedule(Schedule.rate(Duration.minutes(5)))
         .test(Test.custom(CustomTestOptions.builder()
                 .code(Code.fromAsset(join(__dirname, "canary")))
                 .handler("index.handler")
                 .build()))
         .runtime(Runtime.SYNTHETICS_NODEJS_PUPPETEER_3_1)
         .environmentVariables(Map.of(
                 "stage", "prod"))
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Canary.Builder (experimental) A fluent builder for Canary.

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.ec2.IConnectable

IConnectable.Jsii$Default, IConnectable.Jsii$Proxy

Nested classes/interfaces inherited from interface software.amazon.awscdk.core.IResource

IResource.Jsii$Default

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Canary(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Canary(software.amazon.jsii.JsiiObjectRef objRef)
	Canary(software.constructs.Construct scope, java.lang.String id, CanaryProps props)

Method Summary

Modifier and Type	Method and Description
IBucket	getArtifactsBucket() (experimental) Bucket where data from each canary run is stored.
java.lang.String	getCanaryId() (experimental) The canary ID.
java.lang.String	getCanaryName() (experimental) The canary Name.
java.lang.String	getCanaryState() (experimental) The state of the canary.
Connections	getConnections() (experimental) Access the Connections object.
IRole	getRole() (experimental) Execution role associated with this Canary.
Metric	metricDuration() (experimental) Measure the Duration of a single canary run, in seconds.
Metric	metricDuration(MetricOptions options) (experimental) Measure the Duration of a single canary run, in seconds.
Metric	metricFailed() (experimental) Measure the number of failed canary runs over a given time period.
Metric	metricFailed(MetricOptions options) (experimental) Measure the number of failed canary runs over a given time period.
Metric	metricSuccessPercent() (experimental) Measure the percentage of successful canary runs.
Metric	metricSuccessPercent(MetricOptions options) (experimental) Measure the percentage of successful canary runs.

Methods inherited from class software.amazon.awscdk.core.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isResource

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface software.amazon.awscdk.core.IConstruct

getNode

Constructor Detail

Canary

protected Canary(software.amazon.jsii.JsiiObjectRef objRef)

Canary

protected Canary(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

Canary

public Canary(software.constructs.Construct scope,
              java.lang.String id,
              CanaryProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

metricDuration

public Metric metricDuration(MetricOptions options)

(experimental) Measure the Duration of a single canary run, in seconds.

Default: avg over 5 minutes

Parameters:

options - - configuration options for the metric.

metricDuration

public Metric metricDuration()

(experimental) Measure the Duration of a single canary run, in seconds.

Default: avg over 5 minutes

metricFailed

public Metric metricFailed(MetricOptions options)

(experimental) Measure the number of failed canary runs over a given time period.

Default: sum over 5 minutes

Parameters:

options - - configuration options for the metric.

metricFailed

public Metric metricFailed()

(experimental) Measure the number of failed canary runs over a given time period.

Default: sum over 5 minutes

metricSuccessPercent

public Metric metricSuccessPercent(MetricOptions options)

(experimental) Measure the percentage of successful canary runs.

Default: avg over 5 minutes

Parameters:

options - - configuration options for the metric.

metricSuccessPercent

public Metric metricSuccessPercent()

(experimental) Measure the percentage of successful canary runs.

Default: avg over 5 minutes

getArtifactsBucket

public IBucket getArtifactsBucket()

(experimental) Bucket where data from each canary run is stored.

getCanaryId

public java.lang.String getCanaryId()

(experimental) The canary ID.

getCanaryName

public java.lang.String getCanaryName()

(experimental) The canary Name.

getCanaryState

public java.lang.String getCanaryState()

(experimental) The state of the canary.

For example, 'RUNNING', 'STOPPED', 'NOT STARTED', or 'ERROR'.

getConnections

public Connections getConnections()

(experimental) Access the Connections object.

Will fail if not a VPC-enabled Canary

Specified by:

getConnections in interface IConnectable

getRole

public IRole getRole()

(experimental) Execution role associated with this Canary.