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í	Browser(es) que empleará el monitor para ejecutar trabajos. Navegadores compatibles: `CHROME` , `EDGE` , `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 tiempo de ejecución empleada por su monitor. `100` es el único valor aceptado.
`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	Browser(es) que empleará el monitor para ejecutar trabajos. Navegadores compatibles: `CHROME` , `EDGE` , `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 tiempo de ejecución empleada por su monitor. `100` es el único valor aceptado.
`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 nuevo entorno de ejecución Chrome 100+. Esto garantiza que su monitor emplee las últimas funciones del navegador y actualizaciones 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 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 de tiempo de ejecución. `100` es el único valor aceptado.
`monitor.runtime.scriptLanguage`	Cadena	Sí	El lenguaje de script. `JAVASCRIPT` es el único valor aceptado.

Solicitud de muestra

mutation {
  syntheticsUpdateSimpleBrowserMonitor(
    guid: "ENTITY_GUID"
    monitor: {
      runtime: {
        runtimeType: "CHROME_BROWSER"
        runtimeTypeVersion: "100"
        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.

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

Puedes degradar un monitor de navegador simple para emplear un entorno de ejecución legacy. Esto puede ser necesario por razones de compatibilidad, pero tenga en cuenta que los entornos de ejecución legacy finalizarán su vida útil el 22 de octubre de 2024.

Importante

Los tiempos de ejecución heredados están obsoletos y finalizarán su vida útil el 22 de octubre de 2024. No se recomienda cambiar a entornos de ejecución legacy, excepto por necesidades de compatibilidad temporales.

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 degradar.
`monitor.runtime.runtimeType`	Cadena	Sí	Establezca la cadena vacía `""` para emplear el tiempo de ejecución legacy.
`monitor.runtime.runtimeTypeVersion`	Cadena	Sí	Establezca la cadena vacía `""` para emplear el tiempo de ejecución legacy.
`monitor.runtime.scriptLanguage`	Cadena	Sí	Establezca la cadena vacía `""` para emplear el tiempo de ejecución legacy.

Solicitud de muestra

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

Ejemplo de respuesta

Una respuesta exitosa devuelve null para los errores:

{
  "data": {
    "syntheticsUpdateSimpleBrowserMonitor": {
      "errors": null
    }
  }
}

Si hay algún problema al degradar el tiempo 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

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Reducir 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