class Runtime
Language | Type name |
---|---|
.NET | Amazon.CDK.AWS.Synthetics.Runtime |
Go | github.com/aws/aws-cdk-go/awscdk/v2/awssynthetics#Runtime |
Java | software.amazon.awscdk.services.synthetics.Runtime |
Python | aws_cdk.aws_synthetics.Runtime |
TypeScript (source) | aws-cdk-lib » aws_synthetics » Runtime |
Runtime options for a canary.
Example
import * as cdk from "aws-cdk-lib";
const canary = new synthetics.Canary(this, 'MyCanary', {
schedule: synthetics.Schedule.rate(Duration.minutes(5)),
test: synthetics.Test.custom({
code: synthetics.Code.fromAsset(path.join(__dirname, 'canary')),
handler: 'index.handler',
}),
runtime: synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_6_2,
memory: cdk.Size.mebibytes(1024), // 1024 MiB
});
Initializer
new Runtime(name: string, family: RuntimeFamily)
Parameters
- name
string
— The name of the runtime version. - family
Runtime
— The Lambda runtime family.Family
Properties
Name | Type | Description |
---|---|---|
family | Runtime | The Lambda runtime family. |
name | string | The name of the runtime version. |
static SYNTHETICS_NODEJS_PLAYWRIGHT_1_0 | Runtime | syn-nodejs-playwright-1.0 includes the following: - Lambda runtime Node.js 20.x - Playwright version 1.45 - Chromium version 126.0.6478.126. |
static SYNTHETICS_NODEJS_PUPPETEER_3_5 | Runtime | 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. |
static SYNTHETICS_NODEJS_PUPPETEER_3_6 | Runtime | 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. |
static SYNTHETICS_NODEJS_PUPPETEER_3_7 | Runtime | 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. |
static SYNTHETICS_NODEJS_PUPPETEER_3_8 | Runtime | 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 SYNTHETICS_NODEJS_PUPPETEER_3_9 | Runtime | syn-nodejs-puppeteer-3.9 includes the following:. |
static SYNTHETICS_NODEJS_PUPPETEER_4_0 | Runtime | 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 SYNTHETICS_NODEJS_PUPPETEER_5_0 | Runtime | 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 SYNTHETICS_NODEJS_PUPPETEER_5_1 | Runtime | 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 SYNTHETICS_NODEJS_PUPPETEER_5_2 | Runtime | 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 SYNTHETICS_NODEJS_PUPPETEER_6_0 | Runtime | 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. |
static SYNTHETICS_NODEJS_PUPPETEER_6_1 | Runtime | 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. |
static SYNTHETICS_NODEJS_PUPPETEER_6_2 | Runtime | 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 SYNTHETICS_NODEJS_PUPPETEER_7_0 | Runtime | 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 SYNTHETICS_NODEJS_PUPPETEER_8_0 | Runtime | syn-nodejs-puppeteer-8.0 includes the following: - Lambda runtime Node.js 20.x - Puppeteer-core version 22.10.0 - Chromium version 125.0.6422.112. |
static SYNTHETICS_NODEJS_PUPPETEER_9_0 | Runtime | syn-nodejs-puppeteer-9.0 includes the following: - Lambda runtime Node.js 20.x - Puppeteer-core version 22.12.1 - Chromium version 126.0.6478.126. |
static SYNTHETICS_NODEJS_PUPPETEER_9_1 | Runtime | syn-nodejs-puppeteer-9.1 includes the following: - Lambda runtime Node.js 20.x - Puppeteer-core version 22.12.1 - Chromium version 126.0.6478.126. |
static SYNTHETICS_PYTHON_SELENIUM_1_0 | Runtime | 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 SYNTHETICS_PYTHON_SELENIUM_1_1 | Runtime | 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 SYNTHETICS_PYTHON_SELENIUM_1_2 | Runtime | 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 SYNTHETICS_PYTHON_SELENIUM_1_3 | Runtime | syn-python-selenium-1.3 includes the following: - Lambda runtime Python 3.8 - Selenium version 3.141.0 - Chromium version 92.0.4512.0. |
static SYNTHETICS_PYTHON_SELENIUM_2_0 | Runtime | syn-python-selenium-2.0 includes the following: - Lambda runtime Python 3.8 - Selenium version 4.10.0 - Chromium version 111.0.5563.146. |
static SYNTHETICS_PYTHON_SELENIUM_2_1 | Runtime | 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 SYNTHETICS_PYTHON_SELENIUM_3_0 | Runtime | syn-python-selenium-3.0 includes the following: - Lambda runtime Python 3.8 - Selenium version 4.15.1 - Chromium version 121.0.6167.139. |
static SYNTHETICS_PYTHON_SELENIUM_4_0 | Runtime | syn-python-selenium-4.0 includes the following: - Lambda runtime Python 3.9 - Selenium version 4.15.1 - Chromium version 126.0.6478.126. |
static SYNTHETICS_PYTHON_SELENIUM_4_1 | Runtime | syn-python-selenium-4.1 includes the following: - Lambda runtime Python 3.9 - Selenium version 4.15.1 - Chromium version 126.0.6478.126. |
family
Type:
Runtime
The Lambda runtime family.
name
Type:
string
The name of the runtime version.
static SYNTHETICS_NODEJS_PLAYWRIGHT_1_0
Type:
Runtime
syn-nodejs-playwright-1.0
includes the following: - Lambda runtime Node.js 20.x - Playwright version 1.45 - Chromium version 126.0.6478.126.
New Features:
- PlayWright support You can write canary scripts by using the Playwright automation framework. You can bring your existing Playwright scripts to run as canaries, and enhance them with AWS monitoring capabilities.
- CloudWatch Logs integration You can query and filter for logs through the CloudWatch Synthetics console. Each log message contains unique canaryRunId, making it easy to search for logs for a particular canary run.
- Metrics and canary artifacts You can monitor canary run pass rate through CloudWatch metrics, and configure alarms to alert you when canaries detect issues.
- Screenshots and steps association You can capture screenshots using native Playwright functionality to visualize the stages of a canary script on each run. Screenshots are automatically associated with canary steps, and are uploaded to Amazon S3 buckets.
- Multiple tabs You can create canaries that open multiple browser tabs, and access screenshots from each tab. You can create multi-tab and multi-step user workflows in Synthetics.
static SYNTHETICS_NODEJS_PUPPETEER_3_5
⚠️ Deprecated: Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.
Type:
Runtime
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.
static SYNTHETICS_NODEJS_PUPPETEER_3_6
⚠️ Deprecated: Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.
Type:
Runtime
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.
static SYNTHETICS_NODEJS_PUPPETEER_3_7
⚠️ Deprecated: Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.
Type:
Runtime
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%.
static SYNTHETICS_NODEJS_PUPPETEER_3_8
⚠️ Deprecated: Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.
Type:
Runtime
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.
static SYNTHETICS_NODEJS_PUPPETEER_3_9
⚠️ Deprecated: Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.
Type:
Runtime
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.
static SYNTHETICS_NODEJS_PUPPETEER_4_0
⚠️ Deprecated: Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.
Type:
Runtime
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.
static SYNTHETICS_NODEJS_PUPPETEER_5_0
⚠️ Deprecated: Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.
Type:
Runtime
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.
static SYNTHETICS_NODEJS_PUPPETEER_5_1
⚠️ Deprecated: Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.
Type:
Runtime
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.
static SYNTHETICS_NODEJS_PUPPETEER_5_2
Type:
Runtime
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
static SYNTHETICS_NODEJS_PUPPETEER_6_0
⚠️ Deprecated: Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.
Type:
Runtime
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.
static SYNTHETICS_NODEJS_PUPPETEER_6_1
⚠️ Deprecated: Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS Puppeteer runtime.
Type:
Runtime
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 {@link https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_CanaryPermissions.html Required roles and permissions for canaries}.
static SYNTHETICS_NODEJS_PUPPETEER_6_2
Type:
Runtime
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
static SYNTHETICS_NODEJS_PUPPETEER_7_0
Type:
Runtime
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.
static SYNTHETICS_NODEJS_PUPPETEER_8_0
Type:
Runtime
syn-nodejs-puppeteer-8.0
includes the following: - Lambda runtime Node.js 20.x - Puppeteer-core version 22.10.0 - Chromium version 125.0.6422.112.
New Features:
- Support for two-factor authentication
- Bug fixes for situations where some service clients were losing data in Node.js SDK V3 responses.
static SYNTHETICS_NODEJS_PUPPETEER_9_0
Type:
Runtime
syn-nodejs-puppeteer-9.0
includes the following: - Lambda runtime Node.js 20.x - Puppeteer-core version 22.12.1 - Chromium version 126.0.6478.126.
New Features:
- Bug fixes Bug fix to enable visual monitoring capabilities.
static SYNTHETICS_NODEJS_PUPPETEER_9_1
Type:
Runtime
syn-nodejs-puppeteer-9.1
includes the following: - Lambda runtime Node.js 20.x - Puppeteer-core version 22.12.1 - Chromium version 126.0.6478.126.
New Features:
- Bug fixes Bug fix related to date ranges and pending requests in HAR files.
static SYNTHETICS_PYTHON_SELENIUM_1_0
⚠️ Deprecated: Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Python Selenium runtime.
Type:
Runtime
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 SYNTHETICS_PYTHON_SELENIUM_1_1
⚠️ Deprecated: Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Python Selenium runtime.
Type:
Runtime
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.
static SYNTHETICS_PYTHON_SELENIUM_1_2
⚠️ Deprecated: Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Python Selenium runtime.
Type:
Runtime
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.
static SYNTHETICS_PYTHON_SELENIUM_1_3
⚠️ Deprecated: Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Python Selenium runtime.
Type:
Runtime
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.
static SYNTHETICS_PYTHON_SELENIUM_2_0
⚠️ Deprecated: Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Python Selenium runtime.
Type:
Runtime
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.
static SYNTHETICS_PYTHON_SELENIUM_2_1
Type:
Runtime
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.
static SYNTHETICS_PYTHON_SELENIUM_3_0
Type:
Runtime
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.
static SYNTHETICS_PYTHON_SELENIUM_4_0
Type:
Runtime
syn-python-selenium-4.0
includes the following: - Lambda runtime Python 3.9 - Selenium version 4.15.1 - Chromium version 126.0.6478.126.
New Features:
- Bug fixes for errors in HAR parser logging.
static SYNTHETICS_PYTHON_SELENIUM_4_1
Type:
Runtime
syn-python-selenium-4.1
includes the following: - Lambda runtime Python 3.9 - Selenium version 4.15.1 - Chromium version 126.0.6478.126.
New Features:
- Addresses security vulnerability This runtime has an update to address the CVE-2024-39689 vulnerability.