Gestionar monitores de API con scripts

New Relic te permite usar NerdGraph para crear monitores API con scripts. Los monitores API con script ejecutan código JavaScript personalizado para probar API y servicios backend sin un navegador, realizando requests HTTP y validando respuestas mediante programación. Este tutorial proporciona ejemplos de cómo emplear la API NerdGraph para automatizar la creación de monitores de API con scripts.

Crear un monitor API con script

Puede crear un monitor de API con script empleando la mutación syntheticsCreateScriptApiMonitor. Esta mutación le permite configurar pruebas API personalizadas que ejecutan su código JavaScript para validar extremos de API.

parámetro de entrada

Parámetro	Tipo de datos	¿Es obligatorio?	Descripción
`accountId`	Entero	Sí	ID de su cuenta de New Relic donde se creará el monitor.
`monitor.locations.public`	Matriz	Sí	matriz de ubicación pública identificador donde el monitor ejecutará comprobaciones (por ejemplo, `["US_EAST_1", "US_WEST_1"]` ).
`monitor.name`	Cadena	Sí	El nombre para mostrar de su monitor de API con script.
`monitor.period`	Enumeración	Sí	Con qué frecuencia se ejecuta el monitor. Opciones: `EVERY_MINUTE` , `EVERY_5_MINUTES` , `EVERY_10_MINUTES` , `EVERY_15_MINUTES` , `EVERY_30_MINUTES` , `EVERY_HOUR` , `EVERY_6_HOURS` , `EVERY_12_HOURS` , `EVERY_DAY` .
`monitor.runtime.runtimeType`	Cadena	Sí	El tipo de tiempo de ejecución empleado por su monitor. `NODE_API` es el único valor aceptado.
`monitor.runtime.runtimeTypeVersion`	Cadena	Sí	La versión del tipo de runtime utilizada por su monitor. Use `22.20.0` para la versión actual de Node.js (recomendado). Las versiones específicas más antiguas como `16.10` también se aceptan, pero quedarán obsoletas.
`monitor.runtime.scriptLanguage`	Cadena	Sí	El idioma empleado en su monitor. `JAVASCRIPT` es el único valor aceptado.
`monitor.script`	Cadena	Sí	El código JavaScript que ejecuta el monitor. Debe ser texto simple, no codificado en base64. El script puede usar el objeto $http para realizar requests HTTP y realizar pruebas API.
`monitor.status`	Enumeración	Sí	El estado del monitor. Opciones: `ENABLED` (el monitor está activo y realizando comprobaciones), `DISABLED` (el monitor está inactivo).
`monitor.apdexTarget`	Flotante	No	Objetivo Apdex del monitor en segundos, empleado para completar reportes SLA. El valor predeterminado es 7,0 segundos.

Solicitud de muestra

mutation {
  syntheticsCreateScriptApiMonitor(
    accountId: ACCOUNT_ID
    monitor: {
      locations: { public: ["LOCATION_1", "LOCATION_2"] }
      name: "YOUR_MONITOR_NAME"
      period: PERIOD
      runtime: {
        runtimeType: "RUNTIME_TYPE"
        runtimeTypeVersion: "RUNTIME_TYPE_VERSION"
        scriptLanguage: "SCRIPT_LANGUAGE"
      }
      script: "SCRIPT_CONTENT"
      status: STATUS
      apdexTarget: APDEX_TARGET
    }
  ) {
    errors {
      description
      type
    }
  }
}

Ejemplo de respuesta

Una respuesta exitosa devuelve null para los errores:

{
  "data": {
    "syntheticsCreateScriptApiMonitor": {
      "errors": null
    }
  }
}

Si hay algún problema al crear el monitor, la matriz errors contendrá objetos con campos description y type que explican qué salió mal.

Actualizar un monitor de API con script

Puede actualizar un monitor de API con script existente empleando la mutación syntheticsUpdateScriptApiMonitor. Esto le permite modificar la configuración de un monitor de API con script que ya se creó.

parámetro de entrada

Parámetro	Tipo de datos	¿Es obligatorio?	Descripción
`guid`	Cadena	Sí	El GUID de entidad única del monitor que desea actualizar.
`monitor.locations.public`	Matriz	No	matriz de ubicación pública identificador donde el monitor ejecutará comprobaciones (por ejemplo, `["US_EAST_1", "US_WEST_1"]` ).
`monitor.name`	Cadena	No	El nombre para mostrar actualizado para su monitor de API con script.
`monitor.period`	Enumeración	No	Con qué frecuencia se ejecuta el monitor. Opciones: `EVERY_MINUTE` , `EVERY_5_MINUTES` , `EVERY_10_MINUTES` , `EVERY_15_MINUTES` , `EVERY_30_MINUTES` , `EVERY_HOUR` , `EVERY_6_HOURS` , `EVERY_12_HOURS` , `EVERY_DAY` .
`monitor.runtime.runtimeType`	Cadena	No	El tipo de tiempo de ejecución empleado por su monitor. `NODE_API` es el único valor aceptado.
`monitor.runtime.runtimeTypeVersion`	Cadena	No	La versión del tipo de runtime utilizada por su monitor. Use `22.20.0` para la versión actual de Node.js (recomendado). Las versiones específicas más antiguas como `16.10` también se aceptan, pero quedarán obsoletas.
`monitor.runtime.scriptLanguage`	Cadena	No	El idioma empleado en su monitor. `JAVASCRIPT` es el único valor aceptado.
`monitor.script`	Cadena	No	El código JavaScript que ejecuta el monitor. Debe ser texto simple, no codificado en base64.
`monitor.status`	Enumeración	No	El estado del monitor. Opciones: `ENABLED` (el monitor está activo y realizando comprobaciones), `DISABLED` (el monitor está inactivo).
`monitor.apdexTarget`	Flotante	No	Objetivo Apdex del monitor en segundos, empleado para completar reportes SLA. El valor predeterminado es 7,0 segundos.

Solicitud de muestra

mutation {
  syntheticsUpdateScriptApiMonitor(
    guid: ENTITY_GUID
    monitor: {
      locations: { public: ["LOCATION_1", "LOCATION_2"] }
      name: "YOUR_MONITOR_NAME"
      period: PERIOD
      runtime: {
        runtimeType: "RUNTIME_TYPE"
        runtimeTypeVersion: "RUNTIME_TYPE_VERSION"
        scriptLanguage: "SCRIPT_LANGUAGE"
      }
      script: "SCRIPT_CONTENT"
      status: STATUS
      apdexTarget: APDEX_TARGET
    }
  ) {
    errors {
      description
      type
    }
  }
}

Ejemplo de respuesta

Una respuesta exitosa devuelve null para los errores:

{
  "data": {
    "syntheticsUpdateScriptApiMonitor": {
      "errors": null
    }
  }
}

Si hay algún problema al actualizar el monitor, la matriz errors contendrá objetos con campos description y type que explican qué salió mal.

Actualizar el tiempo de ejecución de un monitor de API con script

Puede actualizar un monitor API con script para emplear el entorno de ejecución de Node.js más reciente. Recomendamos usar la versión 22.20.0 para el lanzamiento más reciente de Node.js.

Importante

Gestión de versiones de Node.js: versiones específicas de Node.js (como la 16.10) llegarán al fin de su vida útil. El 18 de noviembre de 2026, los monitores de API con scripts que aún usen versiones anteriores de Node.js se actualizarán forzosamente a Node.js 22. La versión actual admitida es 22.20.0. Para garantizar que sus monitores utilicen las últimas actualizaciones y características de Node.js, actualice a runtimeTypeVersion: "22.20.0" antes de esta fecha.

parámetro de entrada

Parámetro	Tipo de datos	¿Es obligatorio?	Descripción
`guid`	Cadena	Sí	El GUID de entidad única del monitor que desea actualizar.
`monitor.runtime.runtimeType`	Cadena	Sí	El tipo de tiempo de ejecución. `NODE_API` es el único valor aceptado.
`monitor.runtime.runtimeTypeVersion`	Cadena	Sí	La versión del runtime. Use `22.20.0` para la versión más reciente de Node.js (recomendado). Las versiones específicas anteriores como `16.10` también se aceptan, pero quedarán obsoletas.
`monitor.runtime.scriptLanguage`	Cadena	Sí	El lenguaje de script. `JAVASCRIPT` es el único valor aceptado.

Solicitud de muestra

Actualizar a la versión 22.20.0 de Node.js (recomendado):

mutation {
  syntheticsUpdateScriptApiMonitor(
    guid: "ENTITY_GUID"
    monitor: {
      runtime: {
        runtimeType: "NODE_API"
        runtimeTypeVersion: "22.20.0"
        scriptLanguage: "JAVASCRIPT"
      }
    }
  ) {
    errors {
      description
      type
    }
  }
}

Ejemplo de respuesta

Una respuesta exitosa devuelve null para los errores:

{
  "data": {
    "syntheticsUpdateScriptApiMonitor": {
      "errors": null
    }
  }
}

Si hay algún problema al actualizar el entorno de ejecución del monitor, la matriz errors contendrá objetos con campos description y type que explican qué salió mal.

Mover un monitor API con script entre una ubicación privada habilitada para VSE

Puede mover un monitor API con script entre una ubicación privada habilitada para VSE. Al mover monitores entre ubicaciones privadas con la ejecución script verificados (VSE) habilitada, debe incluir el script para regenerar HMAC para la validación de seguridad.

parámetro de entrada

Parámetro	Tipo de datos	¿Es obligatorio?	Descripción
`guid`	Cadena	Sí	El GUID de entidad única del monitor que desea mover.
`monitor.locations.private`	Matriz	Sí	matriz de configuración de ubicación privada. Cada ubicación requiere un `guid` y `vsePassword` para las ubicaciones habilitadas para VSE.
`monitor.locations.private.guid`	Cadena	Sí	El GUID de entidad de la ubicación privada de destino.
`monitor.locations.private.vsePassword`	Cadena	Sí	La contraseña de VSE para la ubicación privada del objetivo.
`monitor.script`	Cadena	Sí	El código JavaScript que ejecuta el monitor. Esto debe incluir para regenerar HMAC al mover entre ubicaciones habilitadas para VSE.

Solicitud de muestra

mutation {
  syntheticsUpdateScriptApiMonitor(
    guid: "ENTITY_GUID"
    monitor: {
      locations: {
        private: [{ guid: "LOCATION_GUID", vsePassword: "YOUR_VSE_PASSWORD" }]
      }
      script: "SCRIPT_CONTENT"
    }
  ) {
    errors {
      description
      type
    }
    monitor {
      status
    }
  }
}

Ejemplo de respuesta

Una respuesta exitosa devuelve null en caso de errores e incluye el estado del monitor:

{
  "data": {
    "syntheticsUpdateScriptApiMonitor": {
      "errors": null,
      "monitor": {
        "status": "ENABLED"
      }
    }
  }
}

Si hay algún problema al mover el monitor, la matriz errors contendrá objetos con campos description y type que explican qué salió mal.

Eliminar un monitor de API con script

Cuando ya no se necesita un monitor de API con script, puedes eliminarlo de forma permanente empleando la mutación syntheticsDeleteMonitor.

Para eliminar un monitor, consulte la sección Eliminar monitor Sintético.

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

Crear un monitor API con script .css-21sua1{background:none;border:none;width:0;padding:0;}

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Actualizar un monitor de API con script

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Actualizar el tiempo de ejecución de un monitor de API con script

Importante

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Mover un monitor API con script entre una ubicación privada habilitada para VSE

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Eliminar un monitor de API con script

Crear un monitor API con script