Creare e gestire le posticipazioni

Questo documento descrive come creare e gestire i tuoi posticipa. La posticipazione impedisce a Cloud Monitoring creando incidenti e inviando notifiche durante in un determinato periodo di tempo. Ogni posticipo specifica le risorse a cui si applica.

Per una panoramica concettuale, vedi Posticipare notifiche e incidenti.

Per creare e gestire le posticipazioni, utilizza la console Google Cloud o la l'API Cloud Monitoring.

Prima di iniziare

  1. Assicurati di disporre delle autorizzazioni richieste:

    Per ulteriori informazioni sui ruoli di Cloud Monitoring, consulta Controllare l'accesso con Identity and Access Management.

  2. Se vuoi utilizzare gli esempi di API Cloud Monitoring in questo documento, segui questi passaggi:

    1. Crea una variabile di ambiente, PROJECT_ID, per conservare l'ID del tuo Progetto Google Cloud:

      PROJECT_ID=PROJECT_ID

    2. Esegui l'autenticazione in Google Cloud CLI:

      gcloud auth login

    3. Imposta il progetto Google Cloud predefinito:

      gcloud config set project ${PROJECT_ID}

    4. Crea un token di autorizzazione:

      ACCESS_TOKEN=`gcloud auth print-access-token`

      Devi aggiornare periodicamente il token di accesso. Se i comandi che hanno funzionato segnala improvvisamente che non sei autenticato, emetti di nuovo questo comando.

Crea un posticipo

Per impedire ai criteri di avviso di creare incidenti e inviare notifiche, crea una posticipazione.

Puoi creare una posticipazione utilizzando la console Google Cloud, gcloud CLI o l'API Cloud Monitoring.

console

  1. Nella console Google Cloud, vai alla pagina  Avvisi:

    Vai ad Avvisi

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Per creare una posticipazione da un incidente aperto:
    1. Nel riquadro Incidenti della pagina Allerte, individua l'incidente e fai clic sul relativo Riepilogo incidente.
    2. Nella pagina Dettagli incidente, fai clic su Posticipa e seleziona la durata della posticipazione. Non puoi configurare altri campi.

  3. In caso contrario, procedi nel seguente modo:

    1. Nella pagina Avvisi, fai clic su Crea posticipazione.
    2. Inserisci un nome descrittivo per la posticipazione. Questo nome viene mostrato nella Avvisi.
    3. Seleziona un'Ora di inizio. Puoi inserire un'ora specifica o avviare posticipa quando viene creata.
    4. Inserisci la Durata. Il valore di questo campo determina la durata della ripetizione.

    5. Completa la sezione Criteri per il posticipo. Puoi utilizzare lo Criteri di avviso per selezionare i criteri di avviso a cui la posticipazione si applica.

      Puoi aggiungere fino a 16 criteri di avviso a un posticipare la sveglia.

      Una volta completata la sezione Criteri per il posticipo, fai clic sul pulsante Crea posticipazione. che elenca gli incidenti passati che corrispondono ai criteri.

    6. Fai clic su Crea.

API Cloud Monitoring

Per creare una posticipazione, richiama il snoozes.create inviando una richiesta POST all'endpoint Snooze. Devi fornire un oggetto snooze:

curl -d @my-snooze.json -H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-X POST https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes

Il metodo restituisce un oggetto snooze. Il campo "name", che include l'ID posticipazione generato da Monitoraggio, è l'unica differenza tra l'oggetto restituito e i contenuti di my-snooze.json:

{
  "name": "projects/my-project/snoozes/2986666341878464512",
  "criteria": {
    "policies": [
      "projects/my-project/alertPolicies/787884840895011889"
    ]
  },
  "interval": {
    "startTime": "2022-11-12T19:00:20Z",
    "endTime": "2022-11-12T19:05:20Z"
  },
  "displayName": "Snooze2"
}

Interfaccia a riga di comando gcloud

Per creare una ripetizione, esegui il comando gcloud monitoring snoozes create:

gcloud monitoring snoozes create --criteria-policies=LIST_OF_POLICIES --display-name=DISPLAY_NAME --start-time=START_TIME --end-time=END_TIME

Nel comando precedente, end-time deve essere successiva di almeno un minuto rispetto a start-time. Devi seguire le regole di formattazione ISO 8601, ma puoi specificare orari assoluti o relativi. L'esempio seguente specifica i tempi assoluti. Per avviare una ripetizione di 30 minuti dall'ora corrente, usa --start-time="+PTM30M".

Se specifichi più progetti, separali con una virgola.

Ad esempio, il comando seguente crea una posticipazione con il nome visualizzato di "Settimana di manutenzione". La posticipazione si applica a due criteri di avviso e copre l'intervallo di tempo dal 1° marzo al 7 marzo:

gcloud monitoring snoozes create --display-name="Maintenance Week" \
    --criteria-policies="projects/my-project/alertPolicies/12345,projects/my-project/alertPolicies/23451" \
    --start-time="2023-03-01T03:00:00.0-0500" \
    --end-time="2023-03-07T23:59:59.5-0500"

L'esempio precedente crea la seguente posticipazione in my-project:

{
 "name": "projects/my-project/snoozes/98765",
 "displayName": "Maintenance Week",
 "interval": {
   "startTime": "2023-03-01T08:00:00Z",
   "endTime": "2023-03-08T04:59:59Z"
 },
 "criteria": {
   "policies": [
     "projects/my-project/alertPolicies/12345",
     "projects/my-project/alertPolicies/23451",
   ]
 }
}

Se l'esito è positivo, la risposta a questo comando è simile alla seguente:

Created snooze [projects/my-project/snoozes/98765]

Il nome di un criterio di avviso non viene visualizzato nella console Google Cloud. Per determinare il nome di un criterio di avviso, svolgi una delle seguenti operazioni:

  • Esegui il comando gcloud alpha monitoring policies list. I dati della risposta di questo comando include il nome dei tuoi criteri di avviso.
  • Visualizza la rappresentazione JSON di un criterio di avviso. Puoi scaricare una rappresentazione JSON nel sistema locale utilizzando un'opzione nella Pagina Dettagli norme.

Creare posticipazioni ricorrenti

Per creare posticipazioni che si verificano a intervalli ricorrenti, puoi scrivere uno script che crea una posticipazione per un criterio di avviso. Quindi, utilizza un programma di pianificazione dei job come cron o Cloud Scheduler per eseguire lo script in base alla pianificazione richiesta.

Elenca posticipazioni

Quando crei una posticipazione, questa viene aggiunta al relativo registro storico. per il tuo progetto. Questo record mostra le spostamenti in un secondo momento scaduti, attivi e imminenti. Non puoi rimuovere voci da questo record, ovvero non puoi eliminare un pisolino. Tuttavia, da questa visualizzazione puoi visualizzare i dettagli di una posticipazione e puoi eseguire azioni come modificarla o copiarla.

console

Per visualizzare un elenco di post in attesa:

  1. Nella console Google Cloud, vai alla pagina  Avvisi:

    Vai ad Avvisi

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Fai clic su Visualizza tutte le posticipazioni nel riquadro Posticipa.

    La pagina Posticipa mostra un elenco di posticipazioni e una sequenza temporale che visualizza graficamente le posticipazioni passate, imminenti e attive.

    • Per modificare, copiare, annullare o terminare una ripetizione, usa il menu Altre opzioni per la ripetizione. Lo stato di ripetizione determina le opzioni disponibili.
    • Per elencare tutte le posticipazioni, attiva Mostra posticipazioni passate. Per impostazione predefinita, vengono elencate solo le posticipazioni attive e imminenti.
    • Per modificare il periodo di visualizzazione della tabella Sequenza temporale, utilizza la proprietà Menu Intervallo di tempo. Per impostazione predefinita, la tabella mostra i dati per l'ora successiva; ma puoi modificare questo campo per specificare intervalli di tempo passati o futuri. Le posticipazioni scadute vengono conservate per 13 mesi.
    • Per visualizzare i dettagli di una posticipazione specifica, fai clic su Visualizza dettagli.
    • Per visualizzare un riepilogo delle posticipazioni attive, posiziona il puntatore sul area ombreggiata della riga Attivi nella tabella Sequenza temporale. Descrizione comando mostra le informazioni di riepilogo.
    • Per visualizzare una rappresentazione grafica delle spostamenti nel tempo attivi, espandi la riga Attivo della tabella Cronologia.

API Cloud Monitoring

Per elencare tutte le spostamenti nel tempo che appartengono a un progetto Google Cloud, invoca il metodo snoozes.list:

curl -H "Authorization: Bearer $ACCESS_TOKEN" \
https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes

Il metodo restituisce un elenco di oggetti snooze. Ad esempio, quando un progetto ha una posticipazione, la risposta al comando snoozes.list è simile alla seguente:

{
  "snoozes": [
    {
      "name": "projects/my-project/snoozes/2986663705844383744",
      "criteria": {
        "policies": [
          "projects/my-project/alertPolicies/787884840895011889"
        ]
      },
      "interval": {
        "startTime": "2022-11-08T19:00:20Z",
        "endTime": "2022-11-08T19:05:20Z"
      },
      "displayName": "Snooze1"
    }
  ]
}

Per ottenere informazioni su una posticipazione specifica, richiama il metodo Metodo snoozes.get e specificare l'ID progetto e l'ID posticipazione. Nella risposta precedente, l'ID posticipazione è 2986663705844383744:

curl -H "Authorization: Bearer $ACCESS_TOKEN" \
https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes/${SNOOZE_ID}

Il metodo restituisce un singolo oggetto snooze:

{
  "name": "projects/my-project/snoozes/2986663705844383744",
  "criteria": {
    "policies": [
      "projects/my-project/alertPolicies/787884840895011889"
    ]
  },
  "interval": {
    "startTime": "2022-11-08T19:00:20Z",
    "endTime": "2022-11-08T19:05:20Z"
  },
  "displayName": "Snooze1"
}

Interfaccia a riga di comando gcloud

Per elencare le posticipazioni nel progetto corrente, esegui il comando gcloud monitoring snoozes list:

gcloud monitoring snoozes list OPTIONAL_FLAGS

Per informazioni sugli indicatori facoltativi, consulta la pagina di riferimento gcloud monitoring snoozes list.

La risposta a questo comando è un elenco di nomi di posticipazioni nel progetto, formattato in YAML. Ad esempio, la risposta a questo comando per Il progetto Google Cloud con ID my-project è costituito da una singola voce:

criteria:
  policies:
  - projects/my-project/alertPolicies/12345
  - projects/my-project/alertPolicies/23451
displayName: Maintenance Week
interval:
  endTime: '2023-03-08T04:59:59Z'
  startTime: '2023-03-01T08:00:00Z'
name: projects/my-project/snoozes/98765

Per elencare i dettagli di una posticipazione specifica, esegui il comando gcloud monitoring snoozes describe:

gcloud monitoring snoozes describe NAME

Ad esempio, per visualizzare i dettagli della ripetizione con nome projects/my-project/snoozes/98765, esegui il seguente comando:

gcloud monitoring snoozes describe projects/my-project/snoozes/98765

Se fornisci un valore NAME non valido a un comando describe, la risposta contiene un codice di errore 500 e il seguente messaggio:

Internal error encountered. Please retry after a few seconds. If internal errors persist, contact support at https://cloud.google.com/support/docs.

Modifica una posticipazione

Puoi modificare il nome e il periodo di una spostamento programmata imminente, nonché il nome e l'ora di fine di una spostamento programmata attiva. Ad esempio, quando un periodo di manutenzione riprogrammata, potresti dover modificare una posticipazione.

Non puoi modificare una posticipazione precedente o i criteri di una posticipazione. Tuttavia, se vuoi pianificare una ripetizione passata per un periodo di tempo futuro, copia la ripetizione e applica le modifiche alla copia prima di selezionare Crea.

console

Per modificare una ripetizione:

  1. Nella console Google Cloud, vai alla pagina  Avvisi:

    Vai ad Avvisi

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Fai clic su Visualizza tutte le posticipazioni nel riquadro Posticipa.
  3. Nell'elenco delle posticipazioni, trova quella che vuoi modificare e poi Seleziona Modifica posticipazione nel menu Altre opzioni.
  4. Fai clic su Salva dopo aver completato le modifiche.

API Cloud Monitoring

Per modificare una ripetizione esistente, invoca il metodo snoozes.patch inviando una richiesta PATCH all'endpoint Snooze. Devi fornire l'oggetto snooze rivisto e includere che identificano i campi modificati. Quando utilizzi curl, parametri di ricerca devono essere codificati nell'URL.

Per le spostamenti programmati futuri, puoi modificare il nome e il periodo. Per attivi posticipi, puoi modificare il nome e l'ora di fine. Non puoi modificare precedenti posticipazioni.

Per aggiornare il displayName di una ripetizione, crea un file JSON,my-updated-snooze.json, che descriva l'oggetto ripetizione e aggiorna il nome visualizzato. Quindi, esegui il comando seguente:

curl -d @my-updated-snooze.json -H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-X PATCH https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes/${SNOOZE_ID}?updateMask=displayName

Il metodo restituisce un oggetto snooze identico al contenuti del file my-updated-snooze.json:

{
  "name": "projects/my-project/snoozes/2986665388391530496",
  "criteria": {
    "policies": [
      "projects/my-project/alertPolicies/7164333552684403347"
    ]
  },
  "interval": {
    "startTime": "2022-11-08T22:26:05Z",
    "endTime": "2022-11-08T22:31:05Z"
  },
  "displayName": "Updated snooze name"
}

Interfaccia a riga di comando gcloud

Per modificare una ripetizione, esegui il comando gcloud monitoring snoozes update. Puoi aggiornare il nome visualizzato, l'ora di inizio e l'ora di fine:

gcloud monitoring snoozes update NAME OPTIONAL_FLAGS

Per un elenco di opzioni per il comando update, consulta le Pagina di riferimento di gcloud monitoring snoozes update.

Ad esempio, per modificare il nome visualizzato della posticipazione con il nome projects/my-project/snoozes/98765, esegui questo comando:

gcloud monitoring snoozes update projects/my-project/snoozes/98765  --display-name="March Maintenance"

Terminare o annullare una ripetizione

Se vuoi ricevere notifiche per le risorse che corrispondono ai criteri specificati in una posticipazione attiva, termina la posticipazione. Ad esempio, quando la manutenzione pianificata viene completata più rapidamente del previsto, potresti voler terminare una posticipazione.

Se hai una spostamento programmata imminente che non vuoi più, annullala. L'operazione di annullamento imposta la durata su zero e determina la posticipazione passando allo stato Passato.

console

Per terminare una ripetizione attiva o annullare una ripetizione imminente:

  1. Nella console Google Cloud, vai alla pagina  Avvisi:

    Vai ad Avvisi

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Fai clic su Visualizza tutte le posticipazioni nel riquadro Posticipa.

  3. Nell'elenco delle posticipazioni, trova quella che vuoi terminare o annullare. quindi esegui una delle seguenti operazioni:

    • Per terminare una posticipazione attiva, seleziona Termina ora nel menu Altre opzioni.
    • Per annullare un posticipo imminente, seleziona Annulla posticipazione nella Menu Altre opzioni.

API Cloud Monitoring

Per terminare una posticipazione attiva, modificala e imposta l'ora di fine sull'ora corrente. Per ulteriori informazioni, vedi Modificare una posticipazione.

Per annullare una posticipazione imminente, modifica la posticipazione e imposta l'ora di fine su l'ora di inizio della posticipazione. L'ora di inizio deve essere una data futura. Per ulteriori informazioni, vedi Modificare una ripetizione.

Interfaccia a riga di comando gcloud

Per terminare una posticipazione attiva o annullare una posticipazione imminente, esegui il comando gcloud monitoring snoozes cancel:

gcloud monitoring snoozes cancel NAME

Ad esempio, per annullare la ripetizione con il nome projects/my-project/snoozes/98765, esegui il seguente comando:

gcloud monitoring snoozes cancel projects/my-project/snoozes/98765

Copia una posticipazione

Quando vuoi utilizzare una posticipazione esistente come modello per un altro posticipo, crea una copia. Quando copi una posticipazione, L'editor per posticipare la sveglia si apre con tutti i campi tranne l'ora di inizio sui valori nella posticipazione originale. Puoi modificare tutti i campi prima di fare clic su Crea.

Per copiare una ripetizione utilizzando la console:

  1. Nella console Google Cloud, vai alla pagina  Avvisi:

    Vai ad Avvisi

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Fai clic su Visualizza tutte le posticipazioni nel riquadro Posticipa.
  3. Nell'elenco delle posticipazioni, trova quella che vuoi modificare e poi seleziona Copia posticipazione nel menu Altre opzioni.
  4. Applica le modifiche alla copia e poi fai clic su Crea.

Passaggi successivi