Gestionar monitores de comprobación de certificados

New Relic le permite emplear NerdGraph para crear monitores de verificación de certificados. Los monitores de verificación de certificados rastrean las fechas de vencimiento de los certificados SSL y le notifican cuando los certificados están a punto de vencer. Este tutorial proporciona ejemplos de cómo emplear la API NerdGraph para automatizar la creación de monitores de verificación de certificados.

Crear un monitor de verificación de certificados

Puede crear un monitor de verificación de certificado empleando la mutación syntheticsCreateCertCheckMonitor. Esta mutación le permite configurar el monitoreo de la expiración del certificado SSL en cualquier dominio.

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.domain`	Cadena	Sí	El dominio que se debe monitorear para verificar la expiración del certificado (por ejemplo, `example.com` ).
`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 verificación de certificado.
`monitor.numberDaysToFailBeforeCertExpires`	Entero	Sí	Número de días antes de la expiración del certificado para que se active una falla. Por ejemplo, si se establece en 30, significa que el monitor fallará cuando al certificado le falten 30 días o menos para su vencimiento.
`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.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 {
  syntheticsCreateCertCheckMonitor(
    accountId: 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
    }
  }
}

Ejemplo de respuesta

Una respuesta exitosa devuelve null para los errores:

{
  "data": {
    "syntheticsCreateCertCheckMonitor": {
      "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 verificación de certificados

Puede actualizar un monitor de verificación de certificado existente empleando la mutación syntheticsUpdateCertCheckMonitor. Esto le permite modificar la configuración de un monitor de verificación de certificados 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.domain`	Cadena	No	El dominio que se debe monitorear para verificar la expiración del certificado (por ejemplo, `example.com` ).
`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 verificación de certificados.
`monitor.numberDaysToFailBeforeCertExpires`	Entero	No	Número de días antes de la expiración del certificado para que se active una falla.
`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.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 {
  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
    }
  }
}

Ejemplo de respuesta

Una respuesta exitosa devuelve null para los errores:

{
  "data": {
    "syntheticsUpdateCertCheckMonitor": {
      "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 comprobación de certificados

Cuando ya no se necesita un monitor de verificación de certificado, puede 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 comprobación de certificados

Crear un monitor de verificación de certificados .css-21sua1{background:none;border:none;width:0;padding:0;}

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Actualizar un monitor de verificación de certificados

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Eliminar un monitor de comprobación de certificados

Crear un monitor de verificación de certificados