Gérer les temps d'arrêt du moniteur

Monitorer temps d'arrêt vous permet de programmer des périodes pendant lesquelles votre moniteur Synthétique s'arrête de fonctionner. Ceci est utile lors des opérations de maintenance planifiées, des déploiements ou des pannes connues, lorsque vous ne souhaitez pas recevoir d'alertes. Vous pouvez créer des temps d'arrêt ponctuels ou des programmes récurrents (quotidiens, hebdomadaires ou mensuels). Ce tutoriel fournit des exemples d'utilisation de l'API NerdGraph pour gérer par programmation les temps d'arrêt des moniteurs. Pour gérer les temps d'arrêt du moniteur à l'aide de l'interface utilisateur, reportez-vous à Désactiver monitoring pendant les périodes de maintenance planifiées.

Conseil

Pour les valeurs de fuseau horaire, consultez la base de données tz des fuseaux horaires. Par exemple, utilisez America/Los_Angeles pour l'heure du Pacifique.

Créer un temps d'arrêt du monitoring ponctuel

Vous pouvez créer un moniteur à usage unique temps d'arrêt en utilisant la mutation syntheticsCreateOnceMonitorDowntime. Utilisez ceci pour la maintenance planifiée ou les événements ponctuels.

Paramètres d'entrée

paramètres	Type de données	Est-ce obligatoire ?	Description
`accountId`	Entier	Oui	L' identifiant du compte New Relic sur lequel les temps d'arrêt seront créés.
`name`	Chaîne	Oui	Un nom descriptif pour la période de temps d'arrêt.
`monitorGuids`	Array	Non	Liste des GUID de moniteur à inclure dans les temps d'arrêt. Laisser vide pour appliquer à tous les moniteurs.
`timezone`	Chaîne	Oui	Le fuseau horaire pour l'horaire des temps d'arrêt (par exemple, `America/New_York` ).
`startTime`	Chaîne	Oui	Lorsque le temps d'arrêt commence au format `yyyy-MM-ddTHH:mm:ss` .
`endTime`	Chaîne	Oui	Lorsque le temps d'arrêt se termine au format `yyyy-MM-ddTHH:mm:ss` .

Demande d'échantillon

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

Créer un moniteur de temps d'arrêt récurrent quotidien

Vous pouvez créer un moniteur quotidien récurrent de temps d'arrêt en utilisant la mutation syntheticsCreateDailyMonitorDowntime. Utilisez ceci pour les fenêtres de maintenance régulières qui ont lieu quotidiennement.

Paramètres d'entrée

paramètres	Type de données	Est-ce obligatoire ?	Description
`accountId`	Entier	Oui	L' identifiant du compte New Relic sur lequel les temps d'arrêt seront créés.
`name`	Chaîne	Oui	Un nom descriptif pour le temps d'arrêt récurrent.
`monitorGuids`	Array	Non	Liste des GUID de moniteur à inclure dans les temps d'arrêt.
`timezone`	Chaîne	Oui	Le fuseau horaire de l'horaire des temps d'arrêt.
`startTime`	Chaîne	Oui	Heure de début quotidienne au format `yyyy-MM-ddTHH:mm:ss` .
`endTime`	Chaîne	Oui	Heure de fin de journée au format `yyyy-MM-ddTHH:mm:ss` .
`endRepeat`	Objet	Non	Quand arrêter les temps d'arrêt récurrents. Utilisez `onDate` pour une date spécifique ou `onRepeat` pour un nombre d'occurrences.

Demande d'échantillon

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

Créer un moniteur récurrent hebdomadaire temps d'arrêt

Vous pouvez créer un moniteur hebdomadaire récurrent de temps d'arrêt en utilisant la mutation syntheticsCreateWeeklyMonitorDowntime. Utilisez ceci pour les fenêtres de maintenance qui ont lieu certains jours de la semaine.

Paramètres d'entrée

paramètres	Type de données	Est-ce obligatoire ?	Description
`accountId`	Entier	Oui	L' identifiant du compte New Relic sur lequel les temps d'arrêt seront créés.
`name`	Chaîne	Oui	Un nom descriptif pour le temps d'arrêt hebdomadaire.
`monitorGuids`	Array	Non	Liste des GUID de moniteur à inclure dans les temps d'arrêt.
`timezone`	Chaîne	Oui	Le fuseau horaire de l'horaire des temps d'arrêt.
`startTime`	Chaîne	Oui	Heure de début hebdomadaire au format `yyyy-MM-ddTHH:mm:ss` .
`endTime`	Chaîne	Oui	Heure de fin de semaine au format `yyyy-MM-ddTHH:mm:ss` .
`maintenanceDays`	Array	Oui	Jours de la semaine (ex., `MONDAY` , `TUESDAY` , `WEDNESDAY` ).
`endRepeat`	Objet	Non	Quand arrêter les temps d'arrêt récurrents.

Demande d'échantillon

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

Créer un moniteur récurrent mensuel temps d'arrêt

Vous pouvez créer un moniteur mensuel récurrent de temps d'arrêt en utilisant la mutation syntheticsCreateMonthlyMonitorDowntime. Utilisez ceci pour les fenêtres de maintenance qui ont lieu à des dates précises chaque mois.

Paramètres d'entrée

paramètres	Type de données	Est-ce obligatoire ?	Description
`accountId`	Entier	Oui	L' identifiant du compte New Relic sur lequel les temps d'arrêt seront créés.
`name`	Chaîne	Oui	Un nom descriptif pour le temps d'arrêt mensuel.
`monitorGuids`	Array	Non	Liste des GUID de moniteur à inclure dans les temps d'arrêt.
`timezone`	Chaîne	Oui	Le fuseau horaire de l'horaire des temps d'arrêt.
`startTime`	Chaîne	Oui	Heure de début mensuelle au format `yyyy-MM-ddTHH:mm:ss` .
`endTime`	Chaîne	Oui	Date de fin de mois au format `yyyy-MM-ddTHH:mm:ss` .
`frequency`	Objet	Oui	Définit à quel moment du mois survient le temps d'arrêt. Utilisez `daysOfWeek` pour les dates relatives (par exemple, le premier lundi) ou `daysOfMonth` pour les dates spécifiques (par exemple, le 15 de chaque mois).
`endRepeat`	Objet	Non	Quand arrêter les temps d'arrêt récurrents.

Demande d'échantillon

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

Mettre à jour un moniteur temps d'arrêt

Vous pouvez mettre à jour un moniteur de temps d'arrêt existant en utilisant la mutation syntheticsEditMonitorDowntime. Cela vous permet de modifier n'importe quel type de temps d'arrêt (une fois, quotidiennement, hebdomadairement ou mensuellement) en utilisant cette seule mutation.

Paramètres d'entrée

paramètres	Type de données	Est-ce obligatoire ?	Description
`guid`	Chaîne	Oui	Le GUID du moniteur de temps d'arrêt existant à mettre à jour.
`name`	Chaîne	Non	Nouveau nom pour les temps d'arrêt.
`monitorGuids`	Array	Non	Liste mise à jour des GUID des moniteurs.
`once`	Objet	Non	configuration pour temps d'arrêt ponctuel.
`daily`	Objet	Non	configuration pour les temps d'arrêt récurrents quotidiens.
`weekly`	Objet	Non	configuration pour les temps d'arrêt récurrents hebdomadaires.
`monthly`	Objet	Non	configuration pour les temps d'arrêt récurrents mensuels.

Demande d'échantillon

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

Supprimer un moniteur temps d'arrêt

Vous pouvez supprimer un moniteur de temps d'arrêt en utilisant la mutation syntheticsDeleteMonitorDowntime. Une fois supprimés, les temps d'arrêt programmés seront retirés et le système de monitoring reprendra son fonctionnement normal.

Paramètres d'entrée

paramètres	Type de données	Est-ce obligatoire ?	Description
`guid`	Chaîne	Oui	Le GUID du moniteur temps d'arrêt à supprimer.

paramètres

Type de données

Est-ce obligatoire ?

Description

guid

Chaîne

Oui

GUID

du moniteur temps d'arrêt à supprimer.

Demande d'échantillon

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

Cette traduction automatique est fournie pour votre commodité.

Conseil

Créer un temps d'arrêt du monitoring ponctuel .css-21sua1{background:none;border:none;width:0;padding:0;}

Paramètres d'entrée

Demande d'échantillon

Créer un moniteur de temps d'arrêt récurrent quotidien

Paramètres d'entrée

Demande d'échantillon

Créer un moniteur récurrent hebdomadaire temps d'arrêt

Paramètres d'entrée

Demande d'échantillon

Créer un moniteur récurrent mensuel temps d'arrêt

Paramètres d'entrée

Demande d'échantillon

Mettre à jour un moniteur temps d'arrêt

Paramètres d'entrée

Demande d'échantillon

Supprimer un moniteur temps d'arrêt

Paramètres d'entrée

Demande d'échantillon

Créer un temps d'arrêt du monitoring ponctuel