New Relic te permite usar NerdGraph para crear monitores de pasos. Los monitores de pasos proporcionan una monitorización basada en navegador, de múltiples pasos y sin código, que le permite configurar flujos de trabajo de usuario complejos sin escribir ningún código. Este tutorial proporciona ejemplos de cómo emplear la API NerdGraph para automatizar la creación de monitores de pasos.
Crear un monitor de pasos
Puede crear un monitor de pasos empleando la mutación syntheticsCreateStepMonitor. Esta mutación le permite configurar un monitoreo de navegador de varios pasos con un serial de acciones predefinidas.
parámetro de entrada
Parámetro | Tipo de datos | ¿Es obligatorio? | Descripción |
|---|---|---|---|
| Entero | Sí | New Relic donde se creará el monitor. |
| Matriz | Sí | Browser(es) que empleará el monitor para ejecutar trabajos. Navegadores compatibles:
,
,
. |
| Matriz | Sí | Dispositivos que empleará el monitor para ejecutar trabajos. Dispositivos compatibles:
,
,
,
,
. |
| Matriz | Sí | matriz de identificador donde el monitor ejecutará comprobaciones (por ejemplo,
). |
| Cadena | Sí | El nombre para mostrar su monitor de pasos. |
| Enumeración | Sí | Con qué frecuencia se ejecuta el monitor. Opciones:
,
,
,
,
,
,
,
,
. |
| Cadena | Sí | El tipo de tiempo de ejecución empleado por su monitor.
es el único valor aceptado. |
| Cadena | Sí | La versión del tipo de tiempo de ejecución empleada por su monitor.
es el único valor aceptado. |
| Cadena | Sí | El idioma empleado en su monitor.
es el único valor aceptado. |
| Enumeración | Sí | El estado del monitor. Opciones:
(el monitor está activo y realizando comprobaciones),
(el monitor está inactivo). |
| Matriz | Sí | El serial de pasos que ejecutará el monitor. Cada objeto de paso contiene:
(posición del paso, 0-99),
(tipo de paso como
,
,
,
,
, etc.) y
(matriz de valores específicos del tipo de paso). |
| Booleano | No | Captura una captura de pantalla durante la ejecución del trabajo cuando ocurre una falla o se ejecuta un script. |
| Flotante | No | Objetivo Apdex del monitor en segundos, empleado para completar reportes SLA. El valor predeterminado es 7,0 segundos. |
Solicitud de muestra
mutation { syntheticsCreateStepMonitor( accountId: ACCOUNT_ID monitor: { browsers: [BROWSERS] devices: [DEVICES] locations: { public: ["LOCATION_1", "LOCATION_2"] } name: "MONITOR_NAME" period: PERIOD runtime: { runtimeType: "RUNTIME_TYPE" runtimeTypeVersion: "RUNTIME_TYPE_VERSION" scriptLanguage: "SCRIPT_LANGUAGE" } status: STATUS steps: [ { ordinal: 0, type: NAVIGATE, values: ["MONITORED_URI", "USER_AGENT"] } { ordinal: STEP_NUMBER type: STEP_TYPE values: ["CONDITIONAL_TYPE", "VALUE"] } ] advancedOptions: { enableScreenshotOnFailureAndScript: ENABLE_SCREENSHOT } apdexTarget: APDEX_TARGET } ) { errors { description type } }}Ejemplo de respuesta
Una respuesta exitosa devuelve null para los errores:
{ "data": { "syntheticsCreateStepMonitor": { "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 pasos
Puede actualizar un monitor de pasos existente empleando la mutación syntheticsUpdateStepMonitor. Esto le permite modificar la configuración de un monitor de pasos que ya fue creado.
parámetro de entrada
Parámetro | Tipo de datos | ¿Es obligatorio? | Descripción |
|---|---|---|---|
| Cadena | Sí | El de entidad única del monitor que desea actualizar. |
| Matriz | No | Browser(es) que empleará el monitor para ejecutar trabajos. Navegadores compatibles:
,
,
. |
| Matriz | No | Dispositivos que empleará el monitor para ejecutar trabajos. Dispositivos compatibles:
,
,
,
,
. |
| Matriz | No | matriz de identificador donde el monitor ejecutará comprobaciones (por ejemplo,
). |
| Cadena | No | El nombre para mostrar actualizado para su monitor de pasos. |
| Enumeración | No | Con qué frecuencia se ejecuta el monitor. Opciones:
,
,
,
,
,
,
,
,
. |
| Cadena | No | El tipo de tiempo de ejecución empleado por su monitor.
es el único valor aceptado. |
| Cadena | No | La versión del tipo de tiempo de ejecución empleada por su monitor.
es el único valor aceptado. |
| Cadena | No | El idioma empleado en su monitor.
es el único valor aceptado. |
| Enumeración | No | El estado del monitor. Opciones:
(el monitor está activo y realizando comprobaciones),
(el monitor está inactivo). |
| Matriz | No | El serial de pasos que ejecutará el monitor. Cada objeto de paso contiene:
(posición del paso, 0-99),
(tipo de paso como
,
,
,
,
, etc.) y
(matriz de valores específicos del tipo de paso). |
| Booleano | No | Captura una captura de pantalla durante la ejecución del trabajo cuando ocurre una falla o se ejecuta un script. |
| Flotante | No | Objetivo Apdex del monitor en segundos, empleado para completar reportes SLA. El valor predeterminado es 7,0 segundos. |
Solicitud de muestra
mutation { syntheticsUpdateStepMonitor( guid: ENTITY_GUID monitor: { browsers: [BROWSERS] devices: [DEVICES] locations: { public: ["LOCATION_1", "LOCATION_2"] } name: "MONITOR_NAME" period: PERIOD runtime: { runtimeType: "RUNTIME_TYPE" runtimeTypeVersion: "RUNTIME_TYPE_VERSION" scriptLanguage: "SCRIPT_LANGUAGE" } status: STATUS steps: [ { ordinal: 0, type: NAVIGATE, values: ["MONITORED_URI", "USER_AGENT"] } { ordinal: STEP_NUMBER type: STEP_TYPE values: ["VALUE_1", "VALUE_2"] } ] advancedOptions: { enableScreenshotOnFailureAndScript: ENABLE_SCREENSHOT } apdexTarget: APDEX_TARGET } ) { errors { description type } }}Ejemplo de respuesta
Una respuesta exitosa devuelve null para los errores:
{ "data": { "syntheticsUpdateStepMonitor": { "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.
Eliminar un monitor de pasos
Cuando ya no se necesita un monitor de pasos, puedes eliminarlo de forma permanente empleando la mutación syntheticsDeleteMonitor.
Para eliminar un monitor, consulte la sección Eliminar monitor Sintético.