• /
  • EnglishEspañolFrançais日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Acciones de New Relic Synthetics

|View as Markdown (English)

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 monitorGuid y acepta un objeto config opcional con sobrescrituras por monitor. Consulte los campos a continuación.

[{"monitorGuid": "MTE5Mz..."}]

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.

"MTE5MzMzNDd8U1lOVEh8..."

tests[].config.isBlocking

Booleano

Opcional. Si true, una prueba fallida se trata como bloqueante —útil para controlar un pipeline de CI/CD según el resultado.

true

tests[].config.overrides.location

Cadena

Opcional. Ejecute la prueba desde esta ubicación en lugar de las ubicaciones configuradas del monitor.

"US_EAST_1"

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.

"https://staging.example.com"

tests[].config.overrides.domain

Lista

Opcional. Redirige las requests de un dominio a otro solo para esta ejecución. Cada entrada requiere domain y override.

[{"domain": "example.com", "override": "staging.example.com"}]

tests[].config.overrides.secureCredential

Lista

Opcional. Intercambie a qué credencial segura almacenada se resuelve la referencia $secure.KEY de un script para esta ejecución. Cada entrada requiere key y overrideKey.

[{"key": "API_KEY", "overrideKey": "STAGING_API_KEY"}]

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: batchName, branch, commit, deepLink, platform, repository.

{"batchName": "release-1.2.3", "branch": "main", "commit": "a1b2c3d"}

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "batchId", "expression": ".data.syntheticsStartAutomatedTest.batchId"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Ejemplo

success

Booleano

true cuando el paso se ejecutó sin errores.

errorMessage

Cadena

Se completa solo si la llamada falla a nivel de HTTP/transporte. null en caso de éxito.

data

Objeto

{
"data": {
"syntheticsStartAutomatedTest": {
"batchId": "bdf77c8d-1987-4488-ac7d-112836e5f610"
}
}
}

Pase el batchId a newrelic.synthetics.getAutomatedTestResult para consultar el resultado.

Ejemplo de flujo de trabajo

name: start_synthetics_automated_test
description: Trigger an on-demand Synthetics test run after a deploy
steps:
- name: startAutomatedTest
type: action
action: newrelic.synthetics.startAutomatedTest
version: 1
inputs:
tests:
- monitorGuid: "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnw1OGEwNmFjZC02MGRmLTQ4YWEtYTc4YS1jZDk5NjhmYTU4YmE"
config:
batchName: "release-1.2.3"
branch: "main"
selectors:
- name: batchId
expression: ".data.syntheticsStartAutomatedTest.batchId"
next: end

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.

11933347

batchId

Cadena

Requerido. El ID de lote devuelto por newrelic.synthetics.startAutomatedTest.

"bdf77c8d-1987-4488-ac7d-112836e5f610"

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "status", "expression": ".data.actor.account.synthetics.automatedTestResult.status"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Ejemplo

success

Booleano

true cuando el paso se ejecutó sin errores.

errorMessage

Cadena

Se completa solo si la llamada falla a nivel de HTTP/transporte. null en caso de éxito.

data

Objeto

{
"data": {
"actor": {
"account": {
"synthetics": {
"automatedTestResult": {
"status": "IN_PROGRESS",
"startTimestamp": 1788519679406,
"finishTimestamp": null,
"tests": []
}
}
}
}
}
}

status es uno de PASSED, FAILED, IN_PROGRESS o TIMEOUT.

Ejemplo de flujo de trabajo

name: get_synthetics_test_result
description: Poll a Synthetics automated test batch for its outcome
steps:
- name: wait
type: wait
seconds: 15
- name: getAutomatedTestResult
type: action
action: newrelic.synthetics.getAutomatedTestResult
version: 1
inputs:
accountId: 11933347
batchId: "bdf77c8d-1987-4488-ac7d-112836e5f610"
selectors:
- name: status
expression: ".data.actor.account.synthetics.automatedTestResult.status"
- name: tests
expression: ".data.actor.account.synthetics.automatedTestResult.tests"
next: end

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.

11933347

nombre

Cadena

Requerido. Nombre para mostrar del tiempo de inactividad.

"Deploy maintenance window"

startTime

Cadena

Requerido. Hora de inicio como NaiveDateTime (sin desplazamiento de zona horaria), interpretada usando la entrada timezone. Formato: YYYY-MM-DDTHH:MM:SS.

"2026-09-10T02:00:00"

endTime

Cadena

Requerido. Hora de finalización como NaiveDateTime (sin desplazamiento de zona horaria), interpretada usando la entrada timezone.

"2026-09-10T04:00:00"

zona horaria

Cadena

Requerido. Nombre de la zona horaria de IANA utilizado para interpretar startTime y endTime.

"America/Los_Angeles"

monitorGuids

Lista

Requerido. GUID de entidad de los monitores que se silenciarán durante el tiempo de inactividad. Debe incluir al menos un GUID.

["MTE5MzMzNDd8U1lOVEh8..."]

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "guid", "expression": ".data.syntheticsCreateOnceMonitorDowntime.guid"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Ejemplo

success

Booleano

true cuando el paso se ejecutó sin errores.

errorMessage

Cadena

Se completa solo si la llamada falla a nivel de HTTP/transporte. null en caso de éxito.

data

Objeto

{
"data": {
"syntheticsCreateOnceMonitorDowntime": {
"accountId": 11933347,
"guid": "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUl9ET1dOVElNRXxhZGZlYmRiOS0...",
"monitorGuids": ["MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnw1OGEwNmFjZC0..."],
"name": "Deploy maintenance window",
"startTime": "2026-09-10T02:00",
"endTime": "2026-09-10T04:00",
"timezone": "Pacific Standard Time"
}
}
}

Ejemplo de flujo de trabajo

name: create_monitor_downtime
description: Schedule a maintenance window for a Synthetics monitor
steps:
- name: createMonitorDowntime
type: action
action: newrelic.synthetics.createMonitorDowntime
version: 1
inputs:
accountId: 11933347
name: "Deploy maintenance window"
startTime: "2026-09-10T02:00:00"
endTime: "2026-09-10T04:00:00"
timezone: "America/Los_Angeles"
monitorGuids:
- "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnw1OGEwNmFjZC02MGRmLTQ4YWEtYTc4YS1jZDk5NjhmYTU4YmE"
selectors:
- name: guid
expression: ".data.syntheticsCreateOnceMonitorDowntime.guid"
next: end

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.

"MTE5MzMzNDd8U1lOVEh8TU9OSVRPUl9ET1dOVElNRXwz..."

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.

["MTE5MzMzNDd8U1lOVEh8..."]

startTime

Cadena

Requerido. Hora de inicio como NaiveDateTime (sin desplazamiento de zona horaria), interpretada mediante la entrada timezone.

"2026-09-10T02:00:00"

endTime

Cadena

Requerido. Hora de finalización como NaiveDateTime (sin desplazamiento de zona horaria), interpretada usando la entrada timezone.

"2026-09-10T06:00:00"

zona horaria

Cadena

Requerido. Nombre de la zona horaria de IANA utilizado para interpretar startTime y endTime.

"America/Los_Angeles"

nombre

Cadena

Opcional. Nuevo nombre para mostrar del tiempo de inactividad. Omita para dejar sin cambios.

"Deploy maintenance window (extended)"

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "guid", "expression": ".data.syntheticsEditMonitorDowntime.guid"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Ejemplo

success

Booleano

true cuando el paso se ejecutó sin errores.

errorMessage

Cadena

Se completa solo si la llamada falla a nivel de HTTP/transporte. null en caso de éxito.

data

Objeto

{
"data": {
"syntheticsEditMonitorDowntime": {
"accountId": 11933347,
"guid": "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUl9ET1dOVElNRXwz...",
"name": "Deploy maintenance window (extended)",
"startTime": "2026-09-10T02:00",
"endTime": "2026-09-10T06:00",
"timezone": "Pacific Standard Time",
"monitorGuids": ["MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnw1OGEwNmFjZC0..."]
}
}
}

Ejemplo de flujo de trabajo

name: edit_monitor_downtime
description: Extend a Synthetics monitor downtime's end time
steps:
- name: editMonitorDowntime
type: action
action: newrelic.synthetics.editMonitorDowntime
version: 1
inputs:
guid: "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUl9ET1dOVElNRXwz..."
name: "Deploy maintenance window (extended)"
monitorGuids:
- "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnw1OGEwNmFjZC02MGRmLTQ4YWEtYTc4YS1jZDk5NjhmYTU4YmE"
startTime: "2026-09-10T02:00:00"
endTime: "2026-09-10T06:00:00"
timezone: "America/Los_Angeles"
selectors:
- name: guid
expression: ".data.syntheticsEditMonitorDowntime.guid"
next: end

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.

"MTE5MzMzNDd8U1lOVEh8TU9OSVRPUl9ET1dOVElNRXxhZGZlYmRiOS0..."

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "deletedGuid", "expression": ".data.syntheticsDeleteMonitorDowntime.guid"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Ejemplo

success

Booleano

true cuando el paso se ejecutó sin errores.

errorMessage

Cadena

Se completa solo si la llamada falla a nivel de HTTP/transporte. null en caso de éxito.

data

Objeto

{
"data": {
"syntheticsDeleteMonitorDowntime": {
"guid": "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUl9ET1dOVElNRXxhZGZlYmRiOS0..."
}
}
}

Ejemplo de flujo de trabajo

name: delete_monitor_downtime
description: Remove a Synthetics monitor downtime
steps:
- name: deleteMonitorDowntime
type: action
action: newrelic.synthetics.deleteMonitorDowntime
version: 1
inputs:
guid: "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUl9ET1dOVElNRXxhZGZlYmRiOS0..."
selectors:
- name: deletedGuid
expression: ".data.syntheticsDeleteMonitorDowntime.guid"
next: end

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.

"MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnwxMDMyODk5YS1kMmU2..."

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "status", "expression": ".data.actor.entity.monitorSummary.status"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Ejemplo

success

Booleano

true cuando el paso se ejecutó sin errores.

errorMessage

Cadena

Se completa solo si la llamada falla a nivel de HTTP/transporte. null en caso de éxito.

data

Objeto

{
"data": {
"actor": {
"entity": {
"guid": "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnwxMDMyODk5YS1kMmU2...",
"name": "Homepage ping check",
"accountId": 123456,
"domain": "SYNTH",
"entityType": "SYNTHETIC_MONITOR_ENTITY",
"type": "MONITOR",
"alertSeverity": "NOT_ALERTING",
"permalink": "https://onenr.io/...",
"reporting": true,
"monitorType": "SIMPLE",
"monitorId": "1032899a-d2e6-4777-8b5f-5d3f7c9b6798",
"period": 5,
"monitoredUrl": "https://example.com",
"monitorSummary": {
"status": "SUCCESS",
"successRate": 1,
"locationsFailing": 0,
"locationsRunning": 1,
"loadTimeP50": 210,
"loadTimeP95": 480
}
}
}
}
}

Ejemplo de flujo de trabajo

name: get_synthetics_monitor
description: Fetch a Synthetics monitor's current status and load time
steps:
- name: getMonitor
type: action
action: newrelic.synthetics.getMonitor
version: 1
inputs:
guid: "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnwxMDMyODk5YS1kMmU2LTQ3NzctOGI1Zi01ZDNmN2M5YjY3OTg"
selectors:
- name: status
expression: ".data.actor.entity.monitorSummary.status"
- name: successRate
expression: ".data.actor.entity.monitorSummary.successRate"
next: end

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.

11933347

nombre

Cadena

Opcional. Coincidencia de tipo “contiene” con el nombre del monitor, sin distinguir mayúsculas de minúsculas.

"Homepage"

informes

Booleano

Opcional. Filtrar por monitores que están (true) o no están (false) reportando actualmente. Omitir para devolver ambos.

true

cursor

Cadena

Opcional. Cursor de paginación de la salida de nextCursor de una llamada anterior. Omítalo para comenzar desde la primera página.

"${{ .steps.listMonitors.outputs.nextCursor }}"

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "monitors", "expression": ".data.actor.entitySearch.results.entities"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Ejemplo

success

Booleano

true cuando el paso se ejecutó sin errores.

errorMessage

Cadena

Se completa solo si la llamada falla a nivel de HTTP/transporte. null en caso de éxito.

data

Objeto

{
"data": {
"actor": {
"entitySearch": {
"count": 1,
"results": {
"nextCursor": null,
"entities": [
{
"guid": "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnw1OGEwNmFjZC0...",
"name": "Homepage ping check",
"domain": "SYNTH",
"type": "MONITOR",
"reporting": true
}
]
}
}
}
}
}

nextCursor está presente cuando existen más páginas. Páselo como cursor en la siguiente llamada para recuperar la página siguiente.

Ejemplo de flujo de trabajo

name: list_synthetics_monitors
description: Search for Synthetics monitors by name
steps:
- name: listMonitors
type: action
action: newrelic.synthetics.listMonitors
version: 1
inputs:
accountId: 11933347
name: "Homepage"
reporting: true
selectors:
- name: monitors
expression: ".data.actor.entitySearch.results.entities"
- name: nextCursor
expression: ".data.actor.entitySearch.results.nextCursor"
next: end
Copyright © 2026 New Relic Inc.

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