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.
- Pour un emplacement public, utilisez l'UI de mise à niveau de l'environnement d'exécution pour mettre à jour votre moniteur avec les environnements d'exécution les plus récents.
- Pour les sites privés, veuillez consulter nos étapes de migration recommandées pour éviter la dégradation du moniteur.
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.

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.