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. # Fonctions de bibliothèque disponibles pour Node.js Canary Cette section décrit les fonctions de bibliothèque disponibles pour les scripts Canary à l'aide de l' Node.js environnement d'exécution. **Topics** + [ajouter ExecutionError (ErrorMessage, ex) ;](#Library_function_Nodejs_addExecutionError_Nodecanary) + [obtenir CanaryName () ;](#Library_function_Nodejs_getCanaryName) + [obtenir CanaryArn () ;](#Library_function_Nodejs_Nodecanary) + [obtenir CanaryUserAgentString () ;](#Library_function_Nodejs_getCanaryUserAgentString_Nodecanary) + [obtenir RuntimeVersion () ;](#Library_function_Nodejs_getRuntimeVersion_Nodecanary) + [obtenir LogLevel () ;](#Library_function_Nodejs_getLogLevel_Nodecanary) + [ensemble LogLevel () ;](#Library_function_Nodejs_setLogLevel_Nodecanary) + [ExecuteStep (StepName, fonction, [StepConfig]) ToExecute](#Library_function_Nodejs_executestep_Nodecanary) + [exécuter HttpStep (StepName, RequestOptions, [callback], [StepConfig])](#Library_function_Nodejs_executeHttpStep) ## ajouter ExecutionError (ErrorMessage, ex) ; `errorMessage` décrit l'erreur et `ex` est l'exception rencontrée. Vous pouvez utiliser `addExecutionError` pour définir les erreurs d'exécution pour votre script Canary. Ce code fait échouer le script Canary sans interrompre l'exécution du script. Cela n'a pas non plus d'impact sur vos métriques `successPercent`. Vous ne devriez suivre les erreurs comme des erreurs d'exécution que si elles ne sont pas importantes pour indiquer le succès ou l'échec de votre script Canary. L'exemple suivant illustre l'utilisation de `addExecutionError`. Vous surveillez la disponibilité de votre point de terminaison et vous prenez des captures d'écran après le chargement de la page. Étant donné que l'échec de la prise d'une capture d'écran ne détermine pas la disponibilité du point de terminaison, vous pouvez détecter toutes les erreurs rencontrées lors de la prise de captures d'écran et les ajouter en tant qu'erreurs d'exécution. Vos métriques de disponibilité indiqueront toujours que le point de terminaison est opérationnel, mais le statut de votre script Canary indiquera qu'il a échoué. L'exemple de bloc de code suivant détecte une telle erreur et l'ajoute en tant qu'erreur d'exécution. ``` try {await synthetics.executeStep(stepName, callbackFunc);} catch(ex) {synthetics.addExecutionError('Unable to take screenshot ', ex);} ``` ## obtenir CanaryName () ; Renvoie le nom du script Canary. ## obtenir CanaryArn () ; Renvoie l'ARN du script canary. ## obtenir CanaryUserAgentString () ; Renvoie l'agent utilisateur personnalisé du script canary. ## obtenir RuntimeVersion () ; Cette fonction est disponible sur les versions d'exécution `syn-nodejs-3.0` et ultérieures. Elle renvoie la version d'exécution Synthetics du script Canary. Par exemple, la valeur renvoyée peut être `syn-nodejs-3.0`. ## obtenir LogLevel () ; Récupère le niveau de journalisation actuel pour la bibliothèque Synthetics. Les valeurs possibles sont les suivantes : + `0` : débogage + `1` : informations + `2` : avertissement + `3` : erreur Exemple : ``` let logLevel = synthetics.getLogLevel(); ``` ## ensemble LogLevel () ; Définit le niveau de journalisation pour la bibliothèque Synthetics. Les valeurs possibles sont les suivantes : + `0` : débogage + `1` : informations + `2` : avertissement + `3` : erreur Exemple : ``` synthetics.setLogLevel(0); ``` ## ExecuteStep (StepName, fonction, [StepConfig]) ToExecute Exécute l'étape fournie, en l'encapsulant avec start/pass /fail logging pass/fail et des métriques de durée. La fonction `executeStep` effectue également les opérations suivantes : + Enregistre le début de l'étape + Démarre un chronomètre + Exécute la fonction fournie + Lorsque la fonction revient normalement, elle est considérée comme une transmission. Si la fonction lance, elle est considérée comme un échec + Termine le chronomètre + Elle consigne le fait que l'étape a réussi ou échoué. + Émet la `stepName SuccessPercent` métrique, 100 en cas de réussite ou 0 en cas d'échec + Émet le`stepName Duration metric`, avec une valeur basée sur les heures de début et de fin de l'étape + Renvoie ce que la fonction ToExecute a renvoyé ou renvoie ce qui ` functionToExecute` a été lancé + Ajoute un résumé de l'exécution des étapes au rapport du canari **Exemple** ``` await synthetics.executeStep(stepName, async function () { return new Promise((resolve, reject) => { const req = https.request(url, (res) => { console.log(`Status: ${res.statusCode}`); if (res.statusCode >= 400) { reject(new Error(`Request failed with status ${res.statusCode} for ${url}`)); } else { resolve(); } }); req.on('error', (err) => { reject(new Error(`Request failed for ${url}: ${err.message}`)); }); req.end(); }); }); ``` ## exécuter HttpStep (StepName, RequestOptions, [callback], [StepConfig]) Exécute la requête HTTP fournie en tant qu'étape, puis publie `SuccessPercent` (pass/fail) et `Duration` les métriques. **execute HttpStep** utilise des fonctions natives HTTP ou HTTPS sous le capot, selon le protocole spécifié dans la requête. Cette fonction ajoute également un résumé de l'exécution des étapes au rapport du script Canary. Le résumé inclut des détails sur chaque requête HTTP, tels que les suivants : + L’heure de début + L’heure de fin + État (PASSED/FAILED) + La raison de l'échec, le cas échéant + Détails des appels HTTP tels que request/response les en-têtes, le corps, le code d'état, le message d'état et les délais de performance. **Topics** + [Parameters](#Library_function_Nodejs_executeHttpStep_parameters_Nodecanary) + [Exemples d'utilisation de execute HttpStep](#Library_function_Nodejs_executeHttpStep_examples_Nodecanary) ### Parameters **StepName () {{String}}** Spécifie le nom de l'étape. Ce nom est également utilisé pour publier CloudWatch les statistiques de cette étape. **Options de demande () {{Object or String}}** La valeur de ce paramètre peut être une URL, une chaîne d'URL ou un objet. S'il s'agit d'un objet, il doit s'agir d'un ensemble d'options configurables pour effectuer une requête HTTP. Il prend en charge toutes les options de [http.request (options [, callback])](https://nodejs.org/api/http.html#http_http_request_options_callback) de la documentation. Node.js Outre ces Node.js options, **RequestOptions** prend en charge le paramètre supplémentaire. `body` Vous pouvez utiliser le paramètre `body` pour transmettre des données en tant que corps de requête. **rappel () {{response}}** (Facultatif) Il s'agit d'une fonction utilisateur qui est appelée avec la réponse HTTP. La réponse est du type [Class : http. IncomingMessage](https://nodejs.org/api/http.html#http_class_http_incomingmessage). **Configuration de l'étape () {{object}}** (Facultatif) Utilisez ce paramètre pour remplacer les configurations Synthetics globales par une configuration différente pour cette étape. ### Exemples d'utilisation de execute HttpStep Les exemples suivants s'inspirent les uns des autres pour illustrer les différentes utilisations de cette option. Ce premier exemple configure les paramètres de requête. Vous pouvez transmettre une URL sous la forme **RequestOptions** : ``` let requestOptions = 'https://www.amazon.com'; ``` Vous pouvez également transmettre un ensemble d'options : ``` let requestOptions = { 'hostname': 'myproductsEndpoint.com', 'method': 'GET', 'path': '/test/product/validProductName', 'port': 443, 'protocol': 'https:' }; ``` L'exemple suivant crée une fonction de rappel qui accepte une réponse. Par défaut, si vous ne spécifiez pas de **rappel**, CloudWatch Synthetics vérifie que le statut est compris entre 200 et 299 inclus. ``` // Handle validation for positive scenario const callback = async function(res) { return new Promise((resolve, reject) => { if (res.statusCode < 200 || res.statusCode > 299) { throw res.statusCode + ' ' + res.statusMessage; } let responseBody = ''; res.on('data', (d) => { responseBody += d; }); res.on('end', () => { // Add validation on 'responseBody' here if required. For ex, your status code is 200 but data might be empty resolve(); }); }); }; ``` L'exemple suivant crée une configuration pour cette étape qui remplace la configuration globale de CloudWatch Synthetics. Dans cet exemple, la configuration des étapes autorise les en-têtes de demande, les en-têtes de réponse, le corps de la demande (données de publication) et le corps de réponse dans votre rapport et limite les valeurs des en-têtes X-Amz-Security-Token « » et « Authorization ». Par défaut, ces valeurs ne sont pas incluses dans le rapport pour des raisons de sécurité. Si vous choisissez de les inclure, les données sont stockées uniquement dans votre compartiment S3. ``` // By default headers, post data, and response body are not included in the report for security reasons. // Change the configuration at global level or add as step configuration for individual steps let stepConfig = { includeRequestHeaders: true, includeResponseHeaders: true, restrictedHeaders: ['X-Amz-Security-Token', 'Authorization'], // Restricted header values do not appear in report generated. includeRequestBody: true, includeResponseBody: true }; ``` Ce dernier exemple transmet votre demande d'**exécution HttpStep** et nomme l'étape. ``` await synthetics.executeHttpStep('Verify GET products API', requestOptions, callback, stepConfig); ``` **Avec cet ensemble d'exemples, CloudWatch Synthetics ajoute les détails de chaque étape de votre rapport et produit des métriques pour chaque étape à l'aide de StepName.** Vous verrez les métriques `successPercent` et `duration` pour l'étape `Verify GET products API`. Vous pouvez contrôler les performances de vos API en contrôlant les métriques des étapes d'appel de vos API. Pour obtenir un exemple de script complet qui utilise ces fonctions, consultez [Multi-step API canari](CloudWatch_Synthetics_Canaries_Samples.md#CloudWatch_Synthetics_Canaries_Samples_APIsteps).