Una volta al mese, Looker (Google Cloud core) pianifica periodi di manutenzione durante i quali viene eseguito l'upgrade dell'istanza. Durante un periodo di manutenzione, l'istanza viene riavviata e non potrai accedervi temporaneamente. Puoi specificare un periodo di manutenzione per l'istanza sotto forma di giorno della settimana e ora del giorno in cui verrà eseguita la manutenzione. Se non specifichi un periodo di manutenzione preferito, gli upgrade verranno eseguiti entro due settimane dal lancio di una nuova versione di Looker (Google Cloud core). Puoi anche specificare un periodo in cui evitare la manutenzione per impedire che la manutenzione venga eseguita durante il periodo specificato.
Se specifichi un periodo in cui evitare la manutenzione durante il quale viene eseguito l'upgrade delle istanze di Looker (Google Cloud core) alla versione di Looker supportata successiva, le funzionalità disponibili nell'istanza di Looker (Google Cloud core) potrebbero differire dalle impostazioni indicate dalla Google Cloud console come disponibili nella release aggiornata.
Questa pagina della documentazione illustra come trovare informazioni sulla manutenzione pianificata, impostare un periodo preferito per la manutenzione, specificare un periodo in cui evitare la manutenzione e configurare le notifiche relative agli aggiornamenti di manutenzione imminenti per un'istanza di Looker (Google Cloud core).
Canali di rilascio e policy di manutenzione
Se un'istanza di Looker (Google Cloud core) è registrata in un canale di rilascio, le impostazioni di manutenzione che puoi configurare dipendono dal canale di rilascio dell'istanza:
- Canale rapido: i periodi di manutenzione e i periodi in cui evitare la manutenzione non sono supportati. Se ti registri al canale rapido, tutti i periodi di manutenzione o i periodi in cui evitare la manutenzione impostati in precedenza per l'istanza verranno rimossi.
- Canale regolare: puoi specificare un periodo di manutenzione preferito e un periodo in cui evitare la manutenzione.
- Nessun canale: puoi specificare un periodo di manutenzione preferito e un periodo in cui evitare la manutenzione.
Ruolo richiesto
Per ottenere le autorizzazioni necessarie per configurare le impostazioni di manutenzione per un'istanza di Looker (Google Cloud core), chiedi all'amministratore di concederti il ruolo IAM Amministratore Looker (roles/looker.admin) sul progetto in cui è stata creata l'istanza.
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Impostazioni di manutenzione
Looker (Google Cloud core) consente di configurare gli aggiornamenti di manutenzione tramite un insieme di impostazioni di manutenzione.
Puoi configurare la manutenzione in modo che venga pianificata in orari in cui un breve periodo di inattività ha il minor impatto sull'istanza. Puoi configurare quanto segue:
Periodo di manutenzione: il giorno della settimana e l'ora in cui Looker (Google Cloud core) pianifica la manutenzione. I periodi di manutenzione durano un'ora.
Periodo in cui evitare la manutenzione: un blocco di giorni in cui Looker (Google Cloud core) non pianifica la manutenzione. I periodi in cui evitare la manutenzione possono durare fino a 60 giorni. Devi consentire almeno 14 giorni di disponibilità per la manutenzione tra due periodi in cui evitare la manutenzione.
Puoi aggiornare le policy di manutenzione quando crei l'istanza di Looker (Google Cloud core) o modificando la configurazione di un'istanza esistente.
Imposta un periodo preferito per la manutenzione
Per specificare un periodo preferito durante il quale Looker (Google Cloud core) pianificherà la manutenzione, seleziona una delle seguenti opzioni:
console
Nella Google Cloud console, crea un'istanza di Looker (Google Cloud core) o modifica la configurazione di un'istanza di Looker (Google Cloud core) esistente.
In Periodo di manutenzione, nella sezione Manutenzione preferita, configura le seguenti impostazioni per il periodo di manutenzione:
Giorno: il giorno della settimana in cui verrà aggiornata l'istanza
Finestra temporale: l'ora approssimativa del giorno in cui inizierà la manutenzione dell'istanza
Fai clic su Salva.
Se hai registrato l'istanza nel canale di rilascio rapido, questa opzione non sarà disponibile nella Google Cloud console.
gcloud
Utilizza il comando gcloud looker instances create se stai creando l'istanza o il comando gcloud looker instances update se stai aggiornando l'istanza e includi i seguenti parametri:
--maintenance-window-day=MAINTENANCE_WINDOW_DAY --maintenance-window-time=MAINTENANCE_WINDOW_TIME
Sostituisci quanto segue:
MAINTENANCE_WINDOW_DAY: il giorno della settimana in cui verrà aggiornata l'istanza. Deve essere uno dei seguenti:friday,monday,saturday,sunday,thursday,tuesday,wednesday.MAINTENANCE_WINDOW_TIME: l'ora di inizio del periodo di manutenzione nel formato UTC 24 ore (ad esempio,13:00,17:45).
Se hai registrato un'istanza di Looker (Google Cloud core) nel canale rapido della funzionalità di anteprima dei canali di rilascio, non potrai impostare un periodo di manutenzione per l'istanza.
Una volta specificato un periodo di manutenzione, le modifiche all'impostazione verranno applicate entro una settimana.
Configura un periodo in cui evitare la manutenzione
Se vuoi posticipare la manutenzione pianificata a un momento successivo, puoi modificare il periodo in cui evitare la manutenzione dell'istanza. Un periodo in cui evitare la manutenzione può durare fino a 60 giorni.
Devi consentire almeno 14 giorni di disponibilità per la manutenzione tra due periodi in cui evitare la manutenzione.
Per specificare un periodo preferito durante il quale Looker (Google Cloud core) non eseguirà la manutenzione, seleziona una delle seguenti opzioni:
console
Nella Google Cloud console, crea un'istanza di Looker (Google Cloud core) o modifica la configurazione di un'istanza di Looker (Google Cloud core) esistente.
Nella sezione Periodo in cui evitare la manutenzione, configura le seguenti impostazioni per il periodo in cui evitare la manutenzione:
Data di inizio: scegli la data di inizio del periodo durante il quale non verrà eseguita la manutenzione.
Data di fine: scegli la data di fine del periodo durante il quale non verrà eseguita la manutenzione.
Ora di inizio/fine: definisci l'ora specifica in cui inizia (nella data specificata per Data di inizio) e termina (nella data specificata per Data di fine) il periodo in cui evitare la manutenzione.
- Fai clic su Salva.
Se hai registrato l'istanza nel canale di rilascio rapido, questa opzione non sarà disponibile nella Google Cloud console.
gcloud
Utilizza il comando gcloud looker instances create se stai creando l'istanza o il comando gcloud looker instances update se stai aggiornando l'istanza e includi i seguenti parametri:
--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE
--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE
--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME
Sostituisci quanto segue:
DENY_MAINTENANCE_PERIOD_START_DATE: la data di inizio del periodo in cui evitare la manutenzione nel formatoYYYY-MM-DD.DENY_MAINTENANCE_PERIOD_END_DATE: la data di fine del periodo in cui evitare la manutenzione nel formatoYYYY-MM-DD.DENY_MAINTENANCE_PERIOD_TIME: l'ora di inizio e di fine nel formato UTC 24 ore (ad esempio,13:00,17:45).
Se hai registrato un'istanza di Looker (Google Cloud core) nel canale rapido della funzionalità di anteprima dei canali di rilascio, non potrai impostare un periodo in cui evitare la manutenzione per l'istanza.
Esempio di manutenzione
Ad esempio, puoi impostare le impostazioni di manutenzione dell'istanza di produzione come segue:
- Periodo di manutenzione: domenica tra le 00:00 e le 01:00 ET
- Periodo in cui evitare la manutenzione: dal 1° dicembre alle 22:00 al 15 gennaio alle 22:00
Notifiche di manutenzione imminente
Puoi ricevere una notifica via email relativa alla manutenzione imminente fino a una settimana prima della manutenzione pianificata. Se vuoi impostare un filtro email per le notifiche, il titolo dell'email è [Notifica di manutenzione avanzata di Looker (Google Cloud core)] La manutenzione della tua istanza è pianificata.
Le notifiche di manutenzione non vengono inviate per impostazione predefinita. Se vuoi ricevere una notifica relativa a un aggiornamento di manutenzione imminente, devi completare entrambi i seguenti passaggi:
- Imposta un periodo di manutenzione.
- Attiva le notifiche di manutenzione a livello di progetto o configura gli avvisi basati su log.
- Per ricevere una notifica relativa alla manutenzione pianificata, devi completare entrambi i passaggi almeno sette giorni prima del successivo aggiornamento di manutenzione pianificato per l'istanza di Looker (Google Cloud core).
Le notifiche configurate tramite la Google Cloud console vengono inviate all' indirizzo email associato al tuo Account Google. Puoi utilizzare un alias email personalizzato (ad esempio un alias email di gruppo).
Se l'istanza di Looker (Google Cloud core) utilizza SAML o OpenID Connect (OIDC) per l'autenticazione o se vuoi indirizzare le notifiche a canali di comunicazione di terze parti come Slack, PagerDuty o webhook personalizzati, puoi configurare gli avvisi basati su log.
Puoi attivare le notifiche di manutenzione per tutte le istanze di Looker (Google Cloud core) che hanno periodi di manutenzione in un determinato progetto. Riceverai una notifica per ogni istanza.
Attiva le notifiche di manutenzione
Per attivare le notifiche di manutenzione nella Google Cloud console:
Vai alla pagina Comunicazione nella Google Cloud console:
Seleziona la scheda Notifiche del prodotto.
Seleziona il tuo progetto dal menu a discesa.
Nella riga di Looker (Google Cloud core), imposta l'opzione di attivazione/disattivazione delle email su ON.
Configura gli avvisi basati su log per gli eventi di manutenzione
Se esegui l'autenticazione a Google Cloud utilizzando la federazione delle identità della forza lavoro, la Google Cloud console non può inviare notifiche di manutenzione ai tuoi account federati. Inoltre, potresti voler indirizzare le notifiche a servizi come Slack, PagerDuty o webhook personalizzati. Per ricevere notifiche in questi scenari, puoi configurare le policy di avviso basate su log in Cloud Logging.
Quando Looker (Google Cloud core) pianifica, avvia, completa o annulla un aggiornamento di manutenzione, scrive una voce di log delle attività in Logging. Puoi creare policy di avviso che corrispondano a queste voci di log e inviare notifiche ai canali di notifica configurati.
Per creare un avviso basato su log per un evento di manutenzione, segui le istruzioni riportate nella documentazione Creare una criterio di avviso basata su log utilizzando Esplora log per creare una criterio di avviso. Per esempi di query da utilizzare nella policy, consulta Query dei log di manutenzione.
Query dei log di manutenzione
Utilizza le seguenti query per creare avvisi basati su log per le diverse fasi del ciclo di vita della manutenzione.
Sostituisci LOOKER_INSTANCE_NAME con il nome dell'istanza di Looker (Google Cloud core).
Notifica anticipata (pianificata): ti avvisa quando la manutenzione è pianificata per la tua istanza.
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND labels.activity_type_name = "LookerRolloutAdvanced" AND labels.instance_id = "LOOKER_INSTANCE_NAME"Notifica di avvio: ti avvisa quando inizia la manutenzione dell' istanza.
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND labels.activity_type_name = "LookerRolloutInProgress" AND labels.is_completed = "false" AND labels.is_failed = "false" AND labels.instance_id = "LOOKER_INSTANCE_NAME"Notifica di completamento (riuscita): ti avvisa quando la manutenzione viene completata correttamente.
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND labels.activity_type_name = "LookerRolloutInProgress" AND labels.is_completed = "true" AND labels.is_failed = "false" AND labels.instance_id = "LOOKER_INSTANCE_NAME"Notifica di errore o annullamento: ti avvisa se la manutenzione non riesce o viene annullata.
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND (labels.is_failed = "true" OR labels.activity_type_name = "LookerRolloutCanceled") AND labels.instance_id = "LOOKER_INSTANCE_NAME"
Trova la manutenzione pianificata
Se è stata pianificata la manutenzione per la tua istanza, puoi visualizzarla seguendo questi passaggi:
Vai alla pagina Looker (Google Cloud core) nella Google Cloud console.
Seleziona il nome dell'istanza per cui vuoi visualizzare la manutenzione pianificata.
Quando visualizzi i dettagli di configurazione dell'istanza, nella pagina Dettagli puoi visualizzare le seguenti informazioni: