• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Écrire des tests d'API synthétiques (environnement d'exécution legacy - Node.js 10 et versions antérieures)

Important

À compter du 26 août 2024, vous ne pouvez plus créer de nouveaux moniteurs à l'aide legacy runtimes sur des sites publics ou privés. Le 22 octobre 2024, nous mettrons fin à la vie des versions conteneurisées subordonnées privées (appels par minute) et legacy versions synthétiques du runtime.

Utilisez monitoring les tests API de Synthétique pour monitorer vos points de terminaison d'API afin de vous assurer qu'ils fonctionnent correctement. New Relic utilise le module http-request en interne pour effectuer des appels HTTP vers votre point de terminaison et valider les résultats.

Veuillez vous référer aux [exemples d'exécution d'API Node 16.10 ou plus récents](Détails pour le script d'écriture d'exécution Node 16.10 pour créer un moniteur à l'aide de notre dernier runtime synthétique.

Nous présentons ici quelques exemples de fonctions montrant comment utiliser l'objet $http pour soumettre votre requête. Pour une documentation détaillée sur les options disponibles pour cet objet, consultez le fichier http-request readme. (Notez que Request est obsolète, mais ces options s'appliquent toujours.)

Conseil

Pour afficher et partager d'autres exemples de tests API, visitez la section Script Synthetics du forum d'assistance ou la bibliothèque de démarrages rapides monitoring Synthétique.

Utiliser le module API http-request

Les tests API sont alimentés par le module http-request , qui est disponible via l'objet $http . Une fois chaque intervalle de fréquence, New Relic interroge votre point de terminaison à partir de chacun de vos emplacements sélectionnés. Pour obtenir des instructions sur la création d'un moniteur, consultez Ajout d'un moniteur.

Lisez la suite pour savoir comment définir les métadonnées de votre requête, effectuer une requête GET, effectuer une requête POST et comment valider les résultats.

Important

Après un temps d'exécution maximum de trois minutes, New Relic arrête manuellement le script.

api-test-snap.png

one.newrelic.com > Synthetic monitoring > Create monitor:L'éditeur script suggère des fonctions, des sélecteurs et d'autres éléments pour simplifier les commandes de script (disponibles sur GitHub).

Configurer les options de demande

Pour démarrer votre script :

  • Déclarez une variable (telle que options) pour stocker votre objet d'options de demande.
  • Définissez les options de demande telles que le point de terminaison de l'URL et les en-têtes personnalisés.
  • Si vous définissez des options SSL ou d'agent, consultez les exigences SSL et agentOptions. Nous vous recommandons d'utiliser SSL pour éviter d'exposer des informations d'identification en texte brut dans vos en-têtes.

Conseil

Pour une liste complète des options de demande prises en charge, consultez request(options, rappel) dans la documentation http-request sur GitHub.

Voici un exemple de métadonnées facultatives dans l'objet options :

For SSL and agentOptions: Si vous définissez des options SSL ou fournissez un objet agentOptions , la propriété agent dans l'objet de requête options devra être définie sur $globalAgents.https ou $globalAgents.http pour garantir que vos requests HTTP utilisent l'agent global instrumenté.

Voici un exemple d'utilisation d'une option SSL ou agentOptions:

Envoyer une requête GET

Pour effectuer une requête GET, utilisez la méthode $http.get pour soumettre votre requête. Définissez vos options de demande, effectuez votre demande en utilisant $http.get, puis validez la réponse pour vous assurer que votre point de terminaison renvoie les résultats corrects.

Envoyer une requête POST

Pour faire une requête POST, utilisez la méthode $http.post pour soumettre votre requête. Définissez vos options de demande, effectuez votre demande en utilisant $http.post, puis validez la réponse pour vous assurer que votre point de terminaison renvoie les résultats corrects.

Valider les résultats

Pour valider vos résultats, importez le module assert pour définir votre cas de test. Appelez une méthode assert pour valider la réponse de votre point de terminaison. Si l'une des assert fonctions échoue, l'ensemble du contrôle sera considéré comme ayant échoué. Cela peut déclencher une notification d'alerte et affecter vos métriques.

Important

monitoring synthétique ne permet pas de lever d'exceptions. Les exceptions levées entraînent l’échec du script. Utilisez le module assert pour valider vos résultats et utilisez console.log() pour log les résultats dans la console de Synthétique.

Droits d'auteur © 2025 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.