Gerenciar período de inatividade do monitor

Monitor período de inatividade permite agendar períodos em que seus monitores Sintético param de funcionar. Isso é útil durante manutenções programadas, implantações ou interrupções conhecidas, quando você não deseja receber alertas. Você pode criar períodos de inatividade únicos ou programações recorrentes (diárias, semanais ou mensais). Este tutorial fornece exemplos de como usar a API do NerdGraph para gerenciar programaticamente o período de inatividade do monitor. Para gerenciar o período de inatividade do monitor utilizando a interface, consulte Desativar monitoramento durante horários programados de manutenção.

Dica

Para valores de fuso horário, consulte o banco de dados de fusos horários tz. Por exemplo, use America/Los_Angeles para o Horário do Pacífico.

Crie um monitor único de período de inatividade

Você pode criar um monitor único de período de inatividade usando a mutação syntheticsCreateOnceMonitorDowntime. Use esta opção para manutenção programada ou eventos que ocorrem apenas uma vez.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`accountId`	Inteiro	Sim	O ID da conta New Relic onde o período de inatividade será criado.
`name`	Corda	Sim	Um nome descritivo para o período de inatividade.
`monitorGuids`	Matriz	Não	Lista de GUIDs de monitoramento a serem incluídos no período de inatividade. Deixe em branco para aplicar a todos os monitores.
`timezone`	Corda	Sim	O fuso horário da programação do período de inatividade (por exemplo, `America/New_York` ).
`startTime`	Corda	Sim	Quando o período de inatividade começa no formato `yyyy-MM-ddTHH:mm:ss` .
`endTime`	Corda	Sim	Quando o período de inatividade termina no formato `yyyy-MM-ddTHH:mm:ss` .

Solicitação de amostra

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

Crie um período de inatividade diário e recorrente para monitorar o tempo de inatividade.

Você pode criar um período de inatividade de monitoramento diário recorrente usando a mutação syntheticsCreateDailyMonitorDowntime. Use isso para janelas de manutenção regulares que ocorrem todos os dias.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`accountId`	Inteiro	Sim	O ID da conta New Relic onde o período de inatividade será criado.
`name`	Corda	Sim	Um nome descritivo para o período de inatividade recorrente.
`monitorGuids`	Matriz	Não	Lista de GUIDs de monitoramento a serem incluídos no período de inatividade.
`timezone`	Corda	Sim	O fuso horário da programação do período de inatividade.
`startTime`	Corda	Sim	Horário de início diário no formato `yyyy-MM-ddTHH:mm:ss` .
`endTime`	Corda	Sim	Horário de término diário no formato `yyyy-MM-ddTHH:mm:ss` .
`endRepeat`	Objeto	Não	Quando interromper o período de inatividade recorrente. Use `onDate` para uma data específica ou `onRepeat` para o número de ocorrências.

Solicitação de amostra

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

Crie um período de inatividade semanal recorrente para o monitor.

Você pode criar um período de inatividade de monitor recorrente semanal usando a mutação syntheticsCreateWeeklyMonitorDowntime. Use esta opção para janelas de manutenção que ocorrem em dias específicos da semana.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`accountId`	Inteiro	Sim	O ID da conta New Relic onde o período de inatividade será criado.
`name`	Corda	Sim	Um nome descritivo para o período de inatividade semanal.
`monitorGuids`	Matriz	Não	Lista de GUIDs de monitoramento a serem incluídos no período de inatividade.
`timezone`	Corda	Sim	O fuso horário da programação do período de inatividade.
`startTime`	Corda	Sim	Horário de início semanal no formato `yyyy-MM-ddTHH:mm:ss` .
`endTime`	Corda	Sim	Horário de término semanal no formato `yyyy-MM-ddTHH:mm:ss` .
`maintenanceDays`	Matriz	Sim	Dias da semana (ex.: `MONDAY` , `TUESDAY` , `WEDNESDAY` ).
`endRepeat`	Objeto	Não	Quando interromper o período de inatividade recorrente.

Solicitação de amostra

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

Crie um período de inatividade mensal recorrente para monitorar o tempo de inatividade.

Você pode criar um período de inatividade de monitoramento mensal recorrente usando a mutação syntheticsCreateMonthlyMonitorDowntime. Use esta opção para janelas de manutenção que ocorrem em dias específicos de cada mês.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`accountId`	Inteiro	Sim	O ID da conta New Relic onde o período de inatividade será criado.
`name`	Corda	Sim	Um nome descritivo para o período de inatividade mensal.
`monitorGuids`	Matriz	Não	Lista de GUIDs de monitoramento a serem incluídos no período de inatividade.
`timezone`	Corda	Sim	O fuso horário da programação do período de inatividade.
`startTime`	Corda	Sim	Horário de início mensal no formato `yyyy-MM-ddTHH:mm:ss` .
`endTime`	Corda	Sim	Horário de término mensal no formato `yyyy-MM-ddTHH:mm:ss` .
`frequency`	Objeto	Sim	Define quando no mês ocorre o período de inatividade. Use `daysOfWeek` para datas relativas (por exemplo, primeira segunda-feira) ou `daysOfMonth` para datas específicas (por exemplo, dia 15 de cada mês).
`endRepeat`	Objeto	Não	Quando interromper o período de inatividade recorrente.

Solicitação de amostra

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

Atualizar um período de inatividade do monitor

Você pode atualizar o período de inatividade de um monitor existente usando a mutação syntheticsEditMonitorDowntime. Isso permite modificar qualquer tipo de período de inatividade (único, diário, semanal ou mensal) usando essa única mutação.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`guid`	Corda	Sim	O GUID do período de inatividade do monitor existente a ser atualizado.
`name`	Corda	Não	Nome atualizado para o período de inatividade.
`monitorGuids`	Matriz	Não	Lista atualizada de GUIDs de monitores.
`once`	Objeto	Não	Configuração para período único de inatividade.
`daily`	Objeto	Não	Configuração para período de inatividade recorrente diário.
`weekly`	Objeto	Não	Configuração para período de inatividade recorrente semanal.
`monthly`	Objeto	Não	Configuração de período de inatividade recorrente mensal.

Solicitação de amostra

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

Excluir um período de inatividade do monitor

Você pode excluir um período de inatividade do monitor usando a mutação syntheticsDeleteMonitorDowntime. Após a exclusão, o período de inatividade programado será removido e os monitores retomarão sua programação normal.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`guid`	Corda	Sim	O GUID do período de inatividade do monitor a ser excluído.

Parâmetro

Tipo de dados

É obrigatório?

Descrição

guid

Corda

Sim

GUID

do período de inatividade do monitor a ser excluído.

Solicitação de amostra

mutation {
  syntheticsDeleteMonitorDowntime(guid: "DOWNTIME_ENTITY_GUID") {
    guid
  }
}

Esta tradução de máquina é fornecida para sua comodidade.

Gerenciar período de inatividade do monitor

Dica

Crie um monitor único de período de inatividade .css-21sua1{background:none;border:none;width:0;padding:0;}

Parâmetro de entrada

Solicitação de amostra

Crie um período de inatividade diário e recorrente para monitorar o tempo de inatividade.

Parâmetro de entrada

Solicitação de amostra

Crie um período de inatividade semanal recorrente para o monitor.

Parâmetro de entrada

Solicitação de amostra

Crie um período de inatividade mensal recorrente para monitorar o tempo de inatividade.

Parâmetro de entrada

Solicitação de amostra

Atualizar um período de inatividade do monitor

Parâmetro de entrada

Solicitação de amostra

Excluir um período de inatividade do monitor

Parâmetro de entrada

Solicitação de amostra

Crie um monitor único de período de inatividade