Questo documento descrive come creare e gestire posticipa. La posticipazione impedisce a Cloud Monitoring creando incidenti e inviando notifiche durante una 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 l'API Cloud Monitoring.
Prima di iniziare
Assicurati di disporre delle autorizzazioni richieste:
-
Per ottenere le autorizzazioni necessarie per visualizzare e modificare le posticipazioni utilizzando la console Google Cloud , chiedi all'amministratore di concederti Ruolo IAM Editor Monitoring (
roles/monitoring.editor) per il progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.Potresti anche riuscire a ottenere le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.
-
Per ottenere le autorizzazioni necessarie per visualizzare e modificare le posticipazioni utilizzando l'API Cloud Monitoring , chiedi all'amministratore di concederti Ruolo IAM Monitoring Posticipa Editor (
roles/monitoring.snoozeEditor) per il progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.Potresti anche riuscire a ottenere le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.
Per ulteriori informazioni sui ruoli di Cloud Monitoring, consulta Controllare l'accesso con Identity and Access Management.
-
Se vuoi utilizzare gli esempi di API Cloud Monitoring in questo documento, procedi nel seguente modo:
Crea una variabile di ambiente,
PROJECT_ID, per conservare l'ID del tuo Progetto Google Cloud:PROJECT_ID=PROJECT_ID
Esegui l'autenticazione in Google Cloud CLI:
gcloud auth login
Imposta il progetto Google Cloud predefinito:
gcloud config set project ${PROJECT_ID}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
-
Nella console Google Cloud, vai alla notifications Pagina Avvisi:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
- Per creare una posticipazione da un incidente aperto:
- Nel riquadro Incidenti della pagina Avvisi, individua il tuo incidente e fai clic su Riepilogo incidente.
- Nella pagina Dettagli incidente, fai clic su Posticipa e seleziona la durata della posticipazione. Non puoi configurare altri campi.
In caso contrario, procedi nel seguente modo:
- Nella pagina Avvisi, fai clic su Crea posticipazione.
- Inserisci un nome descrittivo per la posticipazione. Questo nome viene mostrato nella Avvisi.
- Seleziona un'Ora di inizio. Puoi inserire un'ora specifica o avviare posticipa quando viene creata.
- Inserisci la Durata. Il valore di questo campo determina per quanto tempo il posticipo dura.
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.
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 Monitoring,
è l'unica differenza tra l'oggetto restituito e
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 posticipazione, 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 tempi assoluti o relativi. L'esempio seguente specifica
tempi assoluti. Per avviare una posticipazione di 30 minuti dall'ora attuale, utilizza
--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 intervallo di tempo dal 1° 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. A determinare il nome di un criterio di avviso, effettua 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. - Visualizzare 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 uno scheduler di job come
cron o Cloud Scheduler per eseguire lo script sul
programmazione.
Elenca posticipazioni
Quando crei una posticipazione, questa viene aggiunta al relativo registro storico. per il tuo progetto. Questo record mostra i dati scaduti, attivi e in programma posticipa. Non puoi rimuovere voci da questo record, ovvero non puoi eliminare un pisolino. Tuttavia, da questa visualizzazione puoi vedere i dettagli di una posticipazione e puoi eseguire azioni come modificare o copiare la posticipazione.
console
Per visualizzare un elenco di posticipazioni:
-
Nella console Google Cloud, vai alla notifications Pagina Avvisi:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
Fai clic su Visualizza tutte le posticipazioni nel riquadro Posticipa.
La pagina Posticipa mostra un elenco di posticipazioni e una sequenza temporale mostra graficamente le posticipazioni passate, imminenti e attive.
- Per modificare, copiare, annullare o terminare una posticipazione, utilizza il more_vert Menu Altre opzioni per posticipare la sveglia. Lo stato di ripetizione determina le opzioni disponibili.
- Per visualizzare un elenco di tutte le posticipazioni, attiva Mostra posticipazioni precedenti. Per impostazione predefinita, sono elencate le posticipazioni attive e in programma.
- 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 un posticipo specifico, 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 posticipazioni attive, espandi la riga Attiva della tabella Sequenza temporale.
API Cloud Monitoring
Per elencare tutte le posticipazioni che appartengono a un progetto Google Cloud, richiama il metodo
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 in un progetto è disponibile una posticipazione, la risposta al comando snoozes.list
è simile al 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 snoozes.get
e specificare l'ID progetto e l'ID posticipazione. Nella risposta precedente,
l'ID della 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 la
Comando gcloud monitoring snoozes list:
gcloud monitoring snoozes list OPTIONAL_FLAGS
Per informazioni sui flag facoltativi, consulta
gcloud monitoring snoozes list.
La risposta a questo comando è un elenco di nomi di posticipazioni nel progetto,
formattato come 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 relativi alla posticipazione con il nome
projects/my-project/snoozes/98765, esegui questo 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 la mestruazione di un posticipo imminente e puoi modificare nome e ora di fine di una posticipazione 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 per pianificare una posticipazione precedente per un periodo di tempo futuro, quindi copia la posticipazione e Applica le modifiche alla copia prima di selezionare Crea.
console
Per modificare una posticipazione:
-
Nella console Google Cloud, vai alla notifications Pagina Avvisi:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
- Fai clic su Visualizza tutte le posticipazioni nel riquadro Posticipa.
- Nell'elenco delle posticipazioni, trova quella che vuoi modificare e poi Seleziona Modifica posticipazione nel menu more_vert Altre opzioni.
- Fai clic su Salva dopo aver completato le modifiche.
API Cloud Monitoring
Per modificare una posticipazione esistente, richiama 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 i posticipi imminenti, puoi modificare il nome e il punto. Per attivi posticipi, puoi modificare il nome e l'ora di fine. Non puoi modificare precedenti posticipazioni.
Per aggiornare il valore displayName di una posticipazione, crea un file JSON:
my-updated-snooze.json, che descrive l'oggetto Posticipa e aggiorna il valore
il nome visualizzato. Quindi, esegui questo comando:
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 posticipazione, 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 posticipazione
Se vuoi ricevere notifiche per le risorse che soddisfano i criteri specificato in una posticipazione attiva, quindi termina la posticipazione. Ad esempio, quando vengono pianificati di manutenzione viene completata più rapidamente del previsto, potrebbe essere utile posticipare la sveglia.
Se hai un posticipo imminente che non vuoi più, annullalo. L'operazione di annullamento imposta la durata su zero e determina la posticipazione passando allo stato Passato.
console
Per terminare una posticipazione attiva o per annullare una posticipazione imminente:
-
Nella console Google Cloud, vai alla notifications Pagina Avvisi:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
- Fai clic su Visualizza tutte le posticipazioni nel riquadro Posticipa.
Nell'elenco delle posticipazioni, trova quella che vuoi terminare o annullare. ed esegui una delle seguenti operazioni:
- Per terminare una posticipazione attiva, seleziona Termina adesso nel more_vert Menu Altre opzioni.
- Per annullare un posticipo imminente, seleziona Annulla posticipazione nella more_vert Menu Altre opzioni.
API Cloud Monitoring
Per terminare una posticipazione attiva, modifica la posticipazione e imposta l'ora di fine su ora attuale. 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 posticipazione.
Interfaccia a riga di comando gcloud
Per terminare una posticipazione attiva o per annullare una posticipazione imminente, esegui il
Comando gcloud monitoring snoozes cancel:
gcloud monitoring snoozes cancel NAME
Ad esempio, per annullare la posticipazione con il nome
projects/my-project/snoozes/98765, esegui questo 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 posticipazione utilizzando la console, segui questi passaggi:
-
Nella console Google Cloud, vai alla notifications Pagina Avvisi:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
- Fai clic su Visualizza tutte le posticipazioni nel riquadro Posticipa.
- Nell'elenco delle posticipazioni, trova quella che vuoi modificare e poi seleziona Copia posticipazione nel menu more_vert Altre opzioni.
- Applica le modifiche alla copia, quindi fai clic su Crea.
Passaggi successivi
Per una panoramica degli avvisi, vedi Panoramica degli avvisi.
Per informazioni sulla latenza delle notifiche e su come le scelte per il di un criterio di avviso influiscono su quando vengono inviate le notifiche, consulta Comportamento dei criteri di avviso basati su metriche.
Per informazioni sugli incidenti, consulta i seguenti documenti: