Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Versions d'exécution Synthetics
Lorsque vous créez ou mettez à jour un script Canary, vous choisissez une version d'environnement d'exécution Synthetics pour le script Canary. Une exécution Synthetics est une combinaison du code Synthetics qui appelle votre gestionnaire de scripts et des couches Lambda de dépendances groupées.
CloudWatch Synthetics prend actuellement en charge les environnements d'exécution qui utilisent les langages Node.js, Python ou Java. Les cadriciels pris en charge sont Puppeteer, Playwright et Selenium.
Nous vous recommandons de toujours utiliser la version d'environnement d'exécution la plus récente pour vos scripts Canary, afin de pouvoir utiliser les dernières fonctionnalités et mises à jour apportées à la bibliothèque Synthetics.
**Remarque** : chaque fois que vous lancez un canary pour utiliser la nouvelle version du moteur d'exécution Synthetics, toutes les fonctions de la bibliothèque Synthetics utilisées par votre canary sont également automatiquement déplacées vers la même version de NodeJS prise en charge par le moteur d'exécution Synthetics.
**Topics**
+ [Versions d’exécution utilisant Java](CloudWatch_Synthetics_Library_Java.md)
+ [Versions d’exécution utilisant Node.js et Playwright](CloudWatch_Synthetics_Library_nodejs_playwright.md)
+ [Versions d'exécution utilisant Node.js et Puppeteer](CloudWatch_Synthetics_Library_nodejs_puppeteer.md)
+ [Versions d'exécution utilisant Python et Selenium Webdriver](CloudWatch_Synthetics_Library_python_selenium.md)
+ [Versions d'exécution utilisant Node.js](CloudWatch_Synthetics_Library_Nodejs.md)
+ [Politique de prise en charge des versions d'exécution](CloudWatch_Synthetics_Runtime_Support_Policy.md)
+ [Mise à jour des versions d'exécution](CloudWatch_Synthetics_Runtime_Version_Update.md)
# Versions d’exécution utilisant Java
La section suivante contient des informations sur les CloudWatch versions d'exécution de Synthetics pour Java. Cette exécution ne comprend aucun navigateur ni cadre.
La convention de dénomination pour ces versions d'exécution est `syn-language -majorversion.minorversion`.
## syn-java-1.0
**Dépendances principales** :
+ AWS Lambda exécution Java 21
**Fonctions**
+ *CloudWatch Intégration des journaux* : vous pouvez interroger et filtrer les journaux via la console CloudWatch Synthetics. Chaque message de journal contient un ` canaryRunId` unique, ce qui facilite la recherche des journaux associés à une exécution particulière du script Canary.
+ *Métriques* — Vous pouvez surveiller le pourcentage de réussite et la durée de Canary Run grâce à CloudWatch des métriques. Vous pouvez également configurer des alarmes pour être averti lorsqu’un script Canary détecte des anomalies.
+ *Artefacts Canary* : chaque exécution du script Canary génère un rapport détaillé contenant les informations sur le déroulement de l’exécution et les différentes étapes, accessible via Amazon S3.
+ *Prise en charge des suivis* : vous pouvez émettre des suivis pour toutes les requêtes effectuées par le script Canary via X-Ray. Chaque exécution du script Canary est associée à un identifiant de suivi unique.
# Versions d’exécution utilisant Node.js et Playwright
Les sections suivantes contiennent des informations sur les CloudWatch versions d'exécution de Synthetics pour Node.js et Playwright. Playwright est une bibliothèque d’automatisation open source utilisée pour les tests de navigateur. [Pour plus d'informations sur Playwright, consultez https://playwright.dev/](https://playwright.dev)
La convention de dénomination pour ces versions d'exécution est `syn-language -framework-majorversion. minorversion`.
## syn-nodejs-playwright-6,0
**Important**
À partir de `syn-nodejs-playwright-5.1` Synthetics et des versions ultérieures, le runtime Synthetics utilise le nouvel espace de noms. Veuillez migrer le script Canary pour utiliser le nouvel espace de noms. L'ancien espace de noms sera obsolète dans une future version.
@ amzn/synthetics-playwright → @aws/synthetics -dramaturge
**Dépendances principales** :
+ AWS Lambda exécution Node.js 22.x
+ Version du dramaturge 1.58.2
+ Playwright/version d'essai 1.58.2
+ Version 145.0.7632.77 de Chrome
+ Version 146.0.1 de Firefox
**Modifications apportées à la version syn-nodejs-playwright -6.0**
+ Correctifs de sécurité appliqués et mises à jour des versions de Playwright et du navigateur.
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Playwright](https://playwright.dev/docs/release-notes)
+ [Référence de l’API Playwright](https://playwright.dev/docs/api/class-playwright)
## Versions d’exécution précédentes pour Node.js et Playwright
Les versions précédentes des environnements d’exécution CloudWatch Synthetics pour Node.js et Playwright restent prises en charge.
### syn-nodejs-playwright-5,1
**Dépendances principales** :
+ AWS Lambda exécution Node.js 22.x
+ Version du dramaturge 1.57.0
+ Playwright/version d'essai 1.57.0
+ Version 143.0.7499.169 de Chrome
+ Version 142.0.1 de Firefox
**Modifications apportées à syn-nodejs-playwright -5.1**
+ Migration de l'espace de noms Synthetics Runtime.
+ La définition du type est disponible dans le [registre npm](https://www.npmjs.com/package/@aws/synthetics-playwright). Assurez-vous que la version du package de définition de type correspond à la version d'exécution de votre Canary.
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Playwright](https://playwright.dev/docs/release-notes)
+ [Référence de l’API Playwright](https://playwright.dev/docs/api/class-playwright)
### syn-nodejs-playwright-5,0
**Dépendances principales** :
+ AWS Lambda exécution Node.js 22.x
+ Version du dramaturge 1.57.0
+ Playwright/version d'essai 1.57.0
+ Version 143.0.7499.4 de Chrome
+ Version 142.0.1 de Firefox
**Modifications apportées à la version syn-nodejs-playwright -5.0**
+ Correctifs de sécurité appliqués et mises à jour des versions de Playwright et du navigateur.
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Playwright](https://playwright.dev/docs/release-notes)
+ [Référence de l’API Playwright](https://playwright.dev/docs/api/class-playwright)
### syn-nodejs-playwright-4,0
**Dépendances principales** :
+ AWS Lambda exécution Node.js 22.x
+ Version du dramaturge 1.55.0
+ Playwright/version d'essai 1.55.0
+ Version 140.0.7339.16 de Chrome
+ Version 141.0 de Firefox
**Modifications apportées à syn-nodejs-playwright -4.0**
+ Correctifs de sécurité appliqués et mises à jour des versions de Playwright et du navigateur.
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Playwright](https://playwright.dev/docs/release-notes)
+ [Référence de l’API Playwright](https://playwright.dev/docs/api/class-playwright)
### syn-nodejs-playwright-3,0
**Dépendances principales** :
+ AWS Lambda exécution Node.js 20.x
+ Playwright : version 1.53.0
+ Playwright/test : version 1.53.0
+ Version 138.0.7204.168 de Chrome
**Modifications apportées à la version syn-nodejs-playwright -3.0**
+ Prise en charge multinavigateurs : vous pouvez désormais exécuter vos scripts Canary Node.js Puppeteer sur Firefox ou Chrome
+ Prise en charge de la surveillance visuelle
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Playwright](https://playwright.dev/docs/release-notes)
+ [Référence de l’API Playwright](https://playwright.dev/docs/api/class-playwright)
### syn-nodejs-playwright-2,0
**Dépendances principales** :
+ AWS Lambda exécution Node.js 20.x
+ Playwright : version 1.49.1
+ Playwright/test : version 1.49.1
+ Version 131.0.6778.264 de Chrome
**Changements par rapport à syn-nodejs-playwright -2.0**
+ L’écart entre la durée totale et la somme des temps individuels pour une requête donnée dans le fichier HAR a été corrigé.
+ Le système prend désormais en charge les exécutions à blanc pour les scripts Canary, ce qui permet d’effectuer des exécutions ponctuelles ou de réaliser des mises à jour sécurisées du script Canary.
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Playwright](https://playwright.dev/docs/release-notes)
+ [Référence de l’API Playwright](https://playwright.dev/docs/api/class-playwright)
### syn-nodejs-playwright-1,0
**Dépendances principales** :
+ AWS Lambda exécution Node.js 20.x
+ Playwright : version 1.44.1
+ Playwright/test : version 1.44.1
+ Version 126.0.6478.126 de Chrome
**Fonctionnalités** :
+ **PlayWright support** — Vous pouvez écrire des scripts Canary en utilisant le framework d'automatisation Playwright. Vous pouvez exécuter vos scripts Playwright existants en tant que scripts Canary et les enrichir avec des fonctions de surveillance AWS .
+ **CloudWatch Intégration des journaux** : vous pouvez interroger et filtrer les journaux via la console CloudWatch Synthetics. Chaque message de journal contient un `canaryRunId` unique, ce qui facilite la recherche des journaux associés à une exécution particulière du script Canary.
+ **Métriques et artefacts liés aux canaris** : vous pouvez surveiller le taux de réussite de Canary Run grâce à CloudWatch des métriques et configurer des alarmes pour vous avertir lorsque les canaris détectent des problèmes.
+ **Captures d’écran et association aux étapes** : vous pouvez prendre des captures d’écran à l’aide des fonctions natives de Playwright afin de visualiser les différentes étapes d’un script Canary à chaque exécution. Les captures d’écran sont automatiquement associées aux étapes du script Canary et chargées dans des compartiments Amazon S3.
+ **Plusieurs onglets** : vous pouvez créer des scripts Canary qui ouvrent plusieurs onglets de navigateur et accéder aux captures d’écran de chacun d’eux. Vous pouvez créer des flux de travail utilisateur à plusieurs onglets et étapes dans Synthetics.
# Versions d'exécution utilisant Node.js et Puppeteer
La première version d'exécution pour Node.js et Puppeteer était appelée `syn-1.0`. Les versions d'exécution ultérieures ont la convention de dénomination `syn-language -majorversion.minorversion`. Commençant par `syn-nodejs-puppeteer-3.0`, la convention de dénomination est `syn- language-framework-majorversion .minorversion`
Un suffixe `-beta` supplémentaire indique que la version d'exécution est actuellement dans une version préliminaire bêta.
Les versions d'environnement d'exécution dotées du même numéro de version majeure sont rétrocompatibles.
Le code Lambda dans un script Canary est configuré pour avoir une mémoire maximale de 1 Go. Chaque exécution d'un script Canary expire après un délai d'attente configuré. Si aucune valeur de délai n'est spécifiée pour un canari, CloudWatch choisit une valeur de délai d'expiration en fonction de la fréquence du canari. Si vous configurez une valeur de délai d'attente, ne dépassez pas 15 secondes pour permettre les démarrages à froid Lambda et le temps nécessaire pour démarrer l'instrumentation canary.
## syn-nodejs-puppeteer-15,0
`syn-nodejs-puppeteer-15.0` est la version la plus récente de l’exécution Synthetics pour Node.js et Puppeteer.
**Important**
À partir de `syn-nodejs-puppeteer-13.1` Synthetics et des versions ultérieures, le runtime Synthetics utilise le nouvel espace de noms. Veuillez migrer le script Canary pour utiliser de nouveaux espaces de noms. Les anciens espaces de noms seront déconseillés dans une future version.
Synthetics → @aws /synthetics-puppeteer
SyntheticsLink → @aws /synthetics-link
SyntheticsLogger → @aws /synthetics-logger
SyntheticsLogHelper → @aws/synthetics-log-helper
BrokenLinkCheckerReport → @aws/synthetics-broken-link-checker-report
**Important**
Synthetics `syn-nodejs-puppeteer-11.0` Runtime et les versions ultérieures ne prennent en charge que les remplacements de configuration suivants au niveau des étapes :
`screenshotOnStepStart`
`screenshotOnStepSuccess`
`screenshotOnStepFailure`
`stepSuccessMetric`
`stepDurationMetric`
`continueOnStepFailure/continueOnHttpStepFailure`
`stepsReport`
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Puppeteer](https://pptr.dev/CHANGELOG#24375-2026-02-19)
+ [Référence de l’API Puppeteer](https://github.com/puppeteer/puppeteer/blob/puppeteer-v24.37.5/docs/api/index.md)
**Dépendances principales** :
+ Runtime Lambda Node.js 22.x
+ Version 24.37.5 de Puppeteer-core
+ Version 145.0.7632.77 de Chrome
+ Version 147.0.4 de Firefox
**Variations par rapport à syn-nodejs-puppeteer -15,0**
+ Correctifs de sécurité appliqués et mises à jour des versions de Puppeteer et du navigateur.
+ Correction d'un bogue qui n' continueOnHttpStepFailure était pas respecté, à cause duquel les exécutions de Canary étaient incorrectement marquées comme réussies malgré les échecs des étapes HTTP.
## Versions d’exécution précédentes pour Node.js et Puppeteer
Les versions précédentes des environnements d’exécution CloudWatch Synthetics pour Node.js et Puppeteer restent prises en charge.
### syn-nodejs-puppeteer-14,0
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Puppeteer](https://pptr.dev/CHANGELOG#24340-2025-12-19)
+ [Référence de l’API Puppeteer](https://github.com/puppeteer/puppeteer/blob/puppeteer-v24.34.0/docs/api/index.md)
**Dépendances principales** :
+ Runtime Lambda Node.js 22.x
+ Version 24.34.0 de Puppeteer-core
+ Version 143.0.7499.169 de Chrome
+ Version 14.6.x de Firefox
**Changements en syn-nodejs-puppeteer -14,0**
+ Correctifs de sécurité appliqués et mises à jour des versions de Puppeteer et du navigateur.
### syn-nodejs-puppeteer-13,1
`syn-nodejs-puppeteer-13.1` est la version la plus récente de l’exécution Synthetics pour Node.js et Puppeteer.
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Puppeteer](https://pptr.dev/CHANGELOG#24250-2025-10-15)
+ [Référence de l’API Puppeteer](https://github.com/puppeteer/puppeteer/blob/puppeteer-v24.2.0/docs/api/index.md)
**Dépendances principales** :
+ Runtime Lambda Node.js 22.x
+ Version 24.25.0 de Puppeteer-core
+ Version 142.0.7444.175 de Chrome
+ Version 145.x de Firefox
**Modifications apportées à la version syn-nodejs-puppeteer -13.1**
+ Migration de l'espace de noms Synthetics Runtime.
+ Les définitions de type sont disponibles dans le registre npm. Assurez-vous que la version du package de définition de type correspond à la version d'exécution de votre Canary.
+ [@aws /synthetics-marionnettiste](https://www.npmjs.com/package/@aws/synthetics-puppeteer)
+ [@aws /synthetics-link](https://www.npmjs.com/package/@aws/synthetics-link)
+ [@aws/synthetics-broken-link-checker-report](https://www.npmjs.com/package/@aws/synthetics-broken-link-checker-report)
+ [@aws/synthetics-log-helper](https://www.npmjs.com/package/@aws/synthetics-log-helper)
+ [@aws /synthetics-logger](https://www.npmjs.com/package/@aws/synthetics-logger)
### syn-nodejs-puppeteer-13,0
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Puppeteer](https://pptr.dev/CHANGELOG#24250-2025-10-15)
+ [Référence de l’API Puppeteer](https://github.com/puppeteer/puppeteer/blob/puppeteer-v24.2.0/docs/api/index.md)
**Dépendances principales** :
+ Runtime Lambda Node.js 22.x
+ Version 24.25.0 de Puppeteer-core
+ Version 142.0.7444.175 de Chrome
+ Version 145.x de Firefox
**Changements par rapport à syn-nodejs-puppeteer -13,0**
+ Correctifs de sécurité appliqués et mises à jour des versions de Puppeteer et du navigateur.
+ Correction d'un bug — Correction d'un problème de plantage intermittent de l'extension d'exécution causé par un accès simultané aux cartes
### syn-nodejs-puppeteer-12,0
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Puppeteer](https://pptr.dev/CHANGELOG#24221-2025-09-23)
+ [Référence de l’API Puppeteer](https://github.com/puppeteer/puppeteer/blob/puppeteer-v24.22.1/docs/api/index.md)
**Dépendances principales** :
+ Runtime Lambda Node.js 22.x
+ Version 24.22.1 de Puppeteer-core
+ Version 140.0.7339.185 de Chrome
+ Version 143.0.1 de Firefox
**Changements par rapport à syn-nodejs-puppeteer -12,0**
+ Correctifs de sécurité appliqués et mises à jour des versions de Puppeteer et du navigateur.
+ Correction d'un bogue concernant la rédaction restreinte des en-têtes — Correction d'un problème en raison duquel, dans certains cas, les en-têtes restreints n'étaient pas expurgés dans executeHttpStep (). Le comportement est désormais compatible avec Puppeteer 10.0.
+ Correction d'un bogue relatif à includeResponseBody la configuration — Correction d'un problème en raison duquel la génération de fichiers HAR pouvait mal appliquer les paramètres includeResponseBody de configuration dans certaines situations. HAR garantit désormais que les corps de réponse sont exclus lors de la configuration du paramètre.
+ Correction du cycle de vie de capture des demandes — Correction d'un problème en raison duquel, dans certaines situations, le capteur de requêtes HTTP pouvait provoquer une agrégation continue des demandes. L'enregistrement se termine désormais correctement après chaque exécution d'étape.
### syn-nodejs-puppeteer-11,0
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Puppeteer](https://pptr.dev/CHANGELOG)
+ [Référence de l’API Puppeteer](https://github.com/puppeteer/puppeteer/blob/puppeteer-v24.2.0/docs/api/index.md)
**Dépendances principales** :
+ Exécution Lambda Node.js 20.x
+ Version 24.15.0 de Puppeteer-core
+ Version 138.0.7204.168 de Chrome
**Changements par rapport à syn-nodejs-puppeteer -11,0**
+ Prise en charge multnavigateurs : vous pouvez désormais exécuter vos scripts Canary Node.js Puppeteer sur Firefox ou Chrome
+ Package simplifié : les scripts peuvent désormais être empaquetés directement à la racine, sans avoir à utiliser la structure de répertoires Node.js/node\$1modules
+ Intégration des captures d’écran : prenez des captures d’écran à l’aide des fonctions natives de Puppeteer afin de visualiser les différentes étapes du script Canary. Synthetics associe automatiquement les captures d’écran aux étapes du script Canary et les charge dans Amazon S3
+ Interrogation améliorée des journaux : interrogez et filtrez les journaux via la console CloudWatch Insights. Chaque message de journal comprend un `canaryRunId` unique, ce qui facilite la recherche
+ Prise en charge d’un fichier de configuration : vous pouvez définir et mettre à jour les paramètres Synthetics à l’aide d’un fichier synthetics.json. Cette séparation entre la configuration et la logique du script améliore la maintenance et la réutilisabilité.
+ Prise en charge de plusieurs onglets : vous pouvez créer des scripts Canary qui ouvrent plusieurs onglets de navigateur et accéder aux captures d’écran de chacun d’eux. Vous pouvez créer des flux de travail utilisateur à plusieurs onglets et étapes dans Synthetics
+ Correctifs de sécurité
+ Corrections liées à la surveillance visuelle
+ Ajout de la prise en charge de la journalisation JSON structurée avec des niveaux de journalisation configurables — Les journaux sont désormais émis au format JSON pour faciliter l'analyse et les requêtes. CloudWatch Le niveau de journalisation (par exemple, DEBUG, INFO, TRACE) peut être configuré via des variables d’environnement, permettant de contrôler le niveau de verbosité selon les besoins
+ Prise en charge de la syntaxe ES
### syn-nodejs-puppeteer-10,0
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Puppeteer](https://pptr.dev/CHANGELOG)
+ [Référence de l’API Puppeteer](https://github.com/puppeteer/puppeteer/blob/puppeteer-v24.2.0/docs/api/index.md)
**Dépendances principales** :
+ Exécution Lambda Node.js 20.x
+ Version 24.2.0 de Puppeteer-core
+ Version 131.0.6778.264 de Chrome
**Changements par rapport à syn-nodejs-puppeteer -10,0**
+ Le bogue lié à la fermeture du navigateur, qui prenait un temps excessif, a été corrigé.
+ Le système prend désormais en charge les exécutions à blanc pour les scripts Canary, ce qui permet d’effectuer des exécutions ponctuelles ou de réaliser des mises à jour sécurisées du script Canary.
### syn-nodejs-puppeteer-9,1
**Dépendances principales** :
+ Exécution Lambda Node.js 20.x
+ Puppeteer-core version 22.12.1
+ Version 126.0.6478.126 de Chrome
**Modifications apportées à syn-nodejs-puppeteer -9.1** — Les corrections de bogues liées aux plages de dates et aux demandes en attente dans les fichiers HAR sont corrigées.
### syn-nodejs-puppeteer-9,0
**Dépendances principales** :
+ Exécution Lambda Node.js 20.x
+ Puppeteer-core version 22.12.1
+ Version 126.0.6478.126 de Chrome
**Modifications apportées à la syn-nodejs-puppeteer version -9.0** — La correction de bogue permettant d'activer les fonctionnalités de surveillance visuelle est corrigée.
### syn-nodejs-puppeteer-8,0
**Avertissement**
En raison d’un bogue, l’exécution `syn-nodejs-puppeteer-8.0` ne prenait pas en charge la surveillance visuelle des scripts Canary. Passez à [syn-nodejs-puppeteer-9,0](#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-9.0) pour bénéficier de la correction liée à la surveillance visuelle.
**Important**
Les environnements d'exécution Lambda Node.js 18 et versions ultérieures utilisent le AWS SDK pour V3. JavaScript Si vous devez migrer un Canary à partir d'un environnement d'exécution antérieur, suivez l'[atelier de migration aws-sdk-js-v 3](https://github.com/aws-samples/aws-sdk-js-v3-workshop) sur GitHub. Pour plus d'informations sur le AWS SDK pour la JavaScript version 3, consultez [ce billet de blog](https://aws.amazon.com/blogs/developer/modular-aws-sdk-for-javascript-is-now-generally-available/).
**Dépendances principales** :
+ Exécution Lambda Node.js 20.x
+ Version 22.10.0 de Puppeteer-core
+ Version 125.0.6422.112 de Chrome
**Mises à jour en syn-nodejs-puppeteer version -8.0** :
+ **Prise en charge de l’authentification à deux facteurs**
+ **Corrections de bogues** : résolution d’un problème où certains clients de service perdaient des données dans les réponses du kit SDK Node.js V3.
## Versions d’exécution obsolètes pour Node.js et Puppeteer
Les versions d’exécution suivantes pour Node.js et Puppeteer sont désormais obsolètes. Pour plus d’informations les dates de fin de prise en charge des versions d’exécution, consultez [CloudWatch Dates de dépréciation de Synthetics Runtime](CloudWatch_Synthetics_Runtime_Support_Policy.md#runtime_deprecation_dates).
### syn-nodejs-puppeteer-7,0
**Dépendances principales** :
+ Exécution Lambda Node.js 18.x
+ Version 21.9.0 de Puppeteer-core
+ Version 121.0.6167.139 de Chrome
**Taille du code** :
La taille du code et des dépendances pouvant être empaquetés dans cette exécution est de 80 Mo.
**Mises à jour en syn-nodejs-puppeteer version -7.0** :
+ **Mise à jour des bibliothèques groupées de Puppeteer et Chromium** : les dépendances Puppeteer et Chromium ont été mises à jour vers de nouvelles versions.
**Important**
Le passage de Puppeteer 19.7.0 à Puppeteer 21.9.0 introduit des modifications majeures concernant les tests et les filtres. Pour plus d’informations, consultez les sections **MODIFICATIONS MAJEURES** dans [puppeteer : v20.0.0](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v20.0.0) et [puppeteer-core : v21.0.0](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-core-v21.0.0).
**Mise à niveau recommandée vers le AWS SDK v3**
Le runtime Lambda nodejs18.x ne prend pas en charge le SDK v2. AWS Nous vous recommandons vivement de migrer vers le AWS SDK v3.
### syn-nodejs-puppeteer-6,2
**Dépendances principales** :
+ Exécution Lambda Node.js 18.x
+ Puppeteer-core version 19.7.0
+ Chromium version 111.0.5563.146
**Modifications apportées à la syn-nodejs-puppeteer version -6.2** :
+ **Versions mises à jour des bibliothèques groupées de Chromium**
+ **Surveillance du stockage éphémère** : cette version d’exécution ajoute la surveillance du stockage éphémère dans les comptes clients.
+ **Corrections de bugs**
### syn-nodejs-puppeteer-6,1
**Dépendances principales** :
+ Exécution Lambda Node.js 18.x
+ Puppeteer-core version 19.7.0
+ Chromium version 111.0.5563.146
**Mises à jour en syn-nodejs-puppeteer -6.1** :
+ **Améliorations de la stabilité** : ajout d’une logique de réessai automatique pour gérer les erreurs de lancement intermittentes de Puppeteer.
+ **Mises à niveau des dépendances** : met à niveau certains packages de dépendance tiers.
+ **Scripts canary sans autorisation Amazon S3** : corrections de bogues, de sorte que les scripts canary ne disposant d’aucune autorisation Amazon S3 peuvent toujours fonctionner. Ces scripts canary ne disposant d’aucune autorisation Amazon S3 ne pourront pas télécharger de captures d’écran ou d’autres artefacts sur Amazon S3. Pour plus d’informations sur les autorisations requises pour les scripts canary, veuillez consulter la rubrique [Rôles et autorisations requis pour les scripts Canary](CloudWatch_Synthetics_Canaries_CanaryPermissions.md).
**Important**
IMPORTANT : Le AWS SDK inclus pour la dépendance JavaScript v2 sera supprimé et mis à jour pour utiliser le AWS SDK pour JavaScript v3 dans une future version d'exécution. À ce moment-là, vous pourrez mettre à jour les références de votre code canary. Vous pouvez également continuer à référencer et à utiliser le AWS SDK inclus pour la dépendance JavaScript v2 en l'ajoutant en tant que dépendance à votre fichier zip de code source.
### syn-nodejs-puppeteer-6,0
**Dépendances principales** :
+ Exécution Lambda Node.js 18.x
+ Puppeteer-core version 19.7.0
+ Chromium version 111.0.5563.146
**Mises à jour dans la syn-nodejs-puppeteer version -6.0** :
+ **Mise à niveau de dépendance** – La dépendance Node.js est mise à niveau vers la version 18.x.
+ **Support du mode d'interception** : le support du mode d'interception coopératif de Puppeteer a été ajouté à la bibliothèque d'exécution Synthetics Canary.
+ **Modification du comportement de suivi** : modification du comportement de suivi par défaut pour ne suivre que les requêtes fetch et xhr, et ne pas suivre les requêtes de ressources. Vous pouvez activer le suivi des requêtes de ressources en configurant l'option `traceResourceRequests`.
+ **Mesure de durée affinée** — La ` Duration` métrique exclut désormais le temps de fonctionnement utilisé par Canary pour télécharger des artefacts, prendre des captures d'écran et générer des CloudWatch métriques. `Duration`les valeurs métriques sont signalées à CloudWatch, et vous pouvez également les consulter dans la console Synthetics.
+ **Correction de bogue :** : vidage de mémoire généré lorsque Chromium se bloque lors d'une exécution de script canary.
**Important**
IMPORTANT : Le AWS SDK inclus pour la dépendance JavaScript v2 sera supprimé et mis à jour pour utiliser le AWS SDK pour JavaScript v3 dans une future version d'exécution. À ce moment-là, vous pourrez mettre à jour les références de votre code canary. Vous pouvez également continuer à référencer et à utiliser le AWS SDK inclus pour la dépendance JavaScript v2 en l'ajoutant en tant que dépendance à votre fichier zip de code source.
### syn-nodejs-puppeteer-5,2
**Dépendances principales** :
+ Exécution Lambda Node.js 16.x
+ Puppeteer-core version 19.7.0
+ Chromium version 111.0.5563.146
**Mises à jour en syn-nodejs-puppeteer -5.2** :
+ **Versions mises à jour des bibliothèques groupées de Chromium**
+ **Corrections de bugs**
### syn-nodejs-puppeteer-5,1
**Dépendances principales** :
+ Exécution Lambda Node.js 16.x
+ Puppeteer-core version 19.7.0
+ Chromium version 111.0.5563.146
**Corrections de bugs dans syn-nodejs-puppeteer -5.1** :
+ **Correction de bogue** – Cette exécution corrige un bogue dans ` syn-nodejs-puppeteer-5.0` où les fichiers HAR créés par les scripts canary n'avaient pas d'en-têtes de requête.
### syn-nodejs-puppeteer-5,0
**Dépendances principales** :
+ Exécution Lambda Node.js 16.x
+ Puppeteer-core version 19.7.0
+ Chromium version 111.0.5563.146
**Mises à jour dans la syn-nodejs-puppeteer version -5.0** :
+ **Mise à niveau des dépendances** – La version Puppeteer-core est mise à jour vers la version 19.7.0. La version Chromium est mise à niveau vers la version 111.0.5563.146.
**Important**
La nouvelle version de Puppeteer-core n'est pas totalement rétrocompatible avec les versions précédentes de Puppeteer. Certaines modifications apportées à cette version peuvent entraîner l'échec des scripts canary existants qui utilisent des fonctions Puppeteer obsolètes. Pour plus d'informations, consultez les derniers changements pour les versions 19.7.0 à 6.0 de Puppeteer-core dans les [journaux des modifications de Puppeteer](https://github.com/puppeteer/puppeteer/releases?q=breaking&expanded=true).
### syn-nodejs-puppeteer-4,0
**Dépendances principales** :
+ Exécution Lambda Node.js 16.x
+ Puppeteer-core version 5.5.0
+ Chromium version 92.0.4512
**Mises à jour en syn-nodejs-puppeteer -4.0** :
+ **Mise à niveau de dépendance** – La dépendance Node.js est mise à niveau vers la version 16.x.
### syn-nodejs-puppeteer-3,9
**Important**
Cette version d’exécution a été rendue obsolète le 8 janvier 2024. Pour de plus amples informations, veuillez consulter [Politique de prise en charge des versions d'exécution](CloudWatch_Synthetics_Runtime_Support_Policy.md).
**Dépendances principales** :
+ Moteur d'exécution Lambda Node.js 14.x
+ Puppeteer-core version 5.5.0
+ Chromium version 92.0.4512
**Mises à jour en syn-nodejs-puppeteer -3.9** :
+ **Mises à niveau des dépendances** : met à niveau certains packages de dépendance tiers.
### syn-nodejs-puppeteer-3,8
**Important**
Cette version d’exécution a été rendue obsolète le 8 janvier 2024. Pour de plus amples informations, veuillez consulter [Politique de prise en charge des versions d'exécution](CloudWatch_Synthetics_Runtime_Support_Policy.md).
**Dépendances principales** :
+ Moteur d'exécution Lambda Node.js 14.x
+ Puppeteer-core version 5.5.0
+ Chromium version 92.0.4512
**Mises à jour en syn-nodejs-puppeteer -3.8** :
+ **Nettoyage des profils** : les profils Chromium sont désormais nettoyés après chaque exécution de canary.
**Corrections de bugs dans syn-nodejs-puppeteer -3.8** :
+ **Correction de bogues** : auparavant, les canaris de surveillance visuelle cessaient parfois de fonctionner correctement après une exécution sans captures d'écran. Ceci est maintenant corrigé.
### syn-nodejs-puppeteer-3,7
**Important**
Cette version d’exécution a été rendue obsolète le 8 janvier 2024. Pour de plus amples informations, veuillez consulter [Politique de prise en charge des versions d'exécution](CloudWatch_Synthetics_Runtime_Support_Policy.md).
**Dépendances principales** :
+ Moteur d'exécution Lambda Node.js 14.x
+ Puppeteer-core version 5.5.0
+ Chromium version 92.0.4512
**Mises à jour en syn-nodejs-puppeteer -3.7** :
+ **Amélioration de la journalisation** : le canary chargera les journaux sur Amazon S3 même en cas d'expiration ou de panne.
+ **Taille de la couche Lambda réduite** : la taille de la couche Lambda utilisée pour les scripts canary est réduite de 34 %.
**Corrections de bugs dans syn-nodejs-puppeteer -3.7** :
+ **Correction de bogues** : les polices japonaises, chinoises simplifiées et chinoises traditionnelles seront restituées correctement.
### syn-nodejs-puppeteer-3,6
**Important**
Cette version d’exécution a été rendue obsolète le 8 janvier 2024. Pour de plus amples informations, veuillez consulter [Politique de prise en charge des versions d'exécution](CloudWatch_Synthetics_Runtime_Support_Policy.md).
**Dépendances principales** :
+ Moteur d'exécution Lambda Node.js 14.x
+ Puppeteer-core version 5.5.0
+ Chromium version 92.0.4512
**Mises à jour en syn-nodejs-puppeteer -3.6** :
+ **Horodatages plus précis**— L'heure de début et l'heure de fin des scripts Canary sont désormais précises à la milliseconde près.
### syn-nodejs-puppeteer-3,5
**Important**
Cette version d’exécution a été rendue obsolète le 8 janvier 2024. Pour de plus amples informations, veuillez consulter [Politique de prise en charge des versions d'exécution](CloudWatch_Synthetics_Runtime_Support_Policy.md).
**Dépendances principales** :
+ Moteur d'exécution Lambda Node.js 14.x
+ Puppeteer-core version 5.5.0
+ Chromium version 92.0.4512
**Mises à jour en syn-nodejs-puppeteer -3.5** :
+ **Updated Dependencies** (Dépendances mises à jour) : les seules nouvelles fonctions de ce moteur d'exécution sont les dépendances mises à jour.
### syn-nodejs-puppeteer-3,4
**Important**
Cette version d'exécution a été rendue obsolète le 13 novembre 2022. Pour de plus amples informations, veuillez consulter [Politique de prise en charge des versions d'exécution](CloudWatch_Synthetics_Runtime_Support_Policy.md).
**Dépendances principales** :
+ Exécution Lambda Node.js 12.x
+ Puppeteer-core version 5.5.0
+ Chromium version 88.0.4298.0
**Mises à jour en syn-nodejs-puppeteer -3.4** :
+ **Fonction de gestion personnalisée** : vous pouvez désormais utiliser une fonction de gestion personnalisée pour vos scripts Canary. Les exécutions précédentes nécessitaient que le point d'entrée du script comprenne `.handler`.
Vous pouvez également placer des scripts Canary dans n'importe quel dossier et transmettre le nom du dossier dans le gestionnaire. Par exemple, `MyFolder/MyScriptFile.functionname` peut être utilisé comme point d'entrée.
+ **Informations sur les fichiers HAR étendus** : vous pouvez désormais voir des demandes erronées, en attente et incomplètes dans les fichiers HAR produits par les scripts canary.
### syn-nodejs-puppeteer-3,3
**Important**
Cette version d'exécution a été rendue obsolète le 13 novembre 2022. Pour de plus amples informations, veuillez consulter [Politique de prise en charge des versions d'exécution](CloudWatch_Synthetics_Runtime_Support_Policy.md).
**Dépendances principales** :
+ Exécution Lambda Node.js 12.x
+ Puppeteer-core version 5.5.0
+ Chromium version 88.0.4298.0
**Mises à jour en syn-nodejs-puppeteer -3.3** :
+ **Options supplémentaires pour le chiffrement des artefacts** : pour les canaris utilisant ce moteur d'exécution ou une version ultérieure, au lieu d'utiliser une clé AWS gérée pour chiffrer les artefacts stockés dans Amazon S3, vous pouvez choisir d'utiliser une clé gérée par le AWS KMS client ou une clé gérée par Amazon S3. Pour de plus amples informations, veuillez consulter [Chiffrement des artefacts de script Canary](CloudWatch_Synthetics_artifact_encryption.md).
### syn-nodejs-puppeteer-3,2
**Important**
Cette version d'exécution a été rendue obsolète le 13 novembre 2022. Pour de plus amples informations, veuillez consulter [Politique de prise en charge des versions d'exécution](CloudWatch_Synthetics_Runtime_Support_Policy.md).
**Dépendances principales** :
+ Exécution Lambda Node.js 12.x
+ Puppeteer-core version 5.5.0
+ Chromium version 88.0.4298.0
**Mises à jour en syn-nodejs-puppeteer -3.2** :
+ **Surveillance visuelle avec des captures d'écran** : les scripts Canary qui utilisent cette exécution ou une version ultérieure peuvent comparer une capture d'écran prise lors d'une exécution à une version de référence de la même capture d'écran. Si les différences entre les captures d'écran dépassent un seuil de pourcentage spécifié, le script Canary échoue. Pour plus d'informations, consultez [Surveillance visuelle](CloudWatch_Synthetics_Canaries_Library_Nodejs.md#CloudWatch_Synthetics_Library_SyntheticsLogger_VisualTesting) ou [Modèle de surveillance visuelle](CloudWatch_Synthetics_Canaries_Blueprints.md#CloudWatch_Synthetics_Canaries_Blueprints_VisualTesting).
+ **Nouvelles fonctions concernant les données sensibles** : vous pouvez empêcher l'apparition de données sensibles dans les journaux et rapports des scripts Canary. Pour de plus amples informations, veuillez consulter [SyntheticsLogHelper classe](CloudWatch_Synthetics_Canaries_Library_Nodejs.md#CloudWatch_Synthetics_Library_SyntheticsLogHelper).
+ **Fonction obsolète** : la classe ` RequestResponseLogHelper` est rendue obsolète au profit de nouvelles options de configuration. Pour de plus amples informations, veuillez consulter [RequestResponseLogHelper classe](CloudWatch_Synthetics_Canaries_Library_Nodejs.md#CloudWatch_Synthetics_Library_RequestResponseLogHelper).
### syn-nodejs-puppeteer-3,1
**Important**
Cette version d'exécution a été rendue obsolète le 13 novembre 2022. Pour de plus amples informations, veuillez consulter [Politique de prise en charge des versions d'exécution](CloudWatch_Synthetics_Runtime_Support_Policy.md).
**Dépendances principales** :
+ Exécution Lambda Node.js 12.x
+ Puppeteer-core version 5.5.0
+ Chromium version 88.0.4298.0
**Mises à jour en syn-nodejs-puppeteer -3.1** :
+ **Possibilité de configurer CloudWatch les métriques** — Avec cet environnement d'exécution, vous pouvez désactiver les métriques dont vous n'avez pas besoin. Sinon, les canaris publient différentes CloudWatch statistiques pour chaque course canari.
+ **Lien de capture d'écran** : vous pouvez lier une capture d'écran à une étape de script Canary une fois l'étape terminée. Pour ce faire, vous devez faire une capture d'écran à l'aide de la méthode **takeScreenshot**, en utilisant le nom de l'étape à laquelle vous souhaitez associer la capture d'écran. Par exemple, vous pouvez réaliser une étape, ajouter un temps d'attente, puis prendre la capture d'écran.
+ Le **plan de surveillance du rythme cardiaque peut en surveiller plusieurs URLs**. Vous pouvez utiliser le plan de surveillance du rythme cardiaque de la CloudWatch console pour en surveiller plusieurs URLs et voir le statut, la durée, les captures d'écran associées et la raison de l'échec de chaque URL dans le résumé des étapes du rapport Canary Run.
### syn-nodejs-puppeteer-3,0
**Important**
Cette version d'exécution a été rendue obsolète le 13 novembre 2022. Pour de plus amples informations, veuillez consulter [Politique de prise en charge des versions d'exécution](CloudWatch_Synthetics_Runtime_Support_Policy.md).
**Dépendances principales** :
+ Exécution Lambda Node.js 12.x
+ Puppeteer-core version 5.5.0
+ Chromium version 88.0.4298.0
**Mises à jour en syn-nodejs-puppeteer -3.0** :
+ **Dépendances mises à niveau** : cette version utilise Puppeteer version 5.5.0, Node.js 12.x et Chromium 88.0.4298.0.
+ **Accès entre régions au compartiment** : vous pouvez désormais spécifier un compartiment S3 dans une autre région comme compartiment où votre script Canary stocke ses fichiers journaux, ses captures d'écran et ses fichiers HAR.
+ **Nouvelles fonctions disponibles** : cette version ajoute des fonctions de bibliothèque pour récupérer le nom du script Canary et la version d'exécution de Synthetics.
Pour de plus amples informations, veuillez consulter [Classe Synthetics](CloudWatch_Synthetics_Canaries_Library_Nodejs.md#CloudWatch_Synthetics_Library_Synthetics_Class_all).
### syn-nodejs-2.2
Cette section contient des informations sur la version d'exécution `syn-nodejs-2.2`.
**Important**
Cette version d'exécution a été rendue obsolète le 28 mai 2021. Pour de plus amples informations, veuillez consulter [Politique de prise en charge des versions d'exécution](CloudWatch_Synthetics_Runtime_Support_Policy.md).
**Dépendances principales** :
+ Exécution Lambda Node.js 10.x
+ Puppeteer-core version 3.3.0
+ Chromium version 83.0.4103.0
**Modifications apportées à syn-nodejs-2.2** :
+ **Surveillez vos canaris sous forme d'étapes HTTP** — Vous pouvez désormais en tester plusieurs APIs dans un seul canari. Chaque API est testée en tant qu'étape HTTP distincte, et CloudWatch Synthetics surveille le statut de chaque étape à l'aide de métriques et du rapport d'étape de CloudWatch Synthetics. CloudWatch Synthetics ` SuccessPercent` crée des statistiques pour `Duration` chaque étape HTTP.
Cette fonctionnalité est implémentée par la fonction **executeHttpStep(StepName, RequestOptions, callback,** StepConfig). Pour de plus amples informations, veuillez consulter [executeHttpStep(StepName, RequestOptions, [rappel], [StepConfig])](CloudWatch_Synthetics_Canaries_Library_Nodejs.md#CloudWatch_Synthetics_Library_executeHttpStep).
Le modèle de script Canary d'API est mis à jour pour utiliser cette nouvelle fonction.
+ Rapports sur les **requêtes HTTP** : vous pouvez désormais consulter des rapports détaillés sur les requêtes HTTP qui capturent des détails tels que request/response les en-têtes, le corps de la réponse, le code d'état, les délais d'erreur et de performance, le temps de connexion TCP, le temps de prise de contact TLS, l'heure du premier octet et le temps de transfert du contenu. Toutes les requêtes HTTP qui utilisent le HTTP/HTTPS module intégré sont capturées ici. Les en-têtes et le corps de la réponse ne sont par défaut pas capturés, mais cette option peut être activée en définissant les options de configuration.
+ **Configuration globale et au niveau** des étapes — Vous pouvez définir des configurations CloudWatch Synthetics au niveau global, qui sont appliquées à toutes les étapes des canaris. Vous pouvez également remplacer ces configurations au niveau de l'étape en transmettant des key/value paires de configuration pour activer ou désactiver certaines options.
Pour de plus amples informations, veuillez consulter [SyntheticsConfiguration classe](CloudWatch_Synthetics_Canaries_Library_Nodejs.md#CloudWatch_Synthetics_Library_SyntheticsConfiguration).
+ **Configuration pour continuer après un échec de l'étape** : vous pouvez choisir de poursuivre l'exécution des scripts Canary en cas d'échec d'une étape. Pour la fonction ` executeHttpStep`, cette option est activée par défaut. Vous pouvez définir cette option une fois au niveau global ou la définir différemment par étape.
### syn-nodejs-2.1
**Important**
Cette version d'exécution a été rendue obsolète le 28 mai 2021. Pour de plus amples informations, veuillez consulter [Politique de prise en charge des versions d'exécution](CloudWatch_Synthetics_Runtime_Support_Policy.md).
**Dépendances principales** :
+ Exécution Lambda Node.js 10.x
+ Puppeteer-core version 3.3.0
+ Chromium version 83.0.4103.0
**Mises à jour avec syn-nodejs-2.1** :
+ **Comportement de capture d'écran configurable** : offre la possibilité de désactiver la prise de captures d'écran par les scripts Canary d'interface utilisateur. Dans les scripts Canary qui utilisent des versions précédentes des exécutions, les scripts Canary d'interface utilisateur effectuent toujours des captures d'écran avant et après chaque étape. Avec `syn-nodejs-2.1`, ce comportement peut être configuré. La désactivation des captures d'écran peut réduire vos coûts de stockage Amazon S3 et vous aider à vous conformer aux réglementations HIPAA. Pour de plus amples informations, veuillez consulter [SyntheticsConfiguration classe](CloudWatch_Synthetics_Canaries_Library_Nodejs.md#CloudWatch_Synthetics_Library_SyntheticsConfiguration).
+ **Personnalisation des paramètres de lancement de Google Chrome** : vous pouvez désormais configurer les arguments utilisés lorsqu'un script Canary lance une fenêtre de navigateur Google Chrome. Pour de plus amples informations, veuillez consulter [launch(options)](CloudWatch_Synthetics_Canaries_Library_Nodejs.md#CloudWatch_Synthetics_Library_LaunchOptions).
Il peut y avoir une légère augmentation de la durée des scripts Canary lors de l'utilisation de syn-nodejs-2.0 ou d'une version ultérieure, par rapport aux versions antérieures des exécutions des scripts Canary.
### syn-nodejs-2.0
**Important**
Cette version d'exécution a été rendue obsolète le 28 mai 2021. Pour de plus amples informations, veuillez consulter [Politique de prise en charge des versions d'exécution](CloudWatch_Synthetics_Runtime_Support_Policy.md).
**Dépendances principales** :
+ Exécution Lambda Node.js 10.x
+ Puppeteer-core version 3.3.0
+ Chromium version 83.0.4103.0
**Mises à jour avec syn-nodejs-2.0** :
+ **Dépendances mises à niveau** : cette version d'exécution utilise Puppeteer-core version 3.3.0 et Chromium version 83.0.4103.0
+ **Prise en charge du suivi actif X-Ray.** Lorsque le suivi est activé sur un canary, des traces X-Ray sont envoyées pour tous les appels effectués par le canari qui utilisent le navigateur, le AWS SDK ou les modules HTTP ou HTTPS. Les scripts canary dont le suivi est activé apparaissent sur la carte de suivi X-Ray, même s’ils n’envoient pas de demandes à d’autres services ou applications dont le suivi est activé. Pour de plus amples informations, veuillez consulter [Scripts Canary et suivi X-Ray](CloudWatch_Synthetics_Canaries_tracing.md).
+ Rapports **synthétiques** — Pour chaque course à Canary, CloudWatch Synthetics crée un rapport ` SyntheticsReport-PASSED.json` nommé ` SyntheticsReport-FAILED.json` ou qui enregistre des données telles que l'heure de début, l'heure de fin, le statut et les échecs. Il enregistre également l' PASSED/FAILED état de chaque étape du script Canary, ainsi que les échecs et les captures d'écran capturées pour chaque étape.
+ **Rapport du vérificateur des liens rompus** : la nouvelle version du vérificateur de liens rompus inclus dans cette exécution crée un rapport qui inclut les liens qui ont été vérifiés, le code d'état, la raison de l'échec (le cas échéant) et les captures d'écran de la page source et de destination.
+ **Nouvelles CloudWatch métriques** — Synthetics publie les métriques `2xx` nommées`4xx`,`5xx`, `RequestFailed` et dans l'espace de noms. `CloudWatchSynthetics` Ces métriques indiquent le nombre d'échecs 200, 400, 500 et de demande dans les exécutions de scripts Canary. Avec cette version d'exécution, ces métriques sont signalées uniquement pour les scripts Canary d'interface utilisateur et ne sont pas signalées pour les scripts Canary d'API. Elles sont également signalées pour les scripts Canary d'API commençant par la version d'exécution ` syn-nodejs-puppeteeer-2.2`.
+ **Fichiers HAR triables** : vous pouvez maintenant trier vos fichiers HAR par code d'état, taille de la demande et durée.
+ **Horodatage des métriques** : CloudWatch les métriques sont désormais signalées en fonction de l'heure d'invocation de Lambda plutôt que de l'heure de fin de l'exécution de Canary.
**Corrections de bogues dans syn-nodejs-2.0** :
+ Correction du problème lors duquel les erreurs de téléchargement d'artefacts des scripts Canary n'étaient pas signalées. Ces erreurs apparaissent maintenant comme des erreurs d'exécution.
+ Correction du problème lors duquel des demandes redirigées (3xx) étaient incorrectement journalisées en tant qu'erreurs.
+ Correction du problème lors duquel les captures d'écran étaient numérotées à partir de 0. Elles devraient maintenant commencer par 1.
+ Correction du problème lors duquel des captures d'écran étaient brouillées pour les polices chinoises et japonaises.
Il peut y avoir une légère augmentation de la durée des scripts Canary lors de l'utilisation de syn-nodejs-2.0 ou d'une version ultérieure, par rapport aux versions antérieures des exécutions des scripts Canary.
### syn-nodejs-2.0-beta
**Important**
Cette version d'exécution a été rendue obsolète le 8 février 2021. Pour de plus amples informations, veuillez consulter [Politique de prise en charge des versions d'exécution](CloudWatch_Synthetics_Runtime_Support_Policy.md).
**Dépendances principales** :
+ Exécution Lambda Node.js 10.x
+ Puppeteer-core version 3.3.0
+ Chromium version 83.0.4103.0
**Modifications apportées à syn-nodejs-2.0-beta** :
+ **Dépendances mises à niveau** : cette version d'exécution utilise Puppeteer-core version 3.3.0 et Chromium version 83.0.4103.0
+ Rapports **synthétiques** — Pour chaque course à Canary, CloudWatch Synthetics crée un rapport ` SyntheticsReport-PASSED.json` nommé ` SyntheticsReport-FAILED.json` ou qui enregistre des données telles que l'heure de début, l'heure de fin, le statut et les échecs. Il enregistre également l' PASSED/FAILED état de chaque étape du script Canary, ainsi que les échecs et les captures d'écran capturées pour chaque étape.
+ **Rapport du vérificateur des liens rompus** : la nouvelle version du vérificateur de liens rompus inclus dans cette exécution crée un rapport qui inclut les liens qui ont été vérifiés, le code d'état, la raison de l'échec (le cas échéant) et les captures d'écran de la page source et de destination.
+ **Nouvelles CloudWatch métriques** — Synthetics publie les métriques `2xx` nommées`4xx`,`5xx`, `RequestFailed` et dans l'espace de noms. `CloudWatchSynthetics` Ces métriques indiquent le nombre d'échecs 200, 400, 500 et de demande dans les exécutions de scripts Canary. ACes métriques sont signalées uniquement pour les scripts Canary d'interface utilisateur et ne sont pas signalées pour les scripts Canary d'API.
+ **Fichiers HAR triables** : vous pouvez maintenant trier vos fichiers HAR par code d'état, taille de la demande et durée.
+ **Horodatage des métriques** : CloudWatch les métriques sont désormais signalées en fonction de l'heure d'invocation de Lambda plutôt que de l'heure de fin de l'exécution de Canary.
**Corrections de bogues dans syn-nodejs-2.0-beta** :
+ Correction du problème lors duquel les erreurs de téléchargement d'artefacts des scripts Canary n'étaient pas signalées. Ces erreurs apparaissent maintenant comme des erreurs d'exécution.
+ Correction du problème lors duquel des demandes redirigées (3xx) étaient incorrectement journalisées en tant qu'erreurs.
+ Correction du problème lors duquel les captures d'écran étaient numérotées à partir de 0. Elles devraient maintenant commencer par 1.
+ Correction du problème lors duquel des captures d'écran étaient brouillées pour les polices chinoises et japonaises.
### syn-1.0
La première version d'exécution de Synthetics est `syn-1.0`.
**Dépendances principales** :
+ Exécution Lambda Node.js 10.x
+ Puppeteer-core version 1.14.0
+ La version Chromium qui correspond à Puppeteer-core 1.14.0
# Versions d'exécution utilisant Python et Selenium Webdriver
Les sections suivantes contiennent des informations sur les versions d' CloudWatch exécution de Synthetics pour Python et Selenium Webdriver. Selenium est un outil d'automatisation de navigateur open source. [Pour plus d'informations sur Selenium, consultez le site www.selenium.dev/](https://www.selenium.dev)
Pour obtenir des informations sur les fonctionnalités et les méthodes prises en charge par les versions d’exécution Synthetics utilisant le cadriciel Selenium, consultez [Classes et fonctions des bibliothèques Python et Selenium applicables uniquement aux scripts Canary pour interface utilisateur](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Library_Python.html#CloudWatch_Synthetics_Library_Python_UIcanaries) et [Référence de l’API Selenium](https://www.selenium.dev/selenium/docs/api/py/api.html).
La convention de dénomination pour ces versions d'exécution est `syn-language -framework-majorversion. minorversion`.
## syn-python-selenium-10,0
La version 10.0 est le dernier runtime CloudWatch Synthetics pour Python et Selenium.
**Dépendances principales** :
+ Python 3.11
+ Sélénium 4.32.0
+ Version 145.0.7632.77 de Chrome
**Changements par rapport à syn-python-selenium -10,0**
+ Correctifs de sécurité appliqués et versions de navigateur mises à jour.
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Selenium](https://www.selenium.dev/blog/2025/selenium-4-32-released)
+ [Documentation Selenium](https://www.selenium.dev/selenium/docs/api/py/api.html)
## Versions d’exécution précédentes pour Python et Selenium
Les versions précédentes des versions d’exécution pour Python et Selenium restent prises en charge.
### syn-python-selenium-9,0
**Dépendances principales** :
+ Python 3.11
+ Sélénium 4.32.0
+ Version 143.0.7499.169 de Chrome
**Modifications apportées à la version syn-python-selenium -9.0**
+ Correctifs de sécurité appliqués et versions de navigateur mises à jour.
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Selenium](https://www.selenium.dev/blog/2025/selenium-4-32-released)
+ [Documentation Selenium](https://www.selenium.dev/selenium/docs/api/py/api.html)
### syn-python-selenium-8,0
La version 8.0 est le dernier runtime CloudWatch Synthetics pour Python et Selenium.
**Dépendances principales** :
+ Python 3.11
+ Sélénium 4.32.0
+ Version 142.0.7444.175 de Chrome
**Modifications apportées à la version syn-python-selenium -8.0**
+ Correctifs de sécurité appliqués et versions mises à jour de Selenium et du navigateur.
+ Modification du niveau du journal des requêtes réseau HAR ayant échoué, passant de ERROR à INFO.
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Selenium](https://www.selenium.dev/blog/2025/selenium-4-32-released)
+ [Documentation Selenium](https://www.selenium.dev/selenium/docs/api/py/api.html)
### syn-python-selenium-7,0
**Dépendances principales** :
+ Python 3.11
+ Sélénium 4.32.0
+ Version 138.0.7204.168 de Chrome
**Modifications apportées à la version syn-python-selenium -7.0**
+ Correctifs de sécurité appliqués et versions mises à jour de Selenium et du navigateur.
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Selenium](https://www.selenium.dev/blog/2025/selenium-4-32-released)
+ [Documentation Selenium](https://www.selenium.dev/selenium/docs/api/py/api.html)
### syn-python-selenium-6,0
**Dépendances principales** :
+ Python 3.11
+ Selenium 4.21.0
+ Version 131.0.6778.264 de Chrome
**Modifications apportées à la version syn-python-selenium -6.0**
+ Mise à niveau de Python 3.9 vers Python 3.11.
Pour plus d’informations, consultez les ressources suivantes :
+ [Journal des modifications de Selenium](https://www.selenium.dev/blog/2024/selenium-4-21-released/)
+ [Documentation Selenium](https://www.selenium.dev/selenium/docs/api/py/api.html)
### syn-python-selenium-5,1
**Dépendances principales** :
+ Python 3.9
+ Selenium 4.21.0
+ Version 131.0.6778.264 de Chrome
**Modifications apportées à syn-python-selenium -5.1**
+ Petites mises à jour concernant l’émission des métriques.
+ Le système prend désormais en charge les exécutions à blanc pour les scripts Canary, ce qui permet d’effectuer des exécutions ponctuelles ou de réaliser des mises à jour sécurisées du script Canary.
### syn-python-selenium-5,0
**Dépendances principales** :
+ Python 3.9
+ Selenium 4.21.0
+ Version 131.0.6778.264 de Chrome
**Changements apportés à la syn-python-selenium version -5.0** :
+ Relance automatique en cas d’échec du lancement du navigateur.
### syn-python-selenium-4,1
**Dépendances principales** :
+ Python 3.9
+ Selenium 4.15.1
+ Version 126.0.6478.126 de Chrome
**Modifications apportées à la syn-python-selenium version -4.1** :
+ **Correction d’une vulnérabilité de sécurité** : cette version d’exécution inclut une mise à jour pour corriger la vulnérabilité [CVE-2024-39689](https://nvd.nist.gov/vuln/detail/CVE-2024-39689).
### syn-python-selenium-4,0
**Dépendances principales** :
+ Python 3.9
+ Selenium 4.15.1
+ Version 126.0.6478.126 de Chrome
**Changements apportés à la syn-python-selenium version -4.0** :
+ **Corrections de bogues** pour des erreurs dans la journalisation de l’analyseur HAR.
## Versions d’exécution obsolètes pour Python et Selenium
Les versions d’exécution antérieures suivantes pour Python et Selenium sont devenues obsolètes. Pour plus d’informations les dates de fin de prise en charge des versions d’exécution, consultez [CloudWatch Dates de dépréciation de Synthetics Runtime](CloudWatch_Synthetics_Runtime_Support_Policy.md#runtime_deprecation_dates).
### syn-python-selenium-3,0
**Dépendances principales** :
+ Python 3.8
+ Selenium 4.15.1
+ Version 121.0.6167.139 de Chrome
**Changements apportés à la syn-python-selenium version -3.0** :
+ **Mise à jour des bibliothèques groupées de Chromium** : la dépendance Chromium a été mise à jour vers une nouvelle version.
### syn-python-selenium-2,1
**Dépendances principales** :
+ Python 3.8
+ Selenium 4.15.1
+ Chromium version 111.0.5563.146
**Changements apportés à syn-python-selenium -2.1** :
+ **Mise à jour des bibliothèques groupées de Chromium** : les dépendances Chromium et Selenium ont été mises à jour vers de nouvelles versions.
### syn-python-selenium-2,0
**Dépendances principales** :
+ Python 3.8
+ Selenium 4.10.0
+ Chromium version 111.0.5563.146
**Changements apportés à syn-python-selenium -2.0** :
+ **Dépendances mises à jour** – Les dépendances de Chromium et Selenium ont été mises à jour vers les nouvelles versions.
**Corrections de bugs dans syn-python-selenium -2.0** :
+ **Horodatage ajouté** – Un horodatage a été ajouté aux journaux de scripts canary.
+ **Réutilisation des sessions** – Un bogue a été corrigé pour empêcher les scripts canary de réutiliser la session de leur précédente exécution.
### syn-python-selenium-1,3
**Dépendances principales** :
+ Python 3.8
+ Selenium 3.141.0
+ Chromium version 92.0.4512.0
**Modifications apportées à la syn-python-selenium version -1.3** :
+ **Horodatages plus précis**— L'heure de début et l'heure de fin des scripts Canary sont désormais précises à la milliseconde près.
### syn-python-selenium-1,2
**Dépendances principales** :
+ Python 3.8
+ Selenium 3.141.0
+ Chromium version 92.0.4512.0
+ **Updated Dependencies** (Dépendances mises à jour) : les seules nouvelles fonctions de ce moteur d'exécution sont les dépendances mises à jour.
### syn-python-selenium-1,1
**Dépendances principales** :
+ Python 3.8
+ Selenium 3.141.0
+ Chromium version 83.0.4103.0
**Fonctionnalités** :
+ **Fonction de gestion personnalisée** : vous pouvez désormais utiliser une fonction de gestion personnalisée pour vos scripts canary. Les exécutions précédentes nécessitaient que le point d'entrée du script comprenne `.handler`.
Vous pouvez également placer des scripts Canary dans n'importe quel dossier et transmettre le nom du dossier dans le gestionnaire. Par exemple, `MyFolder/MyScriptFile.functionname` peut être utilisé comme point d'entrée.
+ **Options de configuration pour ajouter des métriques et des configurations d'échec d'étapes** : Ces options étaient déjà disponibles dans les exécutions pour les scripts canary Node.js. Pour plus d’informations, consultez [SyntheticsConfiguration classe](CloudWatch_Synthetics_Canaries_Library_Python.md#CloudWatch_Synthetics_Library_SyntheticsConfiguration_Python).
+ **Arguments personnalisés dans Chrome** : vous pouvez désormais ouvrir un navigateur en mode navigation privée ou passer en configuration de serveur proxy. Pour de plus amples informations, veuillez consulter [Chrome()](CloudWatch_Synthetics_Canaries_Library_Python.md#CloudWatch_Synthetics_Library_Python_Chrome).
+ **Compartiments d'artefacts entre Régions** : un script Canary peut stocker ses artefacts dans un compartiment Simple Storage Service (Amazon S3) dans une autre Région.
+ **Corrections de bogue, y compris un correctif pour le problème `index.py`** : avec les exécutions précédentes, un fichier Canary nommé ` index.py` a provoqué des exceptions car il entrait en conflit avec le nom du fichier de bibliothèque. Le problème a été résolu.
### syn-python-selenium-1,0
**Dépendances principales** :
+ Python 3.8
+ Selenium 3.141.0
+ Chromium version 83.0.4103.0
**Fonctionnalités** :
+ **Prise en charge de Selenium** : vous pouvez écrire des scripts Canary à l'aide du cadre de test Selenium. Vous pouvez importer vos scripts Selenium d'autres sources dans CloudWatch Synthetics avec un minimum de modifications, et ils fonctionneront avec les services. AWS
# Versions d'exécution utilisant Node.js
La section suivante contient des informations sur les CloudWatch versions d'exécution de Synthetics pour Node.js. Cette exécution ne comprend aucun navigateur ni cadre.
La convention de dénomination pour ces versions d'exécution est `syn-language -majorversion.minorversion`.
## syn-nodejs-4.1
**Important**
À partir de `syn-nodejs-3.1` Synthetics et des versions ultérieures, le runtime Synthetics utilise le nouvel espace de noms. Veuillez migrer le script Canary pour utiliser le nouvel espace de noms. L'ancien espace de noms sera obsolète dans une future version.
@ amzn/synthetics-core → @aws/synthetics -core
**Dépendances principales** :
+ AWS Lambda exécution Node.js 22.x
**Changements dans syn-nodejs-4.1**
+ Passez `fast-xml-parser` à la version 5.5.7 pour résoudre les problèmes suivants : CVEs
+ CVE-2026-25128
+ CVE-2026-25896
+ CVE-2026-26278
+ CVE-2026-27942
+ CVE-2026-33036
## Versions d'exécution précédentes de Node.js
Les versions d'exécution antérieures suivantes de Node.js sont toujours prises en charge.
### syn-nodejs-4.0
**Dépendances principales** :
+ AWS Lambda exécution Node.js 22.x
**Changements dans syn-nodejs-4.0**
+ Correctifs de sécurité appliqués.
### syn-nodejs-3.1
**Important**
À partir de `syn-nodejs-3.1` Synthetics et des versions ultérieures, le runtime Synthetics utilise le nouvel espace de noms. Veuillez migrer le script Canary pour utiliser le nouvel espace de noms. L'ancien espace de noms sera obsolète dans une future version.
@ amzn/synthetics-core → @aws/synthetics -core
**Dépendances principales** :
+ AWS Lambda exécution Node.js 20.x
**Changements dans syn-nodejs-3.1**
+ Migration de l'espace de noms Synthetics Runtime.
+ La définition du type est disponible dans le [registre npm](https://www.npmjs.com/package/@aws/synthetics-core). Assurez-vous que la version du package de définition de type correspond à la version d'exécution de votre Canary.
### syn-nodejs-3.0
**Dépendances principales** :
+ AWS Lambda exécution Node.js 20.x
**Changements dans syn-nodejs-3.0**
+ Support pour le plan à contrôles multiples.
# Politique de prise en charge des versions d'exécution
Les versions d'environnement d'exécution Synthetics sont soumises à des mises à jour de sécurité et de maintenance. Lorsqu'un composant quelconque d'une version d'exécution n'est plus pris en charge, cette version d'exécution Synthetics devient obsolète.
Vous ne pouvez pas créer des scripts Canary à l'aide de versions d'environnement d'exécution obsolètes. Les scripts Canary qui utilisent des environnements d'exécution obsolètes continuent à fonctionner. Vous pouvez arrêter, démarrer et supprimer ces scripts Canary. Vous pouvez mettre à jour un script Canary existant qui utilise une version d'exécution obsolète en mettant à jour le script Canary pour utiliser une version d'exécution prise en charge.
CloudWatch Synthetics vous avertit par e-mail si certains de vos canaris utilisent des runtimes dont la dépréciation est prévue dans les 60 prochains jours. Nous vous recommandons de migrer vos scripts Canary vers une version d'exécution prise en charge pour bénéficier des nouvelles fonctionnalités et des améliorations de la sécurité et des performances incluses dans les versions plus récentes.
## CloudWatch Dates de dépréciation de Synthetics Runtime
Le tableau suivant répertorie la date de dépréciation de chaque environnement d'exécution Synthetics obsolète. CloudWatch
| Version d'exécution | Date d’obsolescence |
| --- | --- |
| `syn-python-selenium-5.1` | 3 février 2026 |
| `syn-python-selenium-5.0` | 3 février 2026 |
| `syn-python-selenium-4.1` | 3 février 2026 |
| `syn-python-selenium-4.0` | 3 février 2026 |
| `syn-nodejs-puppeteer-7.0` | 22 janvier 2026 |
| `syn-nodejs-puppeteer-6.2` | 22 janvier 2026 |
| `syn-nodejs-puppeteer-5.2` | 22 janvier 2026 |
| `syn-python-selenium-3.0` | 22 janvier 2026 |
| `syn-python-selenium-2.1` | 22 janvier 2026 |
| `syn-nodejs-puppeteer-6.1` | 8 mars 2024 |
| `syn-nodejs-puppeteer-6.0` | 8 mars 2024 |
| `syn-nodejs-puppeteer-5.1` | 8 mars 2024 |
| `syn-nodejs-puppeteer-5.0` | 8 mars 2024 |
| `syn-nodejs-puppeteer-4.0` | 8 mars 2024 |
| `syn-nodejs-puppeteer-3.9` | 8 janvier 2024 |
| `syn-nodejs-puppeteer-3.8` | 8 janvier 2024 |
| `syn-python-selenium-2.0` | 8 mars 2024 |
| `syn-python-selenium-1.3` | 8 mars 2024 |
| `syn-python-selenium-1.2` | 8 mars 2024 |
| `syn-python-selenium-1.1` | 8 mars 2024 |
| `syn-python-selenium-1.0` | 8 mars 2024 |
| `syn-nodejs-puppeteer-3.7` | 8 janvier 2024 |
| `syn-nodejs-puppeteer-3.6` | 8 janvier 2024 |
| `syn-nodejs-puppeteer-3.5` | 8 janvier 2024 |
| `syn-nodejs-puppeteer-3.4` | 13 novembre 2022 |
| `syn-nodejs-puppeteer-3.3` | 13 novembre 2022 |
| `syn-nodejs-puppeteer-3.2` | 13 novembre 2022 |
| `syn-nodejs-puppeteer-3.1` | 13 novembre 2022 |
| `syn-nodejs-puppeteer-3.0` | 13 novembre 2022 |
| `syn-nodejs-2.2` | 28 mai 2021 |
| `syn-nodejs-2.1` | 28 mai 2021 |
| `syn-nodejs-2.0` | 28 mai 2021 |
| `syn-nodejs-2.0-beta` | 8 février 2021 |
| `syn-1.0` | 28 mai 2021 |
# Mise à jour des versions d'exécution
Vous pouvez mettre à jour la version d'exécution d'un Canary à l'aide de la CloudWatch console AWS CloudFormation, du SDK AWS CLI ou du AWS SDK. Lorsque vous utilisez la CloudWatch console, vous pouvez mettre à jour jusqu'à cinq canaris à la fois en les sélectionnant dans la page de liste des canaris, puis en choisissant **Actions**, **Update Runtime**.
Vous pouvez vérifier la mise à jour en la testant d'abord avant de valider la mise à jour d'exécution. Lors de la mise à jour des versions d'exécution, choisissez les options **Start Dry Run** ou **Validate et enregistrez ultérieurement** dans la CloudWatch console pour créer une version à sec du Canary original ainsi que toutes les modifications que vous avez apportées à la configuration. L’exécution à blanc mettra à jour et exécutera le script Canary afin de vérifier si la nouvelle version de l’exécution est compatible. Une fois la vérification de la nouvelle version d’exécution terminée et réussie, vous pouvez mettre à jour la version de l’exécution de votre script Canary. Pour de plus amples informations, veuillez consulter [Effectuer des mises à jour sécurisées des scripts Canary](performing-safe-canary-upgrades.md).
Vous pouvez également vérifier la mise à jour en clonant d'abord le Canary à l'aide de la CloudWatch console et en mettant à jour la version d'exécution. Cela crée un autre script Canary qui est un clone de votre script Canary d'origine. Une fois que vous avez vérifié votre script Canary avec la nouvelle version d'exécution, vous pouvez mettre à jour la version d'exécution de votre script Canary d'origine et supprimer le clone de script Canary.
Vous pouvez également mettre à jour plusieurs scripts Canary à l'aide d'un script de mise à niveau. Pour de plus amples informations, veuillez consulter [Script de mise à niveau de l'exécution d'un script Canary](#CloudWatch_Synthetics_Canaries_upgrade_script).
Si vous mettez à niveau un script Canary et qu'il échoue, consultez [Dépannage d'un script Canary ayant échoué](CloudWatch_Synthetics_Canaries_Troubleshoot.md).
## Script de mise à niveau de l'exécution d'un script Canary
Pour mettre à niveau un script Canary vers une version d'exécution prise en charge, utilisez le script suivant.
```
const AWS = require('aws-sdk');
// You need to configure your AWS credentials and Region.
// https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html
// https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-region.html
const synthetics = new AWS.Synthetics();
const DEFAULT_OPTIONS = {
/**
* The number of canaries to upgrade during a single run of this script.
*/
count: 10,
/**
* No canaries are upgraded unless force is specified.
*/
force: false
};
/**
* The number of milliseconds to sleep between GetCanary calls when
* verifying that an update succeeded.
*/
const SLEEP_TIME = 5000;
(async () => {
try {
const options = getOptions();
const versions = await getRuntimeVersions();
const canaries = await getAllCanaries();
const upgrades = canaries
.filter(canary => !versions.isLatestVersion(canary.RuntimeVersion))
.map(canary => {
return {
Name: canary.Name,
FromVersion: canary.RuntimeVersion,
ToVersion: versions.getLatestVersion(canary.RuntimeVersion)
};
});
if (options.force) {
const promises = [];
for (const upgrade of upgrades.slice(0, options.count)) {
const promise = upgradeCanary(upgrade);
promises.push(promise);
// Sleep for 100 milliseconds to avoid throttling.
await usleep(100);
}
const succeeded = [];
const failed = [];
for (let i = 0; i < upgrades.slice(0, options.count).length; i++) {
const upgrade = upgrades[i];
const promise = promises[i];
try {
await promise;
console.log(`The update of ${upgrade.Name} succeeded.`);
succeeded.push(upgrade.Name);
} catch (e) {
console.log(`The update of ${upgrade.Name} failed with error: ${e}`);
failed.push({
Name: upgrade.Name,
Reason: e
});
}
}
if (succeeded.length) {
console.group('The following canaries were upgraded successfully.');
for (const name of succeeded) {
console.log(name);
}
console.groupEnd()
} else {
console.log('No canaries were upgraded successfully.');
}
if (failed.length) {
console.group('The following canaries were not upgraded successfully.');
for (const failure of failed) {
console.log('\x1b[31m', `${failure.Name}: ${failure.Reason}`, '\x1b[0m');
}
console.groupEnd();
}
} else {
console.log('Run with --force [--count ] to perform the first upgrades shown. The default value of is 10.')
console.table(upgrades);
}
} catch (e) {
console.error(e);
}
})();
function getOptions() {
const force = getFlag('--force', DEFAULT_OPTIONS.force);
const count = getOption('--count', DEFAULT_OPTIONS.count);
return { force, count };
function getFlag(key, defaultValue) {
return process.argv.includes(key) || defaultValue;
}
function getOption(key, defaultValue) {
const index = process.argv.indexOf(key);
if (index < 0) {
return defaultValue;
}
const value = process.argv[index + 1];
if (typeof value === 'undefined' || value.startsWith('-')) {
throw `The ${key} option requires a value.`;
}
return value;
}
}
function getAllCanaries() {
return new Promise((resolve, reject) => {
const canaries = [];
synthetics.describeCanaries().eachPage((err, data) => {
if (err) {
reject(err);
} else {
if (data === null) {
resolve(canaries);
} else {
canaries.push(...data.Canaries);
}
}
});
});
}
function getRuntimeVersions() {
return new Promise((resolve, reject) => {
const jsVersions = [];
const pythonVersions = [];
synthetics.describeRuntimeVersions().eachPage((err, data) => {
if (err) {
reject(err);
} else {
if (data === null) {
jsVersions.sort((a, b) => a.ReleaseDate - b.ReleaseDate);
pythonVersions.sort((a, b) => a.ReleaseDate - b.ReleaseDate);
resolve({
isLatestVersion(version) {
const latest = this.getLatestVersion(version);
return latest === version;
},
getLatestVersion(version) {
if (jsVersions.some(v => v.VersionName === version)) {
return jsVersions[jsVersions.length - 1].VersionName;
} else if (pythonVersions.some(v => v.VersionName === version)) {
return pythonVersions[pythonVersions.length - 1].VersionName;
} else {
throw Error(`Unknown version ${version}`);
}
}
});
} else {
for (const version of data.RuntimeVersions) {
if (version.VersionName === 'syn-1.0') {
jsVersions.push(version);
} else if (version.VersionName.startsWith('syn-nodejs-2.')) {
jsVersions.push(version);
} else if (version.VersionName.startsWith('syn-nodejs-puppeteer-')) {
jsVersions.push(version);
} else if (version.VersionName.startsWith('syn-python-selenium-')) {
pythonVersions.push(version);
} else {
throw Error(`Unknown version ${version.VersionName}`);
}
}
}
}
});
});
}
async function upgradeCanary(upgrade) {
console.log(`Upgrading canary ${upgrade.Name} from ${upgrade.FromVersion} to ${upgrade.ToVersion}`);
await synthetics.updateCanary({ Name: upgrade.Name, RuntimeVersion: upgrade.ToVersion }).promise();
while (true) {
await usleep(SLEEP_TIME);
console.log(`Getting the state of canary ${upgrade.Name}`);
const response = await synthetics.getCanary({ Name: upgrade.Name }).promise();
const state = response.Canary.Status.State;
console.log(`The state of canary ${upgrade.Name} is ${state}`);
if (state === 'ERROR' || response.Canary.Status.StateReason) {
throw response.Canary.Status.StateReason;
}
if (state !== 'UPDATING') {
return;
}
}
}
function usleep(ms) {
return new Promise(resolve => setTimeout(resolve, ms));
}
```