Uma vez por mês, o Looker (Google Cloud Core) programa períodos de manutenção durante os quais sua instância será atualizada. Durante um período de manutenção, sua instância será reiniciada, e você não poderá acessá-la temporariamente. É possível especificar uma janela de manutenção para sua instância na forma de um dia da semana e um horário em que a manutenção será realizada. Se você não especificar uma janela de manutenção preferida, os upgrades vão ocorrer em até duas semanas após o lançamento de uma nova versão do Looker (Google Cloud Core). Também é possível especificar um período de bloqueio de manutenção para impedir que a manutenção ocorra durante o período especificado.
Se você especificar um período de manutenção negado durante o upgrade das instâncias do Looker (Google Cloud Core) para a próxima versão compatível do Looker, os recursos disponíveis na sua instância do Looker (Google Cloud Core) poderão ser diferentes das configurações que o console Google Cloud informa estar disponível na versão atualizada.
Esta página de documentação explica como encontrar informações sobre a manutenção programada, definir uma janela preferencial para manutenção, especificar um período de bloqueio de manutenção e configurar notificações sobre as próximas atualizações de manutenção para uma instância do Looker (Google Cloud Core).
Canais de lançamento e políticas de manutenção
Se uma instância do Looker (Google Cloud Core) estiver inscrita em um canal de lançamento, as configurações de manutenção que você pode configurar vão depender do canal de lançamento da instância:
- Canal rápido: as janelas de manutenção e os períodos de manutenção negados não são compatíveis. Se você se inscrever no Canal rápido, todas as janelas de manutenção ou períodos de manutenção negados definidos anteriormente para a instância serão removidos.
- Canal normal: é possível especificar uma janela de manutenção preferencial e um período de bloqueio de manutenção.
- Nenhum canal: é possível especificar uma janela de manutenção preferencial e um período de bloqueio de manutenção.
Papel necessário
Para receber as permissões necessárias
para configurar as opções de manutenção de uma instância do Looker (Google Cloud Core),
peça ao administrador para conceder a você o papel do IAM de
Administrador do Looker (roles/looker.admin) no projeto em que a instância foi criada.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.
Configurações de manutenção
O Looker (Google Cloud Core) permite configurar atualizações de manutenção usando um conjunto de configurações.
É possível configurar a manutenção para ser programada em horários em que um breve período de inatividade causa o menor impacto na instância. É possível configurar o seguinte:
Janela de manutenção: o dia da semana e o horário em que o Looker (Google Cloud Core) programa a manutenção. As janelas de manutenção duram uma hora.
Período de bloqueio de manutenção: um intervalo de dias em que o Looker (Google Cloud Core) não programa manutenções. Os períodos de bloqueio de manutenção podem ser de até 60 dias. É preciso oferecer pelo menos 14 dias de disponibilidade de manutenção entre dois períodos de bloqueio de manutenção.
É possível atualizar as políticas de manutenção ao criar sua instância do Looker (Google Cloud Core) ou editar a configuração de uma instância atual.
Definir uma janela preferencial para manutenção
Para especificar uma janela preferencial em que o Looker (Google Cloud Core) vai programar a manutenção, selecione uma das seguintes opções:
Console
No console Google Cloud , crie uma instância do Looker (Google Cloud Core) ou edite a configuração de uma instância do Looker (Google Cloud Core).
Em Janela de manutenção, na seção Manutenção preferencial, configure as seguintes opções:
Dia: o dia da semana em que a instância será atualizada
Janela de tempo: a hora aproximada do dia em que a manutenção da instância vai começar
Clique em Salvar.
Se você tiver inscrito sua instância no canal de lançamento rápido, essa opção não estará disponível no console Google Cloud .
gcloud
Use o comando gcloud looker instances create se estiver criando a instância ou o comando gcloud looker instances update se estiver atualizando a instância e inclua os seguintes parâmetros:
--maintenance-window-day=MAINTENANCE_WINDOW_DAY --maintenance-window-time=MAINTENANCE_WINDOW_TIME
Substitua:
MAINTENANCE_WINDOW_DAY: o dia da semana em que a instância será atualizada. Precisa ser uma destas opções:friday,monday,saturday,sunday,thursday,tuesday,wednesday.MAINTENANCE_WINDOW_TIME: o horário de início da janela de manutenção no formato de 24 horas UTC (por exemplo,13:00,17:45).
Se você tiver inscrito uma instância do Looker (Google Cloud Core) no canal rápido do recurso de prévia canais de lançamento, não será possível definir uma janela de manutenção para essa instância.
Depois de especificar uma janela de manutenção, as mudanças na configuração vão levar até uma semana para entrar em vigor.
Configurar um período de manutenção de negação
Se você quiser adiar a manutenção programada para um horário posterior, mude o período de bloqueio de manutenção da instância. Um período de bloqueio de manutenção pode durar até 60 dias.
É preciso oferecer pelo menos 14 dias de disponibilidade de manutenção entre dois períodos de bloqueio de manutenção.
Para especificar uma janela preferencial em que o Looker (Google Cloud Core) não vai realizar a manutenção, selecione uma das seguintes opções:
Console
No console Google Cloud , crie uma instância do Looker (Google Cloud Core) ou edite a configuração de uma instância do Looker (Google Cloud Core).
Na seção Período de negação de manutenção, configure as seguintes opções:
Data de início: escolha a data de início do período em que a manutenção não vai ocorrer.
Data de término: escolha a data de término do período em que a manutenção não vai ocorrer.
Horário de início/término: defina o horário específico em que o Período de manutenção de negação começa (na data especificada para Data de início) e termina (na data especificada para Data de término).
- Clique em Salvar.
Se você tiver inscrito sua instância no canal de lançamento rápido, essa opção não estará disponível no console Google Cloud .
gcloud
Use o comando gcloud looker instances create se estiver criando a instância ou o comando gcloud looker instances update se estiver atualizando a instância e inclua os seguintes parâmetros:
--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
Substitua:
DENY_MAINTENANCE_PERIOD_START_DATE: a data de início do período de restrição no formatoYYYY-MM-DD.DENY_MAINTENANCE_PERIOD_END_DATE: a data de término do período de negação no formatoYYYY-MM-DD.DENY_MAINTENANCE_PERIOD_TIME: o horário de início e término no formato UTC de 24 horas (por exemplo,13:00,17:45).
Se você tiver registrado uma instância do Looker (Google Cloud Core) no canal rápido do recurso de prévia canais de lançamento, não será possível definir um período de manutenção negado para essa instância.
Exemplo de manutenção
Por exemplo, é possível definir as configurações de manutenção da instância de produção da seguinte maneira:
- Janela de manutenção: domingos entre 0h e 1h ET
- Período de bloqueio de manutenção: de 1º de dezembro às 22h até 15 de janeiro às 22h
Notificações de manutenções futuras
É possível receber uma notificação por e-mail sobre a manutenção futura até uma semana antes da manutenção ser programada. Se quiser definir um filtro de e-mail para notificações, o título do e-mail será [Notificação de manutenção avançada do Looker (Google Cloud Core)] Sua instância está programada para manutenção.
As notificações de manutenção não são enviadas por padrão. Se você quiser receber uma notificação sobre uma atualização de manutenção futura, siga estas etapas:
- Defina uma janela de manutenção.
- Ative as notificações de manutenção no nível do projeto ou configure alertas com base em registros.
- Para receber uma notificação sobre a manutenção programada, conclua as duas etapas pelo menos sete dias antes da próxima atualização de manutenção programada para sua instância do Looker (Google Cloud Core).
As notificações configuradas no console Google Cloud são enviadas para o endereço de e-mail associado à sua Conta do Google. É possível usar um alias de e-mail personalizado (como um alias de e-mail de equipe).
Se a instância do Looker (Google Cloud Core) usar SAML ou OpenID Connect (OIDC) para autenticação ou se você quiser encaminhar notificações para canais de comunicação de terceiros, como Slack, PagerDuty ou webhooks personalizados, configure alertas com base em registros.
É possível ativar as notificações de manutenção para todas as instâncias do Looker (Google Cloud Core) que têm janelas de manutenção em um determinado projeto. Você recebe uma notificação por instância.
Ativar as notificações de manutenção
Para ativar as notificações de manutenção no console do Google Cloud , siga estas etapas:
Acesse a página Comunicação no console do Google Cloud :
Selecione a guia Notificações de produtos.
Selecione seu projeto no menu suspenso.
Na linha do Looker (Google Cloud Core), defina a opção de e-mail como ATIVADA.
Configurar alertas baseados em registros para eventos de manutenção
Se você fizer a autenticação no Google Cloud usando a federação de identidade de colaboradores, o console Google Cloud não poderá enviar notificações de manutenção para suas contas federadas. Além disso, talvez você queira encaminhar notificações para serviços como Slack, PagerDuty ou webhooks personalizados. Para receber notificações nesses cenários, configure políticas de alertas com base em registros no Cloud Logging.
Quando o Looker (Google Cloud Core) agenda, inicia, conclui ou cancela uma atualização de manutenção, ele grava uma entrada de registro de atividades no Logging. É possível criar políticas de alerta que correspondam a essas entradas de registro e enviar notificações para os canais de notificação configurados.
Para criar um alerta com base em registros para um evento de manutenção, siga as instruções na documentação Criar uma política de alertas com base em registros usando a Análise de registros. Para exemplos de consultas a serem usadas na política, consulte Consultas de registro de manutenção.
Consultas de registros de manutenção
Use as consultas a seguir para criar alertas com base em registros para diferentes estágios do ciclo de vida da manutenção.
Substitua LOOKER_INSTANCE_NAME pelo nome da sua instância do Looker (Google Cloud Core).
Notificação antecipada (programada): notifica você quando a manutenção é programada para sua instância.
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ção de início: avisa quando a manutenção começa na sua instância.
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ção de conclusão (sucesso): avisa quando a manutenção termina com êxito.
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ção de falha ou cancelamento: avisa se a manutenção falhar ou for cancelada.
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"
Encontrar a manutenção programada
Se a manutenção tiver sido programada para sua instância, será possível visualizá-la seguindo estas etapas:
Acesse a página Looker (Google Cloud Core) no console Google Cloud .
Selecione o nome da instância em que você quer visualizar a manutenção programada.
Ao ver os detalhes da configuração da sua instância, na página Detalhes, você pode conferir as seguintes informações: