Package software.amazon.awscdk.services.synthetics.alpha

Class Runtime

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.services.synthetics.alpha.Runtime

All Implemented Interfaces:

software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/1.88.0 (build eaabd08)",
           date="2023-09-13T16:50:20.680Z")
@Stability(Experimental)
public class Runtime
extends software.amazon.jsii.JsiiObject

(experimental) Runtime options for a 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_4_0)
         .environmentVariables(Map.of(
                 "stage", "prod"))
         .build();
 

Nested Class Summary

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Field Summary

Fields

Modifier and Type	Field	Description
static final Runtime	SYNTHETICS_1_0	Deprecated. Use the latest version instead
static final Runtime	SYNTHETICS_NODEJS_2_0	Deprecated. Use the latest version instead
static final Runtime	SYNTHETICS_NODEJS_2_1	Deprecated. Use the latest version instead
static final Runtime	SYNTHETICS_NODEJS_2_2	Deprecated. Use the latest version instead
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_3_0	Deprecated. Use the latest version instead
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_3_1	Deprecated. Use the latest version instead
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_3_2	Deprecated. Use the latest version instead
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_3_3	Deprecated. Use the latest version instead
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_3_4	Deprecated. Use the latest version instead
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_3_5	(experimental) syn-nodejs-puppeteer-3.5 includes the following: - Lambda runtime Node.js 14.x - Puppeteer-core version 10.1.0 - Chromium version 92.0.4512.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_3_6	(experimental) syn-nodejs-puppeteer-3.6 includes the following: - Lambda runtime Node.js 14.x - Puppeteer-core version 10.1.0 - Chromium version 92.0.4512.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_3_7	(experimental) syn-nodejs-puppeteer-3.7 includes the following: - Lambda runtime Node.js 14.x - Puppeteer-core version 10.1.0 - Chromium version 92.0.4512.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_3_8	(experimental) syn-nodejs-puppeteer-3.8 includes the following: - Lambda runtime Node.js 14.x - Puppeteer-core version 10.1.0 - Chromium version 92.0.4512.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_3_9	(experimental) syn-nodejs-puppeteer-3.9 includes the following:.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_4_0	(experimental) syn-nodejs-puppeteer-4.0 includes the following: - Lambda runtime Node.js 16.x - Puppeteer-core version 5.5.0 - Chromium version 92.0.4512.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_5_0	(experimental) syn-nodejs-puppeteer-5.0 includes the following: - Lambda runtime Node.js 16.x - Puppeteer-core version 19.7.0 - Chromium version 111.0.5563.146.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_5_1	(experimental) syn-nodejs-puppeteer-5.1 includes the following: - Lambda runtime Node.js 16.x - Puppeteer-core version 19.7.0 - Chromium version 111.0.5563.146.
static final Runtime	SYNTHETICS_PYTHON_SELENIUM_1_0	(experimental) syn-python-selenium-1.0 includes the following: - Lambda runtime Python 3.8 - Selenium version 3.141.0 - Chromium version 83.0.4103.0.
static final Runtime	SYNTHETICS_PYTHON_SELENIUM_1_1	(experimental) syn-python-selenium-1.1 includes the following: - Lambda runtime Python 3.8 - Selenium version 3.141.0 - Chromium version 83.0.4103.0.
static final Runtime	SYNTHETICS_PYTHON_SELENIUM_1_2	(experimental) syn-python-selenium-1.2 includes the following: - Lambda runtime Python 3.8 - Selenium version 3.141.0 - Chromium version 92.0.4512.0.
static final Runtime	SYNTHETICS_PYTHON_SELENIUM_1_3	(experimental) syn-python-selenium-1.3 includes the following: - Lambda runtime Python 3.8 - Selenium version 3.141.0 - Chromium version 92.0.4512.0.

Constructor Summary

Constructors

Modifier	Constructor	Description
	Runtime(String name, RuntimeFamily family)
protected	Runtime(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Runtime(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method	Description
RuntimeFamily	getFamily()	(experimental) The Lambda runtime family.
String	getName()	(experimental) The name of the runtime version.

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Details

SYNTHETICS_1_0

@Stability(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_1_0

Deprecated.

Use the latest version instead

(deprecated) Deprecated by AWS Synthetics. You can't create canaries with deprecated runtimes..

syn-1.0 includes the following:

• Synthetics library 1.0
• Synthetics handler code 1.0
• Lambda runtime Node.js 10.x
• Puppeteer-core version 1.14.0
• The Chromium version that matches Puppeteer-core 1.14.0

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-1.0

SYNTHETICS_NODEJS_2_0

@Stability(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_NODEJS_2_0

Deprecated.

Use the latest version instead

(deprecated) Deprecated by AWS Synthetics. You can't create canaries with deprecated runtimes..

syn-nodejs-2.0 includes the following:

• Lambda runtime Node.js 10.x
• Puppeteer-core version 3.3.0
• Chromium version 83.0.4103.0

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-2.0

SYNTHETICS_NODEJS_2_1

@Stability(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_NODEJS_2_1

Deprecated.

Use the latest version instead

(deprecated) Deprecated by AWS Synthetics. You can't create canaries with deprecated runtimes..

syn-nodejs-2.1 includes the following:

• Lambda runtime Node.js 10.x
• Puppeteer-core version 3.3.0
• Chromium version 83.0.4103.0

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-2.1

SYNTHETICS_NODEJS_2_2

@Stability(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_NODEJS_2_2

Deprecated.

Use the latest version instead

(deprecated) Deprecated by AWS Synthetics. You can't create canaries with deprecated runtimes..

syn-nodejs-2.2 includes the following:

• Lambda runtime Node.js 10.x
• Puppeteer-core version 3.3.0
• Chromium version 83.0.4103.0

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-2.2

SYNTHETICS_NODEJS_PUPPETEER_3_0

@Stability(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_3_0

Deprecated.

Use the latest version instead

(deprecated) Deprecated by AWS Synthetics. You can't create canaries with deprecated runtimes..

syn-nodejs-puppeteer-3.0 includes the following:

• Lambda runtime Node.js 12.x
• Puppeteer-core version 5.5.0
• Chromium version 88.0.4298.0

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-3.0

SYNTHETICS_NODEJS_PUPPETEER_3_1

@Stability(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_3_1

Deprecated.

Use the latest version instead

(deprecated) Deprecated by AWS Synthetics. You can't create canaries with deprecated runtimes..

syn-nodejs-puppeteer-3.1 includes the following:

• Lambda runtime Node.js 12.x
• Puppeteer-core version 5.5.0
• Chromium version 88.0.4298.0

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-3.1

SYNTHETICS_NODEJS_PUPPETEER_3_2

@Stability(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_3_2

Deprecated.

Use the latest version instead

(deprecated) Deprecated by AWS Synthetics. You can't create canaries with deprecated runtimes..

syn-nodejs-puppeteer-3.2 includes the following:

• Lambda runtime Node.js 12.x
• Puppeteer-core version 5.5.0
• Chromium version 88.0.4298.0

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-3.2

SYNTHETICS_NODEJS_PUPPETEER_3_3

@Stability(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_3_3

Deprecated.

Use the latest version instead

(deprecated) syn-nodejs-puppeteer-3.3 includes the following: Deprecated by AWS Synthetics. You can't create canaries with deprecated runtimes..

• Lambda runtime Node.js 12.x
• Puppeteer-core version 5.5.0
• Chromium version 88.0.4298.0

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-3.3

SYNTHETICS_NODEJS_PUPPETEER_3_4

@Stability(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_3_4

Deprecated.

Use the latest version instead

(deprecated) Deprecated by AWS Synthetics. You can't create canaries with deprecated runtimes..

syn-nodejs-puppeteer-3.4 includes the following:

• Lambda runtime Node.js 12.x
• Puppeteer-core version 5.5.0
• Chromium version 88.0.4298.0

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-3.4

SYNTHETICS_NODEJS_PUPPETEER_3_5

@Stability(Experimental)
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_3_5

(experimental) syn-nodejs-puppeteer-3.5 includes the following: - Lambda runtime Node.js 14.x - Puppeteer-core version 10.1.0 - Chromium version 92.0.4512.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-3.5

SYNTHETICS_NODEJS_PUPPETEER_3_6

@Stability(Experimental)
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_3_6

(experimental) syn-nodejs-puppeteer-3.6 includes the following: - Lambda runtime Node.js 14.x - Puppeteer-core version 10.1.0 - Chromium version 92.0.4512.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-3.6

SYNTHETICS_NODEJS_PUPPETEER_3_7

@Stability(Experimental)
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_3_7

(experimental) syn-nodejs-puppeteer-3.7 includes the following: - Lambda runtime Node.js 14.x - Puppeteer-core version 10.1.0 - Chromium version 92.0.4512.

New Features:

• Logging enhancement: The canary will upload logs to Amazon S3 even if it times out or crashes.
• Lambda layer size reduced: The size of the Lambda layer used for canaries is reduced by 34%.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-3.7

SYNTHETICS_NODEJS_PUPPETEER_3_8

@Stability(Experimental)
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_3_8

(experimental) syn-nodejs-puppeteer-3.8 includes the following: - Lambda runtime Node.js 14.x - Puppeteer-core version 10.1.0 - Chromium version 92.0.4512.

New Features:

• Profile cleanup: Chromium profiles are now cleaned up after each canary run.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-3.8

SYNTHETICS_NODEJS_PUPPETEER_3_9

@Stability(Experimental)
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_3_9

(experimental) syn-nodejs-puppeteer-3.9 includes the following:.

• Lambda runtime Node.js 14.x
• Puppeteer-core version 5.5.0
• Chromium version 92.0.4512

New Features:

• Dependency upgrades: Upgrades some third-party dependency packages.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-3.9

SYNTHETICS_NODEJS_PUPPETEER_4_0

@Stability(Experimental)
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_4_0

(experimental) syn-nodejs-puppeteer-4.0 includes the following: - Lambda runtime Node.js 16.x - Puppeteer-core version 5.5.0 - Chromium version 92.0.4512.

New Features:

• Dependency upgrades: The Node.js dependency is updated to 16.x.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-4.0

SYNTHETICS_NODEJS_PUPPETEER_5_0

@Stability(Experimental)
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_5_0

(experimental) syn-nodejs-puppeteer-5.0 includes the following: - Lambda runtime Node.js 16.x - Puppeteer-core version 19.7.0 - Chromium version 111.0.5563.146.

New Features:

• Dependency upgrade: The Puppeteer-core version is updated to 19.7.0. The Chromium version is upgraded to 111.0.5563.146.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-5.0

SYNTHETICS_NODEJS_PUPPETEER_5_1

@Stability(Experimental)
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_5_1

(experimental) syn-nodejs-puppeteer-5.1 includes the following: - Lambda runtime Node.js 16.x - Puppeteer-core version 19.7.0 - Chromium version 111.0.5563.146.

Bug fixes:

• Bug fix: This runtime fixes a bug in syn-nodejs-puppeteer-5.0 where the HAR files created by the canaries were missing request headers.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-5.1

SYNTHETICS_PYTHON_SELENIUM_1_0

@Stability(Experimental)
public static final Runtime SYNTHETICS_PYTHON_SELENIUM_1_0

(experimental) syn-python-selenium-1.0 includes the following: - Lambda runtime Python 3.8 - Selenium version 3.141.0 - Chromium version 83.0.4103.0.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_python_selenium.html#CloudWatch_Synthetics_runtimeversion-syn-python-selenium-1.0

SYNTHETICS_PYTHON_SELENIUM_1_1

@Stability(Experimental)
public static final Runtime SYNTHETICS_PYTHON_SELENIUM_1_1

(experimental) syn-python-selenium-1.1 includes the following: - Lambda runtime Python 3.8 - Selenium version 3.141.0 - Chromium version 83.0.4103.0.

New Features:

• Custom handler function: You can now use a custom handler function for your canary scripts.
• Configuration options for adding metrics and step failure configurations: These options were already available in runtimes for Node.js canaries.
• Custom arguments in Chrome: You can now open a browser in incognito mode or pass in proxy server configuration.
• Cross-Region artifact buckets: A canary can store its artifacts in an Amazon S3 bucket in a different Region.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_python_selenium.html#CloudWatch_Synthetics_runtimeversion-syn-python-selenium-1.1

SYNTHETICS_PYTHON_SELENIUM_1_2

@Stability(Experimental)
public static final Runtime SYNTHETICS_PYTHON_SELENIUM_1_2

(experimental) syn-python-selenium-1.2 includes the following: - Lambda runtime Python 3.8 - Selenium version 3.141.0 - Chromium version 92.0.4512.0.

New Features:

• Updated dependencies: The only new features in this runtime are the updated dependencies.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_python_selenium.html#CloudWatch_Synthetics_runtimeversion-syn-python-selenium-1.2

SYNTHETICS_PYTHON_SELENIUM_1_3

@Stability(Experimental)
public static final Runtime SYNTHETICS_PYTHON_SELENIUM_1_3

(experimental) syn-python-selenium-1.3 includes the following: - Lambda runtime Python 3.8 - Selenium version 3.141.0 - Chromium version 92.0.4512.0.

New Features:

• More precise timestamps: The start time and stop time of canary runs are now precise to the millisecond.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_python_selenium.html#CloudWatch_Synthetics_runtimeversion-syn-python-selenium-1.3

Constructor Details

Runtime

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

Runtime

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

Runtime

@Stability(Experimental)
public Runtime(@NotNull
 String name,
 @NotNull
 RuntimeFamily family)

Parameters:

name - The name of the runtime version. This parameter is required.

family - The Lambda runtime family. This parameter is required.

Method Details

getFamily

@Stability(Experimental)
@NotNull
public RuntimeFamily getFamily()

(experimental) The Lambda runtime family.

getName

@Stability(Experimental)
@NotNull
public String getName()

(experimental) The name of the runtime version.