Cette page fournit une référence pour les actions New Relic Synthetics disponibles dans le catalogue des actions d’automatisation des workflows. Ces actions vous permettent de déclencher des exécutions de tests à la demande pour les moniteurs existants, de gérer les temps d’arrêt des fenêtres de maintenance, et de lire les détails des moniteurs directement depuis une définition de workflow.
Prérequis
Avant d’utiliser les actions New Relic Synthetics dans l’automatisation de workflow, assurez-vous de disposer de :
- Un compte New Relic avec les autorisations appropriées pour accéder aux moniteurs Synthetics.
- Le GUID de l’entité de chaque moniteur que vous souhaitez cibler. Vous pouvez trouver le GUID d’un moniteur dans New Relic sous Synthetics > [nom du moniteur] > Settings.
Démarrez un test automatisé
L’identifiant de l’action est newrelic.synthetics.startAutomatedTest.
Déclenche une exécution de test automatisé Synthetics à la demande pour un ou plusieurs moniteurs et renvoie un batchId pour récupérer les résultats à l’aide de newrelic.synthetics.getAutomatedTestResult.
Important
Seuls les types de moniteurs d'API scriptées, navigateur scripté, étape, et navigateur simple sont pris en charge. Les moniteurs SIMPLE (ping) sont rejetés par l’API avec une erreur de type de moniteur incompatible.
Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.
Saisir | Type | Description | Exemple |
|---|---|---|---|
tests | List | Obligatoire. Liste des moniteurs à tester. Chaque entrée requiert un |
|
tests[].monitorGuid | Chaîne | Obligatoire. GUID d’entité du moniteur à exécuter. Doit être un type de moniteur scripté, ou basé sur un navigateur. |
|
tests[].config.isBlocking | Booléen | Facultatif. Si |
|
tests[].config.overrides.location | Chaîne | Facultatif. Exécutez le test depuis cet emplacement au lieu des emplacements configurés du moniteur. |
|
tests[].config.overrides.startingUrl | Chaîne | Facultatif. Remplacez l'URL de départ du moniteur, par exemple, pour faire pointer un moniteur de production vers un environnement de simulation pour cette exécution. |
|
tests[].config.overrides.domain | List | Facultatif. Redirigez les requests d’un domaine vers un autre pour cette exécution uniquement. Chaque entrée nécessite |
|
tests[].config.overrides.secureCredential | List | Facultatif. Échangez l’identifiant sécurisé stocké vers lequel la référence |
|
configuration | Carte | Facultatif. Métadonnées au niveau du lot associées à l’exécution du test. Tous les champs sont descriptifs uniquement et n’affectent pas l’exécution du test. Champs pris en charge : |
|
selectors | List | Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action. |
|
Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.
Sortir | Type | Exemple |
|---|---|---|
| Booléen |
|
| Chaîne | Renseigné uniquement si l’appel échoue au niveau HTTP/transport. |
| Objet | Transmettez le |
Exemple de workflow |
|---|
|
Obtenez le résultat du test automatisé
L’identifiant de l’action est newrelic.synthetics.getAutomatedTestResult.
Récupère le statut et les résultats par moniteur d’un lot de tests automatisés Synthetics par son batchId. L’interrogation immédiatement après startAutomatedTest peut renvoyer une erreur transitoire « No automated test results found » : ajoutez une courte étape d’attente avant l’interrogation.
Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.
Saisir | Type | Description | Exemple |
|---|---|---|---|
accountId | Entier | Obligatoire. ID de compte New Relic. |
|
batchId | Chaîne | Obligatoire. L’ID de lot renvoyé par |
|
selectors | List | Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action. |
|
Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.
Sortir | Type | Exemple |
|---|---|---|
| Booléen |
|
| Chaîne | Renseigné uniquement si l’appel échoue au niveau HTTP/transport. |
| Objet |
|
Exemple de workflow |
|---|
|
Créer un temps d’arrêt de moniteur
L’identifiant de l’action est newrelic.synthetics.createMonitorDowntime.
Planifie un temps d’arrêt (fenêtre de maintenance) unique du moniteur Synthetics pour un ou plusieurs moniteurs spécifiques. L’API renvoie un libellé de fuseau horaire résolu (tel que Pacific Standard Time) plutôt que le nom IANA soumis.
Important
monitorGuids est nullable dans le schéma GraphQL, mais requis en pratique : l’omettre déclenche une erreur de serveur. Il n’existe pas de mode de temps d’arrêt à l’échelle du compte ; les temps d’arrêt ont toujours pour cible des moniteurs spécifiques.
Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.
Saisir | Type | Description | Exemple |
|---|---|---|---|
accountId | Entier | Obligatoire. ID de compte New Relic. |
|
name | Chaîne | Obligatoire. Nom d’affichage pour le temps d’arrêt. |
|
startTime | Chaîne | Obligatoire. Heure de début sous forme de NaiveDateTime (sans décalage de fuseau horaire), interprétée à l’aide de l’entrée |
|
endTime | Chaîne | Obligatoire. Heure de fin en tant que NaiveDateTime (sans décalage de fuseau horaire), interprétée à l’aide de l’entrée |
|
fuseau horaire | Chaîne | Obligatoire. Nom de fuseau horaire IANA utilisé pour interpréter |
|
monitorGuids | List | Obligatoire. GUID d’entité des moniteurs à rendre silencieux pendant le temps d’arrêt. Doit inclure au moins un GUID. |
|
selectors | List | Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action. |
|
Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.
Sortir | Type | Exemple |
|---|---|---|
| Booléen |
|
| Chaîne | Renseigné uniquement si l’appel échoue au niveau HTTP/transport. |
| Objet | |
Exemple de workflow |
|---|
|
Modifier un temps d'arrêt du moniteur
L’identifiant de l’action est newrelic.synthetics.editMonitorDowntime.
Modifie un temps d’arrêt de moniteur Synthetics existant identifié par son GUID d’entité.
Important
monitorGuids est requis à chaque appel de modification. L’API ne conserve pas la liste existante lorsque ce champ est omis ; elle la vide à la place. Transmettez toujours l’ensemble complet souhaité de GUID de moniteur.
Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.
Saisir | Type | Description | Exemple |
|---|---|---|---|
GUID | Chaîne | Obligatoire. GUID d’entité du temps d’arrêt à modifier. |
|
monitorGuids | List | Obligatoire. Ensemble complet de GUID d’entité de moniteur auxquels le temps d’arrêt doit s’appliquer. L’API vide cette liste si elle est omise plutôt que de conserver la valeur existante. |
|
startTime | Chaîne | Obligatoire. Heure de début en tant que NaiveDateTime (sans décalage de fuseau horaire), interprétée à l’aide de l’entrée |
|
endTime | Chaîne | Obligatoire. Heure de fin en tant que NaiveDateTime (sans décalage de fuseau horaire), interprétée à l’aide de l’entrée |
|
fuseau horaire | Chaîne | Obligatoire. Nom de fuseau horaire IANA utilisé pour interpréter |
|
name | Chaîne | Facultatif. Nouveau nom d’affichage pour le temps d’arrêt. Omettez pour laisser inchangé. |
|
selectors | List | Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action. |
|
Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.
Sortir | Type | Exemple |
|---|---|---|
| Booléen |
|
| Chaîne | Renseigné uniquement si l’appel échoue au niveau HTTP/transport. |
| Objet | |
Exemple de workflow |
|---|
|
Supprimer un moniteur temps d'arrêt
L’identifiant de l’action est newrelic.synthetics.deleteMonitorDowntime.
Supprime un temps d’arrêt de moniteur Synthetics identifié par le GUID de son entité.
Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.
Saisir | Type | Description | Exemple |
|---|---|---|---|
GUID | Chaîne | Obligatoire. GUID de l’entité du temps d’arrêt à supprimer. |
|
selectors | List | Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action. |
|
Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.
Sortir | Type | Exemple |
|---|---|---|
| Booléen |
|
| Chaîne | Renseigné uniquement si l’appel échoue au niveau HTTP/transport. |
| Objet | |
Exemple de workflow |
|---|
|
Obtenir un moniteur
L’identifiant de l’action est newrelic.synthetics.getMonitor.
Récupère les détails complets d’un moniteur Synthetics par son GUID d’entité, y compris l’état actuel, les percentiles de temps de chargement, et la configuration du moniteur.
Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.
Saisir | Type | Description | Exemple |
|---|---|---|---|
GUID | Chaîne | Obligatoire. GUID de l'entité du moniteur à récupérer. |
|
selectors | List | Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action. |
|
Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.
Sortir | Type | Exemple |
|---|---|---|
| Booléen |
|
| Chaîne | Renseigné uniquement si l’appel échoue au niveau HTTP/transport. |
| Objet | |
Exemple de workflow |
|---|
|
Listez les moniteurs
L’identifiant de l’action est newrelic.synthetics.listMonitors.
Recherche des moniteurs Synthetics pour un compte avec des filtres optionnels de nom, et de statut de rapport, et une pagination basée sur un curseur.
Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.
Saisir | Type | Description | Exemple |
|---|---|---|---|
accountId | Entier | Obligatoire. ID de compte New Relic dans lequel rechercher les moniteurs. |
|
name | Chaîne | Facultatif. Correspondance de type « contient » insensible à la casse sur le nom du moniteur. |
|
reporting | Booléen | Facultatif. Filtrer les moniteurs qui transmettent ( |
|
curseur | Chaîne | Facultatif. Curseur de pagination provenant de la sortie |
|
selectors | List | Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action. |
|
Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.
Sortir | Type | Exemple |
|---|---|---|
| Booléen |
|
| Chaîne | Renseigné uniquement si l’appel échoue au niveau HTTP/transport. |
| Objet |
|
Exemple de workflow |
|---|
|