Esta página proporciona una referencia de las acciones de New Relic Synthetics disponibles en el catálogo de acciones de automatización del flujo de trabajo. Estas acciones le permiten activar ejecuciones de prueba a pedido para monitores existentes, gestionar los tiempos de inactividad de las ventanas de mantenimiento y leer los detalles del monitor directamente desde una definición de flujo de trabajo.
Requisitos previos
Antes de usar las acciones de New Relic Synthetics en la automatización del flujo de trabajo, asegúrese de tener:
- Una cuenta de New Relic con los permisos apropiados para acceder a los monitores de Sintéticos.
- El GUID de entidad de cada monitor que desee establecer como objetivo. Puede encontrar el GUID de un monitor en New Relic en Synthetics > [nombre del monitor] > Settings.
Iniciar una prueba automatizada
El identificador de la acción es newrelic.synthetics.startAutomatedTest.
Activa una ejecución de prueba automatizada de Sintéticos a pedido para uno o más monitores y devuelve un batchId para consultar los resultados mediante newrelic.synthetics.getAutomatedTestResult.
Importante
Solo se admiten los tipos de monitor de API con script, navegador con script, paso y navegador simple. Los monitores SIMPLE (ping) son rechazados por la API con un error de tipo de monitor incompatible.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
pruebas | Lista | Requerido. Lista de monitores para probar. Cada entrada requiere un |
|
tests[].monitorGuid | Cadena | Requerido. GUID de entidad del monitor que se va a ejecutar. Debe ser un tipo de monitor con script o basado en navegador. |
|
tests[].config.isBlocking | Booleano | Opcional. Si |
|
tests[].config.overrides.location | Cadena | Opcional. Ejecute la prueba desde esta ubicación en lugar de las ubicaciones configuradas del monitor. |
|
tests[].config.overrides.startingUrl | Cadena | Opcional. Sobrescribir la URL desde la que se inicia el monitor —por ejemplo, para apuntar un monitor de producción a un entorno de prueba para esta ejecución. |
|
tests[].config.overrides.domain | Lista | Opcional. Redirige las requests de un dominio a otro solo para esta ejecución. Cada entrada requiere |
|
tests[].config.overrides.secureCredential | Lista | Opcional. Intercambie a qué credencial segura almacenada se resuelve la referencia |
|
configuración | Mapa | Opcional. Metadatos a nivel de lote adjuntos a la ejecución de la prueba. Todos los campos son solo descriptivos y no afectan cómo se ejecuta la prueba. Campos admitidos: |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Booleano |
|
| Cadena | Se completa solo si la llamada falla a nivel de HTTP/transporte. |
| Objeto | Pase el |
Ejemplo de flujo de trabajo |
|---|
|
Obtener el resultado de la prueba automatizada
El identificador de la acción es newrelic.synthetics.getAutomatedTestResult.
Obtiene el estado y los resultados por monitor de un lote de pruebas automatizadas de Sintéticos mediante su batchId. Sondear inmediatamente después de startAutomatedTest puede devolver un error transitorio de “No automated test results found” —agregue un breve paso de espera antes de sondear.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
ID de la cuenta | Entero | Requerido. ID de cuenta de New Relic. |
|
batchId | Cadena | Requerido. El ID de lote devuelto por |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Booleano |
|
| Cadena | Se completa solo si la llamada falla a nivel de HTTP/transporte. |
| Objeto |
|
Ejemplo de flujo de trabajo |
|---|
|
Crear un tiempo de inactividad de monitor
El identificador de la acción es newrelic.synthetics.createMonitorDowntime.
Programa un tiempo de inactividad único de un monitor de Sintéticos (ventana de mantenimiento) para uno o más monitores específicos. La API devuelve una etiqueta de zona horaria resuelta (como Pacific Standard Time) en lugar del nombre de IANA enviado.
Importante
monitorGuids admite valores nulos en el esquema de GraphQL, pero es obligatorio en la práctica —omitirlo genera un error del servidor. No existe un modo de tiempo de inactividad para toda la cuenta; el tiempo de inactividad siempre tiene como objetivo monitores específicos.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
ID de la cuenta | Entero | Requerido. ID de cuenta de New Relic. |
|
nombre | Cadena | Requerido. Nombre para mostrar del tiempo de inactividad. |
|
startTime | Cadena | Requerido. Hora de inicio como NaiveDateTime (sin desplazamiento de zona horaria), interpretada usando la entrada |
|
endTime | Cadena | Requerido. Hora de finalización como NaiveDateTime (sin desplazamiento de zona horaria), interpretada usando la entrada |
|
zona horaria | Cadena | Requerido. Nombre de la zona horaria de IANA utilizado para interpretar |
|
monitorGuids | Lista | Requerido. GUID de entidad de los monitores que se silenciarán durante el tiempo de inactividad. Debe incluir al menos un GUID. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Booleano |
|
| Cadena | Se completa solo si la llamada falla a nivel de HTTP/transporte. |
| Objeto | |
Ejemplo de flujo de trabajo |
|---|
|
Editar un tiempo de inactividad del monitor
El identificador de la acción es newrelic.synthetics.editMonitorDowntime.
Edita un tiempo de inactividad de monitor de Sintéticos existente identificado por el GUID de su entidad.
Importante
monitorGuids es obligatorio en cada llamada de edición. La API no conserva la lista existente cuando se omite este campo —en su lugar, la deja vacía. Pase siempre el conjunto completo deseado de GUID de monitores.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
guid | Cadena | Requerido. GUID de la entidad del tiempo de inactividad para editar. |
|
monitorGuids | Lista | Requerido. Conjunto completo de GUID de entidad de monitor a los que se debe aplicar el tiempo de inactividad. La API vacía esta lista si se omite, en lugar de conservar el valor existente. |
|
startTime | Cadena | Requerido. Hora de inicio como NaiveDateTime (sin desplazamiento de zona horaria), interpretada mediante la entrada |
|
endTime | Cadena | Requerido. Hora de finalización como NaiveDateTime (sin desplazamiento de zona horaria), interpretada usando la entrada |
|
zona horaria | Cadena | Requerido. Nombre de la zona horaria de IANA utilizado para interpretar |
|
nombre | Cadena | Opcional. Nuevo nombre para mostrar del tiempo de inactividad. Omita para dejar sin cambios. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Booleano |
|
| Cadena | Se completa solo si la llamada falla a nivel de HTTP/transporte. |
| Objeto | |
Ejemplo de flujo de trabajo |
|---|
|
Eliminar un tiempo de inactividad del monitor
El identificador de la acción es newrelic.synthetics.deleteMonitorDowntime.
Elimina un tiempo de inactividad del monitor de Sintéticos identificado por el GUID de la entidad.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
guid | Cadena | Requerido. GUID de entidad del tiempo de inactividad que se va a eliminar. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Booleano |
|
| Cadena | Se completa solo si la llamada falla a nivel de HTTP/transporte. |
| Objeto | |
Ejemplo de flujo de trabajo |
|---|
|
Obtener un monitor
El identificador de la acción es newrelic.synthetics.getMonitor.
Obtiene los detalles completos de un monitor de Sintéticos mediante el GUID de su entidad, incluido el estado actual, los percentiles de tiempo de carga y la configuración del monitor.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
guid | Cadena | Requerido. GUID de la entidad del monitor que se va a recuperar. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Booleano |
|
| Cadena | Se completa solo si la llamada falla a nivel de HTTP/transporte. |
| Objeto | |
Ejemplo de flujo de trabajo |
|---|
|
Listar monitores
El identificador de la acción es newrelic.synthetics.listMonitors.
Busca monitores Sintéticos para una cuenta con filtros opcionales de nombre y estado de reporte, y paginación basada en cursor.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
ID de la cuenta | Entero | Requerido. ID de cuenta de New Relic donde buscar monitores. |
|
nombre | Cadena | Opcional. Coincidencia de tipo “contiene” con el nombre del monitor, sin distinguir mayúsculas de minúsculas. |
|
informes | Booleano | Opcional. Filtrar por monitores que están ( |
|
cursor | Cadena | Opcional. Cursor de paginación de la salida de |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Booleano |
|
| Cadena | Se completa solo si la llamada falla a nivel de HTTP/transporte. |
| Objeto |
|
Ejemplo de flujo de trabajo |
|---|
|