Tutorial de NerdGraph: Administra tu monitor Sintético

Nuestra API NerdGraph le permite automatizar la creación, actualización o eliminación de sus monitores Sintético, ubicación privada, credenciales seguras y monitor el tiempo de inactividad.

Requisitos

Los requisitos incluyen:

Requisitos generales de NerdGraph
Permisos de usuario relevantes: los mismos permisos de monitoreo sintético que se aplican para usar la UI de Sintético se aplican para usar NerdGraph

Comprender los campos en el explorador NerdGraph

Puede ver las definiciones de campos en el explorador NerdGraph, pero puede ser útil para comprender mejor los campos LOCATION, PERIOD, TAGS y otros.

Para identificar una ubicación privada en su secuencia de comandos, utilice el GUID de entidad de la ubicación privada. Para verificar que un script se ejecuta correctamente, incluya también el atributo vsePassword . Por ejemplo:

locations: {
  private: {
    guid: LOCATION_ENTITY_GUID, 
    vsePassword: YOUR_VSE_PASSWORD
  }
}

ubicación pública utilice el identificador de ubicación sin el prefijo AWS , por ejemplo:

locations: {
  public: ["US_EAST_2", "US_WEST_1"]
}

El atributo PERIOD define un intervalo de tiempo para que se ejecute su monitor. Para definir el intervalo, utilice estos formularios:

EVERY_MINUTE por cada minuto.
EVERY_N_MINUTES, donde 'N' son minutos. Los valores admitidos incluyen EVERY_5_MINUTES, EVERY_10_MINUTES, EVERY_15_MINUTES y EVERY_30_MINUTES.
EVERY_HOUR por cada hora.
EVERY_N_HOURS, donde 'N' son horas. Los valores admitidos incluyen EVERY_6_HOURS y EVERY_12_HOURS.
EVERY_DAY por una vez al día.

Algunos campos son para una configuración más avanzada. Estos son opcionales.

Para el monitor de ping, estos incluyen:

HEADER_NAME: los nombres de encabezado personalizados que aparecen en la solicitud.
HEADER_VALUE: el valor del encabezado personalizado en la solicitud.
REDIRECT_IS_FAILURE: Su monitor informa una falla si es redirigido.
VALIDATION_TEXT: si este texto no se incluye en la respuesta de su monitor, devuelve un error.
TLS_VALIDATION: Verifica la validez de la cadena del certificado SSL.
Para un monitor de navegador simple:
RUNTIME_TYPE: el tipo de tiempo de ejecución utilizado por su monitor. "CHROME_BROWSER" es el único valor aceptado.
RUNTIME_TYPE_VERSION: la versión del tipo de tiempo de ejecución utilizada por su monitor. "100" es el único valor aceptado.
SCRIPT_LANGUAGE: el idioma utilizado en su monitor. "JAVASCRIPT" es el único valor aceptado.
Para monitor API con script:
SCRIPT_CONTENT: El contenido real del script. Esto no debe estar codificado en base64.
RUNTIME_TYPE: el tipo de tiempo de ejecución utilizado por su monitor. "NODE_API" es el único valor aceptado.
RUNTIME_TYPE_VERSION: la versión del tipo de tiempo de ejecución utilizada por su monitor. El único valor aceptado es 16.10.
SCRIPT_LANGUAGE: el idioma utilizado en su monitor. "JAVASCRIPT" es el único valor aceptado.
Para monitor de navegador con script:
SCRIPT_CONTENT: El contenido real del script. Esto no debe estar codificado en base64.
RUNTIME_TYPE: el tipo de tiempo de ejecución utilizado por su monitor. "CHROME_BROWSER" es el único valor aceptado.
RUNTIME_TYPE_VERSION: la versión del tipo de tiempo de ejecución utilizada por su monitor. "100" es el único valor aceptado.
SCRIPT_LANGUAGE: el idioma utilizado en su monitor. "JAVASCRIPT" es el único valor aceptado.
Para el monitor de verificación de certificados:
DAYS_UNTIL_EXPIRATION: Le notifica cuando necesita actualizar su certificado. Por ejemplo, si desea recibir una notificación 30 días antes de que caduque el certificado, deberá ingresar 30.
Para todos los monitores:
APDEX_TARGET: el objetivo Apdex del monitor utilizado para completar los informes SLA. El valor predeterminado es 7 segundos (7000 ms).

Utilice consulta para recuperar datos

Consulta realizar solicitudes para recuperar datos. Para conocer capacidades de consulta adicionales disponibles para su entidad Sintético, consulte el tutorial de API de entidad NerdGraph.

Puedes consultar tus monitores Sintético para obtener información del estado actual de tus datos o detalles sobre la configuración monitor . Algunos ejemplos de consulta incluyen:

{
  actor {
    entitySearch(query: "domain = 'SYNTH' AND type = 'MONITOR'") {
      results {
        entities {
          ... on SyntheticMonitorEntityOutline {
            guid
            name
            accountId
            monitorType
            tags {
              key
              values
            }
          }
        }
      }
    }
  }
}

Puedes consultar tu ubicación privada:

{
  actor {
    entitySearch(query: "domain = 'SYNTH' AND type = 'PRIVATE_LOCATION'") {
      results {
        entities {
          accountId
          guid
          name
          tags {
            key
            values
          }
        }
      }
    }
  }
}

Consultar credenciales seguras solo le permite recuperar metadatos, pero no los valores de las credenciales en sí:

{
  actor {
    entitySearch(query: "domain = 'SYNTH' AND type = 'SECURE_CRED'") {
      results {
        entities {
          ... on SecureCredentialEntityOutline {
            accountId
            guid
            name
            tags {
              key
              values
            }
            updatedAt
          }
        }
      }
    }
  }
}

Recupere el script utilizado en una API con script o supervise el script del navegador. Otros tipos monitor devolverán un error.

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      synthetics {
        script(monitorGuid: "ENTITY_GUID") {
          text
        }
      }
    }
  }
}

Recupera los pasos configurados para un monitor de pasos. Otros tipos de monitor devolverán un error.

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      synthetics {
        steps(monitorGuid: "ENTITY_GUID") {
          ordinal
          type
          values
        }
      }
    }
  }
}

Recupere el GUID de la entidad para un monitor Sintético utilizando el ID del monitor.

{
  actor {
    entitySearch(
      query: "(domainId = 'MONITOR_ID')"
    ) {
      results {
        entities {
          ... on SyntheticMonitorEntityOutline {
            guid
            name
            monitorId
          }
        }
      }
    }
  }
}

Crea tu monitor Sintético

A continuación se muestran algunos ejemplos de solicitudes para automatizar la creación de su monitor Sintético.

Sugerencia

Incluya el objeto de tiempo de ejecución que incluye runtimeType, runtimeTypeVersion y scriptLanguage para utilizar un tiempo de ejecución más nuevo. No incluya el objeto de tiempo de ejecución ni estos atributos para continuar usando un tiempo de ejecución legacy .

El monitor de ping comprueba que su aplicación se esté ejecutando. Aquí hay un ejemplo para crear uno en NerdGraph:

mutation {
    syntheticsCreateSimpleMonitor (
      accountId: YOUR_ACCOUNT_ID 
      monitor: {
        locations: {
          public: ["LOCATION_1", "LOCATION_2"]
          }, 
        name: "YOUR_MONITOR_NAME", 
        period: PERIOD, 
        status: STATUS, 
        uri: "MONITORED_URI", 
        advancedOptions: {
          customHeaders: {
            name: "HEADER_NAME", 
            value: "HEADER_VALUE"
          }, 
          redirectIsFailure: REDIRECT_IS_FAILURE, 
          responseValidationText: "VALIDATION_TEXT", 
          shouldBypassHeadRequest: BYPASS_HEAD_REQUEST, 
          useTlsValidation: TLS_VALIDATION
        }, 
        apdexTarget: APDEX_TARGET
      }
  ) {
      errors {
        description
        type
      }
    }
  }

El monitor browser simple utiliza una instancia de Chrome para imitar las visitas de los clientes. Aquí hay un ejemplo para crear uno en NerdGraph:

mutation {
    syntheticsCreateSimpleBrowserMonitor (
      accountId: YOUR_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"
        }
        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
      }
    }
  }

monitor de browser con script son interacciones más complejas con sus páginas y aplicaciones. Aquí hay un ejemplo para crear uno en NerdGraph:

mutation {
    syntheticsCreateScriptBrowserMonitor (
      accountId: YOUR_ACCOUNT_ID, 
      monitor: { 
        locations: {
          public: ["LOCATION_1", "LOCATION_2"]
          }, 
        name: "MONITOR_NAME", 
        period: PERIOD,
        runtime: {
          runtimeType: "RUNTIME_TYPE",
          runtimeTypeVersion: "RUNTIME_TYPE_VERSION",
          scriptLanguage: "SCRIPT_LANGUAGE"
        }
        script: "SCRIPT_CONTENT", 
        status: STATUS, 
        advancedOptions: {
          enableScreenshotOnFailureAndScript: ENABLE_SCREENSHOT
        }, 
        apdexTarget: APDEX_TARGET
      }
    ) {
      errors {
        description
        type
      }
    }
  }

El monitor de API con secuencia de comandos verifica sus extremos de API. Aquí hay un ejemplo para crear uno en NerdGraph:

mutation {
    syntheticsCreateScriptApiMonitor (
      accountId: YOUR_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
      }
    }
  }

El monitor de pasos proporciona un monitor basado en browser de varios pasos sin código. Aquí hay un ejemplo para crear uno en NerdGraph:

mutation {
syntheticsCreateStepMonitor (
  accountId: NR_ACCOUNT_ID, 
  monitor: {
    locations: {
      public: ["LOCATION_1", "LOCATION_2"]
      },  
    name: "MONITOR_NAME", 
    period: PERIOD, 
    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
    }
}
}

Configure el monitor para que le notifique cuando su certificado SSL esté a punto de caducar. Aquí hay un ejemplo para crear uno en NerdGraph:

mutation {
    syntheticsCreateCertCheckMonitor (
      accountId: YOUR_ACCOUNT_ID, 
      monitor: {
        domain: "DOMAIN", 
        locations: {
          public: ["LOCATION_1", "LOCATION_2"]
          },
        name: "YOUR_MONITOR_NAME", 
        numberDaysToFailBeforeCertExpires: DAYS_UNTIL_EXPIRATION, 
        period: PERIOD, 
        status: STATUS, 
        apdexTarget: APDEX_TARGET
      }
    ) {
      errors {
        description
        type
      }
    }
  }

El monitor de enlaces rotos comprueba si los enlaces de una página web fallan. Aquí hay un ejemplo para crear uno en NerdGraph:

mutation {
  syntheticsCreateBrokenLinksMonitor (
    accountId: YOUR_ACCOUNT_ID, 
    monitor: {
      locations: {
        public: ["LOCATION_1", "LOCATION_2"]
        }, 
      name: "YOUR_MONITOR_NAME", 
      period: PERIOD, 
      status: STATUS, 
      apdexTarget: APDEX_TARGET, 
      uri: "MONITOR_URI", 
      tags: {
        key: "YOUR_TAG_NAME", 
        values: "TAG_VALUE"
        }
      }
    ) {
      errors {
        description
        type
      }
  }
}

Actualiza tu monitor Sintético

Si bien no puede cambiar el tipo de monitor después de crearlo, puede actualizar su configuración. Solo se requieren la guía y la configuración que deben actualizarse como parte de la solicitud.

Sugerencia

Incluya el objeto de tiempo de ejecución que incluye runtimeType, runtimeTypeVersion y scriptLanguage para actualizar un monitor para usar un tiempo de ejecución más nuevo. Incluya este objeto y establezca estos atributos en una cadena vacía para degradar a un tiempo de ejecución legacy . No incluya este objeto ni estos atributos para continuar usando un tiempo de ejecución legacy .

Utilice esto para actualizar su monitor de ping:

mutation {
  syntheticsUpdateSimpleMonitor (
    guid: "ENTITY_GUID", 
    monitor: {
      locations: {
        public: ["LOCATION_1", "LOCATION_2"]
      },  
      name: "YOUR_MONITOR_NAME", 
      period: PERIOD, 
      status: STATUS, 
      uri: "MONITORED_URI", 
      advancedOptions: {
        customHeaders: {
          name: "HEADER_NAME", 
          value: "HEADER_VALUE"
        }, 
        redirectIsFailure: REDIRECT_IS_FAILURE, 
        responseValidationText: "VALIDATION_TEXT", 
        shouldBypassHeadRequest: BYPASS_HEAD_REQUEST, 
        useTlsValidation: TLS_VALIDATION
      }, 
      apdexTarget: APDEX_TARGET
    }
  ) {
    errors {
      description
      type
    }
  }
}

Para actualizar un monitor browser simple (incluida la capacidad de actualizar la versión en tiempo de ejecución), use esto:

mutation {
    syntheticsUpdateSimpleBrowserMonitor (
      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"
        }
        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
      }
    }
  }

Para actualizar un script de monitor de browser con (incluida la capacidad de actualizar la versión en tiempo de ejecución), use esto:

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

Para actualizar un monitor API con secuencia de comandos (incluida la capacidad de actualizar la versión en tiempo de ejecución), use esto:

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
      }
    }
  }

Utilice esto para actualizar un monitor de pasos:

mutation {
  syntheticsCreateStepMonitor (
    accountId: NR_ACCOUNT_ID, 
    monitor: {
      locations: {
        public: ["LOCATION_1", "LOCATION_2"]
        },  
      name: "MONITOR_NAME", 
      period: PERIOD, 
      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
      }
  }
}

Utilice esto para actualizar un monitor de verificación de certificados:

mutation {
    syntheticsUpdateCertCheckMonitor (
      guid: ENTITY_GUID, 
      monitor: {
        domain: "DOMAIN", 
        locations: {
          public: ["LOCATION_1", "LOCATION_2"]
          },
        name: "YOUR_MONITOR_NAME", 
        numberDaysToFailBeforeCertExpires: DAYS_UNTIL_EXPIRATION, 
        period: PERIOD, 
        status: STATUS, 
        apdexTarget: APDEX_TARGET
      }
    ) {
      errors {
        description
        type
      }
    }
  }

Utilice esto para actualizar un monitor de enlaces rotos:

mutation {
  syntheticsUpdateBrokenLinksMonitor (
    guid: ENTITY_GUID, 
    monitor: {
      locations: {
        public: ["LOCATION_1", "LOCATION_2"]
        }, 
      name: "YOUR_MONITOR_NAME", 
      period: PERIOD, 
      status: STATUS, 
      apdexTarget: APDEX_TARGET, 
      uri: "MONITOR_URI", 
      tags: {
        key: "YOUR_TAG_NAME", 
        values: "TAG_VALUE"
        }
      }
    ) {
      errors {
        description
        type
      }
  }
}

Puede utilizar el siguiente ejemplo para actualizar un browser simple, una API con secuencia de comandos o monitorear el navegador con una secuencia de comandos a los nuevos tiempos de ejecución de Chrome 100+ o Node.js 16.10. El siguiente ejemplo actualiza un script de monitor de browser con al nuevo tiempo de ejecución desde el tiempo de ejecución legacy .

Para actualizar un monitor browser simple usando el siguiente ejemplo, cambie la mutación a syntheticsUpdateSimpleBrowserMonitor en lugar de syntheticsUpdateScriptBrowserMonitor.

Para actualizar un monitor API con secuencia de comandos utilizando el siguiente ejemplo, cambie la mutación a syntheticsUpdateScriptApiMonitor en lugar de syntheticsUpdateScriptBrowserMonitor.

Consulte los campos opcionales para obtener detalles adicionales sobre la configuración del tiempo de ejecución.

mutation {
  syntheticsUpdateScriptBrowserMonitor ( 
    guid: "<ENTITY_GUID>", 
    monitor: {
      runtime: {
        runtimeType: "RUNTIME_TYPE", 
        runtimeTypeVersion: "RUNTIME_TYPE_VERSION", 
        scriptLanguage: "SCRIPT_LANGUAGE"
        }
      }
    ) {
    errors {
      description
      type
    }
  }
}

Eliminar un monitor Sintético

Utilice estos scripts para eliminar su monitor:

Gestiona tu ubicación privada

Una ubicación privada le permite monitorear la aplicación detrás de su firewall. Cuando creas una ubicación privada, instalas y configuras minion privado para ejecutar el monitor asignado a esa ubicación privada.

mutation{
  syntheticsCreatePrivateLocation (
    accountId: NR_ACCOUNT_ID,
    name: "PrivateLocationName",
    description: "Optional description",
    verifiedScriptExecution: false
  ) {
    guid
    errors {
      description
      type
    }
  }
}

mutation {
  syntheticsUpdatePrivateLocation (
    guid: YOUR_ENTITY_GUID,     
    description: "EnterYourDescription", 
    verifiedScriptExecution: true
  ) {
  description
  verifiedScriptExecution
  errors {
    description
    type
    }
  }
}

Si necesita eliminar un trabajo atrasado difícil de manejar, utilice esto:

mutation {
  syntheticsPurgePrivateLocationQueue (
    guid: YOUR_ENTITY_GUID
    ) {
    errors {
      description
      type
    }
  }
}

Administre sus credenciales seguras

Utilice credenciales seguras al almacenar, proteger y administrar de forma centralizada la información protegida utilizada por su monitor, como contraseñas, clave de API o certificados codificados. El uso de NerdGraph le permite cambiar mediante programación los valores de sus credenciales seguras si necesita restablecer alguna credencial por algún motivo.

mutation {
  syntheticsCreateSecureCredential (
    accountId: YOUR_ENTITY_GUID, 
    description: "YourOptionalDescription", 
    key: SECURE_CREDENTIAL_NAME, 
    value: SECURE_CREDENTIAL_VALUE 
    ) {
    errors {
      description
    }
  }
}

mutation {
  syntheticsUpdateSecureCredential (
    accountId: YOUR_ACCOUNT_ID, 
    description: "YourOptionalDescription", 
    key: SECURE_CREDENTIAL_NAME, 
    value: SECURE_CREDENTIAL_VALUE) {
    createdAt
    lastUpdate
    errors {
      description
    }
  }
}

Gestiona el tiempo de inactividad de tu monitor

Monitor tiempo de inactividad te permite especificar horas en las que tu Sintético debe dejar de funcionar. Hemos proporcionado diferentes fragmentos que demuestran cómo programar el tiempo de inactividad del monitor para su Sintético. Debe actualizar estos fragmentos para especificar la zona horaria, las horas de inicio y de finalización. Para obtener más información sobre cuándo puede programar el tiempo de inactividad del monitor, consulte nuestro documento Deshabilitar el monitoreo durante los horarios de mantenimiento programados. Para encontrar valores de zona horaria, consulte la base de datos tz de zonas horarias. Por ejemplo, América/Los Ángeles usaría la abreviatura PDT.

mutation {
  syntheticsCreateOnceMonitorDowntime (
    accountId: NR_ACCOUNT_ID,
    name: "MonitorDowntimeName",
    monitorGuids: ["OptionalMonitorEntityGuid", "OptionalMonitorEntityGuid"],
    timezone: "Timezone",
    startTime: "yyyy-MM-ddTHH:mm:ss",
    endTime: "yyyy-MM-ddTHH:mm:ss"
  ) {
    guid,
    accountId,
    name,
    monitorGuids,
    timezone,
    startTime,
    endTime
  }
}

mutation {
  syntheticsCreateDailyMonitorDowntime (
    accountId: NR_ACCOUNT_ID,
    name: "MonitorDowntimeName",
    monitorGuids: ["OptionalMonitorEntityGuid", "AnotherOptionalMonitorEntityGuid"],
    timezone: "Timezone",
    startTime: "yyyy-MM-ddTHH:mm:ss",
    endTime: "yyyy-MM-ddTHH:mm:ss",
    endRepeat: {
      onDate: "yyyy-MM-ddTHH:mm:ss",
      onRepeat: Int
    }
  ) {
    guid,
    accountId,
    name,
    monitorGuids,
    timezone,
    startTime,
    endTime,
    endRepeat {
      onDate,
      onRepeat
    }
  }
}

mutation {
  syntheticsCreateWeeklyMonitorDowntime (
    accountId: NR_ACCOUNT_ID,
    name: "MonitorDowntimeName",
    monitorGuids: ["OptionalMonitorEntityGuid", "AnotherOptionalMonitorEntityGuid"],
    timezone: "Timezone",
    startTime: "yyyy-MM-ddTHH:mm:ss",
    endTime: "yyyy-MM-ddTHH:mm:ss",
    endRepeat: {
      onDate: "yyyy-MM-ddTHH:mm:ss",
      onRepeat: Int
    },
    maintenanceDays: [WeekDaysEnums]
  ) {
    guid,
    accountId,
    name,
    monitorGuids,
    timezone,
    startTime,
    endTime,
    endRepeat {
      onDate,
      onRepeat
    },
    maintenanceDays
  }
}

mutation {
  syntheticsCreateMonthlyMonitorDowntime (
    accountId: NR_ACCOUNT_ID,
    name: "MonitorDowntimeName",
    monitorGuids: ["OptionalMonitorEntityGuid", "AnotherOptionalMonitorEntityGuid"],
    timezone: "Timezone",
    startTime: "yyyy-MM-ddTHH:mm:ss",
    endTime: "yyyy-MM-ddTHH:mm:ss",
    endRepeat: {
      onDate: "yyyy-MM-ddTHH:mm:ss",
      onRepeat: Int
    },
    frequency: {
      daysOfWeek: {
        weekDay: WeekDaysEnum,
        ordinalDayOfMonth: DayOfMonthOrdinal
      },
      daysOfMonth: [Int]
    }
  ) {
    guid,
    accountId,
    name,
    monitorGuids,
    timezone,
    startTime,
    endTime,
    endRepeat {
      onDate,
      onRepeat
    },
    frequency {
      daysOfWeek {
        weekDay,
        ordinalDayOfMonth
      },
      daysOfMonth
    }
  }
}

mutation {
  syntheticsEditMonitorDowntime (
    guid: "MonitorDowntimeEntityGuid",
    name: "MONITOR_DOWNTIME_NAME",
    monitorGuids: ["OptionalMonitorEntityGuid", "AnotherOptionalMonitorEntityGuid"],
    once: {
      timezone: "Timezone",
      startTime: "yyyy-MM-ddTHH:mm:ss",
      endTime: "yyyy-MM-ddTHH:mm:ss"
    },
    daily: {
      timezone: "Timezone",
      startTime: "yyyy-MM-ddTHH:mm:ss",
      endTime: "yyyy-MM-ddTHH:mm:ss",
      endRepeat: {
        onDate: "yyyy-MM-ddTHH:mm:ss",
        onRepeat: Int
      }
    },
    weekly: {
      timezone: "Timezone",
      startTime: "yyyy-MM-ddTHH:mm:ss",
      endTime: "yyyy-MM-ddTHH:mm:ss",
      endRepeat: {
        onDate: "yyyy-MM-ddTHH:mm:ss",
        onRepeat: Int
      },
      maintenanceDays: [WeekDaysEnums]
    },
    monthly: {
      timezone: "Timezone",
      startTime: "yyyy-MM-ddTHH:mm:ss",
      endTime: "yyyy-MM-ddTHH:mm:ss",
      endRepeat: {
        onDate: "yyyy-MM-ddTHH:mm:ss",
        onRepeat: Int
      },
      frequency: {
        daysOfWeek: {
          weekDay: WeekDaysEnum,
          ordinalDayOfMonth: DayOfMonthOrdinal
      },
      daysOfMonth: [Int]
    }
  ) {
    guid,
    accountId,
    name,
    monitorGuids,
    timezone,
    startTime,
    endTime,
    endRepeat {
      onDate,
      onRepeat
    },
    maintenanceDays,
    frequency {
      daysOfWeek {
        weekDay,
        ordinalDayOfMonth
      },
      daysOfMonth
    }
  }
}

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

Tutorial de NerdGraph: Administra tu monitor Sintético

Requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Comprender los campos en el explorador NerdGraph

Definir campos de período

Definir campos de etiqueta

Definir campos opcionales

Utilice consulta para recuperar datos

Monitor de consulta

Consulta ubicación privada

Consultar credenciales seguras

De consulta monitor script

Consulta monitorear pasos

Consulta para asignar el ID del monitor al GUID de la entidad

Crea tu monitor Sintético

Sugerencia

Crear un monitor de ping

Crea un monitor browser simple

Crear un browsercon script

Crear un monitor API con script

Crear un monitor de pasos

Crear un monitor de verificación de certificados

Crear un monitor de enlaces rotos

Actualiza tu monitor Sintético

Sugerencia

Actualizar un monitor de ping

Actualizar un monitor browser simple

Actualizar un monitor de navegador con script

Actualizar un monitor de prueba API

Actualizar un monitor de pasos

Actualizar un monitor de verificación de certificados

Actualizar un monitor de enlaces rotos

Actualizar el tiempo de ejecución de un monitor

Eliminar un monitor Sintético

Eliminar monitor

Gestiona tu ubicación privada

Crear una ubicación privada

Actualizar una ubicación privada

Eliminar una ubicación privada

Limpiar una cola de trabajos de una ubicación privada

Administre sus credenciales seguras

Crear una credencial segura

Actualizar una credencial segura

Eliminar una credencial segura

Gestiona el tiempo de inactividad de tu monitor

Cree un tiempo de inactividad del monitor que se ejecute una vez

Cree un tiempo de inactividad del monitor que se ejecute diariamente

Cree un tiempo de inactividad del monitor que se ejecute semanalmente

Cree un tiempo de inactividad del monitor que se ejecute mensualmente

Actualizar un tiempo de inactividad del monitor

Eliminar un tiempo de inactividad del monitor

Requisitos