Monitor tiempo de inactividad te permite programar periodos en los que tus monitores Sintético dejan de funcionar. Esto es útil durante el mantenimiento planeado, la implementación o interrupciones conocidas cuando no desea recibir alertas. Puede crear horarios de inactividad únicos o recurrentes (diarios, semanales o mensuales). Este tutorial proporciona ejemplos de cómo emplear la API de NerdGraph para gestionar mediante programación el tiempo de inactividad del monitor. Para gestionar el tiempo de inactividad del monitor mediante la UI, consulte Deshabilitar el monitoreo durante los tiempos de mantenimiento programados.
Sugerencia
Para conocer los valores de zona horaria, consulte la base de datos tz de zonas horarias. Por ejemplo, emplee America/Los_Angeles para la hora del Pacífico.
Crear un tiempo de inactividad del monitor por única vez
Puede crear un tiempo de inactividad del monitor único empleando la mutación syntheticsCreateOnceMonitorDowntime. Emplee esto para mantenimiento planeado o eventos que ocurren solo una vez.
parámetro de entrada
Parámetro | Tipo de datos | ¿Es obligatorio? | Descripción |
|---|---|---|---|
| Entero | Sí | El New Relic donde se creará el tiempo de inactividad. |
| Cadena | Sí | Un nombre descriptivo para el periodo de tiempo de inactividad. |
| Matriz | No | Lista de de monitor a incluir en el tiempo de inactividad. Déjelo vacío para aplicar a todos los monitores. |
| Cadena | Sí | La zona horaria para el horario de tiempo de inactividad (por ejemplo,
). |
| Cadena | Sí | Cuando el tiempo de inactividad comienza en formato
. |
| Cadena | Sí | Cuando el tiempo de inactividad finaliza en formato
. |
Solicitud de muestra
mutation { syntheticsCreateOnceMonitorDowntime( accountId: 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 }}Crear un tiempo de inactividad recurrente diario del monitor
Puede crear un tiempo de inactividad recurrente diario del monitor empleando la mutación syntheticsCreateDailyMonitorDowntime. Emplee esto para las ventanas de mantenimiento regulares que ocurren todos los días.
parámetro de entrada
Parámetro | Tipo de datos | ¿Es obligatorio? | Descripción |
|---|---|---|---|
| Entero | Sí | El New Relic donde se creará el tiempo de inactividad. |
| Cadena | Sí | Un nombre descriptivo para el tiempo de inactividad recurrente. |
| Matriz | No | Lista de de monitor a incluir en el tiempo de inactividad. |
| Cadena | Sí | La zona horaria para el horario de tiempo de inactividad. |
| Cadena | Sí | Hora de inicio diaria en formato
. |
| Cadena | Sí | Hora de finalización diaria en formato
. |
| Objeto | No | Cuándo detener el tiempo de inactividad recurrente. Emplee
para una fecha específica o
para el número de ocurrencias. |
Solicitud de muestra
mutation { syntheticsCreateDailyMonitorDowntime( accountId: 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: 10 } ) { guid accountId name monitorGuids timezone startTime endTime endRepeat { onDate onRepeat } }}Crear un tiempo de inactividad recurrente semanal del monitor
Puede crear un tiempo de inactividad recurrente semanal del monitor empleando la mutación syntheticsCreateWeeklyMonitorDowntime. Emplee esto para las ventanas de mantenimiento que ocurren en días específicos de la semana.
parámetro de entrada
Parámetro | Tipo de datos | ¿Es obligatorio? | Descripción |
|---|---|---|---|
| Entero | Sí | El New Relic donde se creará el tiempo de inactividad. |
| Cadena | Sí | Un nombre descriptivo para el tiempo de inactividad semanal. |
| Matriz | No | Lista de de monitor a incluir en el tiempo de inactividad. |
| Cadena | Sí | La zona horaria para el horario de tiempo de inactividad. |
| Cadena | Sí | Hora de inicio semanal en formato
. |
| Cadena | Sí | Hora de finalización semanal en formato
. |
| Matriz | Sí | Días de la semana (por ejemplo,
,
,
). |
| Objeto | No | Cuándo detener el tiempo de inactividad recurrente. |
Solicitud de muestra
mutation { syntheticsCreateWeeklyMonitorDowntime( accountId: ACCOUNT_ID name: "MonitorDowntimeName" monitorGuids: [ "OptionalMonitorEntityGuid" "AnotherOptionalMonitorEntityGuid" ] timezone: "TIMEZONE" startTime: "yyyy-MM-ddTHH:mm:ss" endTime: "yyyy-MM-ddTHH:mm:ss" maintenanceDays: [MONDAY, WEDNESDAY, FRIDAY] endRepeat: { onDate: "yyyy-MM-ddTHH:mm:ss", onRepeat: 20 } ) { guid accountId name monitorGuids timezone startTime endTime maintenanceDays endRepeat { onDate onRepeat } }}Crear un tiempo de inactividad recurrente mensual del monitor
Puede crear un tiempo de inactividad recurrente mensual del monitor empleando la mutación syntheticsCreateMonthlyMonitorDowntime. Emplee esto para las ventanas de mantenimiento que ocurren en días específicos cada mes.
parámetro de entrada
Parámetro | Tipo de datos | ¿Es obligatorio? | Descripción |
|---|---|---|---|
| Entero | Sí | El New Relic donde se creará el tiempo de inactividad. |
| Cadena | Sí | Un nombre descriptivo para el tiempo de inactividad mensual. |
| Matriz | No | Lista de de monitor a incluir en el tiempo de inactividad. |
| Cadena | Sí | La zona horaria para el horario de tiempo de inactividad. |
| Cadena | Sí | Hora de inicio mensual en formato
. |
| Cadena | Sí | Hora de finalización mensual en formato
. |
| Objeto | Sí | Define en qué momento del mes se produce el tiempo de inactividad. Emplee
para fechas relativas (por ejemplo, el primer lunes) o
para fechas específicas (por ejemplo, el 15 de cada mes). |
| Objeto | No | Cuándo detener el tiempo de inactividad recurrente. |
Solicitud de muestra
mutation { syntheticsCreateMonthlyMonitorDowntime( accountId: ACCOUNT_ID name: "MonitorDowntimeName" monitorGuids: [ "OptionalMonitorEntityGuid" "AnotherOptionalMonitorEntityGuid" ] timezone: "TIMEZONE" startTime: "yyyy-MM-ddTHH:mm:ss" endTime: "yyyy-MM-ddTHH:mm:ss" frequency: { daysOfWeek: { weekDay: MONDAY, ordinalDayOfMonth: FIRST } daysOfMonth: [15] } endRepeat: { onDate: "yyyy-MM-ddTHH:mm:ss", onRepeat: 12 } ) { guid accountId name monitorGuids timezone startTime endTime frequency { daysOfWeek { weekDay ordinalDayOfMonth } daysOfMonth } endRepeat { onDate onRepeat } }}Actualizar un tiempo de inactividad del monitor
Puede actualizar un tiempo de inactividad de monitor existente empleando la mutación syntheticsEditMonitorDowntime. Esto le permite modificar cualquier tipo de tiempo de inactividad (una vez, diariamente, semanalmente o mensualmente) empleando esta única mutación.
parámetro de entrada
Parámetro | Tipo de datos | ¿Es obligatorio? | Descripción |
|---|---|---|---|
| Cadena | Sí | El del tiempo de inactividad del monitor existente para actualizar. |
| Cadena | No | Nombre actualizado para el tiempo de inactividad. |
| Matriz | No | Lista actualizada de de monitor. |
| Objeto | No | configuración para un tiempo de inactividad único. |
| Objeto | No | configuración para el tiempo de inactividad recurrente diario. |
| Objeto | No | configuración para el tiempo de inactividad recurrente semanal. |
| Objeto | No | configuración para el tiempo de inactividad recurrente mensual. |
Solicitud de muestra
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: 30 } } weekly: { timezone: "TIMEZONE" startTime: "yyyy-MM-ddTHH:mm:ss" endTime: "yyyy-MM-ddTHH:mm:ss" endRepeat: { onDate: "yyyy-MM-ddTHH:mm:ss", onRepeat: 20 } maintenanceDays: [MONDAY, WEDNESDAY] } monthly: { timezone: "TIMEZONE" startTime: "yyyy-MM-ddTHH:mm:ss" endTime: "yyyy-MM-ddTHH:mm:ss" endRepeat: { onDate: "yyyy-MM-ddTHH:mm:ss", onRepeat: 12 } frequency: { daysOfWeek: { weekDay: MONDAY, ordinalDayOfMonth: FIRST } daysOfMonth: [15] } } ) { guid accountId name monitorGuids timezone startTime endTime endRepeat { onDate onRepeat } maintenanceDays frequency { daysOfWeek { weekDay ordinalDayOfMonth } daysOfMonth } }}Eliminar un tiempo de inactividad del monitor
Puedes eliminar un tiempo de inactividad del monitor empleando la mutación syntheticsDeleteMonitorDowntime. Una vez eliminado, el tiempo de inactividad programado se eliminará y los monitores reanudarán su programación normal.
parámetro de entrada
Parámetro | Tipo de datos | ¿Es obligatorio? | Descripción |
|---|---|---|---|
| Cadena | Sí | El del monitor de tiempo de inactividad a eliminar. |
Solicitud de muestra
mutation { syntheticsDeleteMonitorDowntime(guid: "DOWNTIME_ENTITY_GUID") { guid }}