Package software.amazon.awscdk.services.synthetics

Class Runtime

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.services.synthetics.Runtime

All Implemented Interfaces:

software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/1.98.0 (build 00b106d)",
           date="2024-05-08T21:35:14.698Z")
@Stability(Stable)
public class Runtime
extends software.amazon.jsii.JsiiObject

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_6_2)
         .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_NODEJS_PUPPETEER_3_5	Deprecated. Legacy runtime no longer supported by AWS Lambda.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_3_6	Deprecated. Legacy runtime no longer supported by AWS Lambda.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_3_7	Deprecated. Legacy runtime no longer supported by AWS Lambda.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_3_8	Deprecated. Legacy runtime no longer supported by AWS Lambda.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_3_9	Deprecated. Legacy runtime no longer supported by AWS Lambda.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_4_0	Deprecated. Legacy runtime no longer supported by AWS Lambda.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_5_0	Deprecated. Legacy runtime no longer supported by AWS Lambda.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_5_1	Deprecated. Legacy runtime no longer supported by AWS Lambda.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_5_2	syn-nodejs-puppeteer-5.2 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_6_0	Deprecated. Legacy runtime no longer supported by AWS Lambda.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_6_1	Deprecated. Legacy runtime no longer supported by AWS Lambda.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_6_2	syn-nodejs-puppeteer-6.2 includes the following: - Lambda runtime Node.js 18.x - Puppeteer-core version 19.7.0 - Chromium version 111.0.5563.146.
static final Runtime	SYNTHETICS_NODEJS_PUPPETEER_7_0	syn-nodejs-puppeteer-7.0 includes the following: - Lambda runtime Node.js 18.x - Puppeteer-core version 21.9.0 - Chromium version 121.0.6167.139.
static final Runtime	SYNTHETICS_PYTHON_SELENIUM_1_0	Deprecated. Legacy runtime no longer supported by AWS Lambda.
static final Runtime	SYNTHETICS_PYTHON_SELENIUM_1_1	Deprecated. Legacy runtime no longer supported by AWS Lambda.
static final Runtime	SYNTHETICS_PYTHON_SELENIUM_1_2	Deprecated. Legacy runtime no longer supported by AWS Lambda.
static final Runtime	SYNTHETICS_PYTHON_SELENIUM_1_3	Deprecated. Legacy runtime no longer supported by AWS Lambda.
static final Runtime	SYNTHETICS_PYTHON_SELENIUM_2_0	Deprecated. Legacy runtime no longer supported by AWS Lambda.
static final Runtime	SYNTHETICS_PYTHON_SELENIUM_2_1	syn-python-selenium-2.1 includes the following: - Lambda runtime Python 3.8 - Selenium version 4.15.1 - Chromium version 111.0.5563.146.
static final Runtime	SYNTHETICS_PYTHON_SELENIUM_3_0	syn-python-selenium-3.0 includes the following: - Lambda runtime Python 3.8 - Selenium version 4.15.1 - Chromium version 121.0.6167.139.

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()	The Lambda runtime family.
String	getName()	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_NODEJS_PUPPETEER_3_5

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

Deprecated.

Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.

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

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_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-3.5

SYNTHETICS_NODEJS_PUPPETEER_3_6

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

Deprecated.

Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.

(deprecated) syn-nodejs-puppeteer-3.6 includes the following: - Lambda runtime Node.js 14.x - Puppeteer-core version 5.5.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(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_3_7

Deprecated.

Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.

(deprecated) syn-nodejs-puppeteer-3.7 includes the following: - Lambda runtime Node.js 14.x - Puppeteer-core version 5.5.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(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_3_8

Deprecated.

Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.

(deprecated) 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(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_3_9

Deprecated.

Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.

(deprecated) 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(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_4_0

Deprecated.

Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.

(deprecated) 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(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_5_0

Deprecated.

Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.

(deprecated) 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(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_5_1

Deprecated.

Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.

(deprecated) 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_NODEJS_PUPPETEER_5_2

@Stability(Stable)
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_5_2

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

New Features:

• Updated versions of the bundled libraries in Chromium
• Bug fixes

See Also:

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

SYNTHETICS_NODEJS_PUPPETEER_6_0

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

Deprecated.

Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.

(deprecated) syn-nodejs-puppeteer-6.0 includes the following: - Lambda runtime Node.js 18.x - Puppeteer-core version 19.7.0 - Chromium version 111.0.5563.146.

New Features:

• Dependency upgrade: The Node.js dependency is upgraded to 18.x. Bug fixes:
• Bug fix: Clean up core dump generated when Chromium crashes during a canary run.

See Also:

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

SYNTHETICS_NODEJS_PUPPETEER_6_1

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

Deprecated.

Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.

(deprecated) syn-nodejs-puppeteer-6.1 includes the following: - Lambda runtime Node.js 18.x - Puppeteer-core version 19.7.0 - Chromium version 111.0.5563.146.

New Features: * **Stability improvements**: Added auto-retry logic for handling intermittent Puppeteer launch errors. * **Dependency upgrades**: Upgrades for some third-party dependency packages. * **Canaries without Amazon S3 permissions**: Bug fixes, such that canaries that don't have any Amazon S3 permissions can still run. These canaries with no Amazon S3 permissions won't be able to upload screenshots or other artifacts to Amazon S3. For more information about permissions for canaries, see

invalid @link

{@link https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_CanaryPermissions.html

Required roles and permissions for canaries}.

See Also:

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

SYNTHETICS_NODEJS_PUPPETEER_6_2

@Stability(Stable)
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_6_2

syn-nodejs-puppeteer-6.2 includes the following: - Lambda runtime Node.js 18.x - Puppeteer-core version 19.7.0 - Chromium version 111.0.5563.146.

New Features:

• Updated versions of the bundled libraries in Chromium
• Ephemeral storage monitoring: This runtime adds ephemeral storage monitoring in customer accounts.
• Bug fixes

See Also:

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

SYNTHETICS_NODEJS_PUPPETEER_7_0

@Stability(Stable)
public static final Runtime SYNTHETICS_NODEJS_PUPPETEER_7_0

syn-nodejs-puppeteer-7.0 includes the following: - Lambda runtime Node.js 18.x - Puppeteer-core version 21.9.0 - Chromium version 121.0.6167.139.

New Features:

• Updated versions of the bundled libraries in Puppeteer and Chromium: The Puppeteer and Chromium dependencies are updated to new versions.

See Also:

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

SYNTHETICS_PYTHON_SELENIUM_1_0

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

Deprecated.

Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Python Selenium runtime.

(deprecated) 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(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_PYTHON_SELENIUM_1_1

Deprecated.

Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Python Selenium runtime.

(deprecated) 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(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_PYTHON_SELENIUM_1_2

Deprecated.

Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Python Selenium runtime.

(deprecated) 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(Deprecated)
@Deprecated
public static final Runtime SYNTHETICS_PYTHON_SELENIUM_1_3

Deprecated.

Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Python Selenium runtime.

(deprecated) 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

SYNTHETICS_PYTHON_SELENIUM_2_0

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

Deprecated.

Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Python Selenium runtime.

(deprecated) syn-python-selenium-2.0 includes the following: - Lambda runtime Python 3.8 - Selenium version 4.10.0 - Chromium version 111.0.5563.146.

New Features:

• Updated dependencies: The Chromium and Selenium dependencies are updated to new versions.
• More precise timestamps: The start time and stop time of canary runs are now precise to the millisecond.

Bug fixes:

• Timestamp added: A timestamp has been added to canary logs.
• Session re-use: A bug was fixed so that canaries are now prevented from reusing the session from their previous canary run.

See Also:

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

SYNTHETICS_PYTHON_SELENIUM_2_1

@Stability(Stable)
public static final Runtime SYNTHETICS_PYTHON_SELENIUM_2_1

syn-python-selenium-2.1 includes the following: - Lambda runtime Python 3.8 - Selenium version 4.15.1 - Chromium version 111.0.5563.146.

New Features:

• Updated versions of the bundled libraries in Chromium: The Chromium and Selenium dependencies are updated to new versions.

See Also:

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

SYNTHETICS_PYTHON_SELENIUM_3_0

@Stability(Stable)
public static final Runtime SYNTHETICS_PYTHON_SELENIUM_3_0

syn-python-selenium-3.0 includes the following: - Lambda runtime Python 3.8 - Selenium version 4.15.1 - Chromium version 121.0.6167.139.

New Features:

• Updated versions of the bundled libraries in Chromium: The Chromium dependency is updated to a new version.

See Also:

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

Constructor Details

Runtime

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

Runtime

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

Runtime

@Stability(Stable)
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(Stable)
@NotNull
public RuntimeFamily getFamily()

The Lambda runtime family.

getName

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

The name of the runtime version.