Gestionar monitores de navegador simples

New Relic te permite usar NerdGraph para crear monitores de navegador simples. Los monitores de navegador simples realizan comprobaciones automatizadas basadas en el navegador de su aplicación sitio web, simulando la interacción real del usuario al cargar páginas en un entorno de navegador completo. Este tutorial proporciona ejemplos de cómo emplear la API NerdGraph para automatizar la creación de monitores de navegador simples.

Crea un monitor browser simple

Puede crear un monitor de navegador simple empleando la mutación syntheticsCreateSimpleBrowserMonitor.

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.browsers`	Matriz	Sí	Navegador(es) que el monitor usará para ejecutar trabajos. Navegadores compatibles: `CHROME` , `FIREFOX` .
`monitor.devices`	Matriz	Sí	Dispositivos que empleará el monitor para ejecutar trabajos. Dispositivos compatibles: `DESKTOP` , `MOBILE_LANDSCAPE` , `MOBILE_PORTRAIT` , `TABLET_LANDSCAPE` , `TABLET_PORTRAIT` .
`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 el monitor de su navegador simple.
`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. `CHROME_BROWSER` es el único valor aceptado.
`monitor.runtime.runtimeTypeVersion`	Cadena	Sí	La versión del tipo de runtime utilizada por su monitor. Use `LATEST` para usar automáticamente la versión más reciente de Chrome (recomendado). Las versiones específicas más antiguas como `134` o `140` 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.status`	Enumeración	Sí	El estado del monitor. Opciones: `ENABLED` (el monitor está activo y realizando comprobaciones), `DISABLED` (el monitor está inactivo).
`monitor.uri`	Cadena	Sí	La URL a monitorizar (por ejemplo, `https://example.com` ).
`monitor.advancedOptions.customHeaders`	Objeto	No	Encabezados HTTP personalizados para incluir en la solicitud. Cada encabezado tiene una propiedad `name` y `value` .
`monitor.advancedOptions.enableScreenshotOnFailureAndScript`	Booleano	No	Captura una captura de pantalla durante la ejecución del trabajo cuando ocurre una falla o se ejecuta un script.
`monitor.advancedOptions.responseValidationText`	Cadena	No	Texto que debe aparecer en la respuesta para que se apruebe la verificación. Si se especifica, el monitor fallará si este texto no se encuentra en el cuerpo de la respuesta.
`monitor.advancedOptions.useTlsValidation`	Booleano	No	Si se debe validar el TLS/certificado SSL. Establezca en `true` para verificar la validez de la cadena del certificado SSL.
`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 {
  syntheticsCreateSimpleBrowserMonitor(
    accountId: ACCOUNT_ID
    monitor: {
      browsers: [BROWSERS]
      devices: [DEVICES]
      locations: { public: ["LOCATION_1", "LOCATION_2"] }
      name: "YOUR_MONITOR_NAME"
      period: PERIOD
      runtime: {
        runtimeType: "RUNTIME_TYPE"
        runtimeTypeVersion: "RUNTIME_TYPE_VERSION"
        scriptLanguage: "SCRIPT_LANGUAGE"
      }
      status: STATUS
      uri: "MONITORED_URI"
      advancedOptions: {
        customHeaders: { name: "HEADER_NAME", value: "HEADER_VALUE" }
        enableScreenshotOnFailureAndScript: ENABLE_SCREENSHOT
        responseValidationText: "VALIDATION_TEXT"
        useTlsValidation: TLS_VALIDATION
      }
      apdexTarget: APDEX_TARGET
    }
  ) {
    errors {
      description
      type
    }
  }
}

Ejemplo de respuesta

Una respuesta exitosa devuelve null para los errores:

{
  "data": {
    "syntheticsCreateSimpleBrowserMonitor": {
      "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 browser simple

Puede actualizar un monitor de navegador simple existente empleando la mutación syntheticsUpdateSimpleBrowserMonitor. Esto le permite modificar la configuración de un monitor de navegador simple que ya fue creado.

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.browsers`	Matriz	No	Navegador(es) que el monitor usará para ejecutar trabajos. Navegadores compatibles: `CHROME` , `FIREFOX` .
`monitor.devices`	Matriz	No	Dispositivos que empleará el monitor para ejecutar trabajos. Dispositivos compatibles: `DESKTOP` , `MOBILE_LANDSCAPE` , `MOBILE_PORTRAIT` , `TABLET_LANDSCAPE` , `TABLET_PORTRAIT` .
`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 navegador simple.
`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. `CHROME_BROWSER` es el único valor aceptado.
`monitor.runtime.runtimeTypeVersion`	Cadena	No	La versión del tipo de runtime utilizada por su monitor. Use `LATEST` para usar automáticamente la versión más reciente de Chrome (recomendado). Las versiones específicas más antiguas como `134` o `140` 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.status`	Enumeración	No	El estado del monitor. Opciones: `ENABLED` (el monitor está activo y realizando comprobaciones), `DISABLED` (el monitor está inactivo).
`monitor.uri`	Cadena	No	La URL a monitorizar (por ejemplo, `https://example.com` ).
`monitor.advancedOptions.customHeaders`	Objeto	No	Encabezados HTTP personalizados para incluir en la solicitud. Cada encabezado tiene una propiedad `name` y `value` .
`monitor.advancedOptions.enableScreenshotOnFailureAndScript`	Booleano	No	Captura una captura de pantalla durante la ejecución del trabajo cuando ocurre una falla o se ejecuta un script.
`monitor.advancedOptions.responseValidationText`	Cadena	No	Texto que debe aparecer en la respuesta para que se apruebe la verificación. Si se especifica, el monitor fallará si este texto no se encuentra en el cuerpo de la respuesta.
`monitor.advancedOptions.useTlsValidation`	Booleano	No	Si se debe validar el TLS/certificado SSL. Establezca en `true` para verificar la validez de la cadena del certificado SSL.
`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 {
  syntheticsUpdateSimpleBrowserMonitor(
    guid: ENTITY_GUID
    monitor: {
      browsers: [BROWSERS]
      devices: [DEVICES]
      locations: { public: ["LOCATION_1", "LOCATION_2"] }
      name: "YOUR_MONITOR_NAME"
      period: PERIOD
      runtime: {
        runtimeType: "RUNTIME_TYPE"
        runtimeTypeVersion: "RUNTIME_TYPE_VERSION"
        scriptLanguage: "SCRIPT_LANGUAGE"
      }
      status: STATUS
      uri: "MONITORED_URI"
      advancedOptions: {
        customHeaders: { name: "HEADER_NAME", value: "HEADER_VALUE" }
        enableScreenshotOnFailureAndScript: ENABLE_SCREENSHOT
        responseValidationText: "VALIDATION_TEXT"
        useTlsValidation: TLS_VALIDATION
      }
      apdexTarget: APDEX_TARGET
    }
  ) {
    errors {
      description
      type
    }
  }
}

Ejemplo de respuesta

Una respuesta exitosa devuelve null para los errores:

{
  "data": {
    "syntheticsUpdateSimpleBrowserMonitor": {
      "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 navegador simple

Puedes actualizar un monitor de navegador simple para emplear el entorno de ejecución de Chrome más reciente. Recomendamos usar la versión LATEST para asegurarse de que su monitor se mantenga actualizado automáticamente con las versiones más recientes de Chrome.

Importante

Gestión de versiones de Chrome: New Relic está pasando a un modelo de versiones LATEST para los entornos de ejecución de Chrome. Versiones específicas de Chrome (como 134 y 140) llegarán al final de su vida útil y solo LATEST recibirá mantenimiento en el futuro. El 18 de agosto de 2026, los monitores que aún utilicen versiones anteriores de Chrome se actualizarán de manera forzada a la última versión estable (Chrome 147 o superior). Cuando Chrome lance una nueva versión, estará disponible en los monitores de navegador simples como LATEST dentro de una semana. Para garantizar que sus monitores reciban automáticamente las últimas actualizaciones y características de Chrome, actualice a runtimeTypeVersion: "LATEST" 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. `CHROME_BROWSER` es el único valor aceptado.
`monitor.runtime.runtimeTypeVersion`	Cadena	Sí	La versión del entorno de ejecución. Use `LATEST` para usar automáticamente la versión más reciente de Chrome (recomendado). También se aceptan versiones específicas más antiguas como `134` o `140` , pero quedarán obsoletas.
`monitor.runtime.scriptLanguage`	Cadena	Sí	El lenguaje de script. `JAVASCRIPT` es el único valor aceptado.

Solicitud de muestra

Actualice a la ÚLTIMA versión de Chrome (recomendado):

mutation {
  syntheticsUpdateSimpleBrowserMonitor(
    guid: "ENTITY_GUID"
    monitor: {
      runtime: {
        runtimeType: "CHROME_BROWSER"
        runtimeTypeVersion: "LATEST"
        scriptLanguage: "JAVASCRIPT"
      }
    }
  ) {
    errors {
      description
      type
    }
  }
}

Ejemplo de respuesta

Una respuesta exitosa devuelve null para los errores:

{
  "data": {
    "syntheticsUpdateSimpleBrowserMonitor": {
      "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.

Eliminar un monitor de navegador simple

Cuando ya no se necesita un monitor de navegador simple, 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.

Gestionar monitores de navegador simples

Crea un monitor browser simple .css-21sua1{background:none;border:none;width:0;padding:0;}

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Actualizar un monitor browser simple

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Actualizar el tiempo de ejecución de un monitor de navegador simple

Importante

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Eliminar un monitor de navegador simple

Crea un monitor browser simple