Você pode definir a hora do dia em que o Atlas deve iniciar a manutenção semanal em seu cluster. Esta configuração é opcional e não é exigida para a maioria dos clusters. Configure as janelas de manutenção a partir das configurações do projeto.
Normalmente, você não precisa configurar manualmente uma período de manutenção. O Atlas realiza a manutenção automaticamente de forma contínua para preservar a disponibilidade contínua de aplicativos resilientes. Você pode usar o recurso Testar Failover para garantir que seu aplicação seja resiliente às eleições do conjunto de réplicas.
Configurar períodos de manutenção oferece mais controle sobre o agendamento da manutenção, permitindo que a manutenção que requer eleições de conjunto de réplicas ocorra no horário do dia de sua preferência, e que outras atualizações padrão ocorram fora do horário comercial crítico.
Importante
Você configura janelas de manutenção no nível do projeto e elas se aplicam somente a Clusters dedicados (M10 e superior). Para clusters gratuitos e clusters flexíveis, o Atlas gerencia suas janelas de manutenção automaticamente e você não pode configurá-las manualmente.
Considerações sobre a janela de manutenção
Atividades de manutenção urgentes: o Atlas pode realizar atividades de manutenção urgentes (como patches de segurança para vulnerabilidades de dia zero) assim que necessário, sem levar em conta as janelas de manutenção configuradas ou as horas protegidas.
Operações de manutenção contínuas: depois de agendar uma período de manutenção para o cluster, você não poderá alterá-la até que as operações de manutenção contínuas sejam concluídas.
Atualizações do banco de dados MongoDB: Se a manutenção incluir uma atualização de versão do patch MongoDB , o Atlas exibirá as versões atual e de destino no console. Se o Atlas atualizar a versão de manutenção do MongoDB em um dos seus clusters durante a próxima período de manutenção, o cartão do cluster exibirá a versão de manutenção do MongoDB alvo.
A manutenção requer eleições de conjunto de réplicas: o Atlas executa a manutenção da mesma forma que o procedimento de manutenção descrito no Manual do MongoDB. Esse procedimento requer pelo menos uma eleição de conjunto de réplicas durante a período de manutenção por conjunto de réplicas. Use o recurso Failover de teste para garantir que seu aplicação seja resiliente às eleições do conjunto de réplicas.
A manutenção começa o mais próximo possível do início da janela: a manutenção sempre começa o mais próximo possível do horário agendado, mas atualizações de cluster em andamento ou problemas inesperados do sistema podem atrasar o horário de início.
Potencial para breve degradação de desempenho durante a manutenção: se você tiver baixo IOPS de disco, seu cluster poderá sofrer uma breve degradação de desempenho durante a manutenção enquanto o MongoDB repreenche o mecanismo de armazenamento WiredTiger . Para saber mais, consulte Journaling e o WiredTiger Storage Engine.
Horas protegidas: além de configurar uma período de manutenção, é possível definir horas protegidas diárias, que é uma janela de tempo durante a qual o Atlas evita realizar atualizações padrão. O Atlas executa manutenção automaticamente durante a período de manutenção.
No entanto, o Atlas pode executar atualizações padrão que não envolvem a reinicialização de um cluster ou impacto o desempenho do volume de trabalho fora da período de manutenção. Quando você ativa as horas protegidas, o Atlas executa atualizações padrão fora da janela de horas protegidas. A duração da sua janela de horas protegidas não pode exceder 18 horas.
Tipos de operação de manutenção programadas
O modal Scheduled Maintenance Operations pode exibir um ou mais dos seguintes tipos de manutenção:
Manutenção necessária do MongoDB : operações de manutenção críticas necessárias para a saúde e a estabilidade do cluster.
Atualização da versão do MongoDB : atualizações para versões de patch do MongoDB ou versões de manutenção.
Atualização da versão da política do sistema operacional: atualizações para as políticas subjacentes do sistema operacional e patches de segurança.
Outra operação de manutenção: atividades de manutenção adicionais necessárias para o gerenciamento do cluster.
Acompanhar conclusão da manutenção
Você verá um evento Maintenance window completed em seu Feed de atividades do projeto quando as operações de manutenção forem concluídas.
Ativar adiamento automático para futuras janelas de manutenção
Quando você habilita a opção Automatically defer maintenance for one week, o Atlas adia automaticamente a manutenção agendada futura em uma semana de cada vez. Isso significa que a manutenção é efetivamente executada a cada duas semanas em vez de semanalmente, uma vez que a primeira semana é automaticamente adiada em todas as vezes. Se necessário, você ainda pode adiar manualmente a manutenção mais uma vez.
Importante
Se você habilitar a Automatically defer maintenance for one week opção, o Atlas configurará o adiamento automático para futuras janelas de manutenção. Para adiar a manutenção agendada atualmente, use a Defer 1 Week opção, conforme descrito na seção Adiar manutenção.
O adiamento automático permite:
Reduzir a frequência de manutenção: configure o adiamento automático uma vez para espaçar as operações de manutenção para que ocorram a cada duas semanas, em vez de semanalmente.
Atualizações em lote: Consolide as operações de manutenção em uma única período de manutenção e reduza o número total de eventos de manutenção.
Teste primeiro em ambientes inferiores: configure o auto-defer em ambientes de produção e permita que a manutenção seja executada semanalmente em desenvolvimento ou preparação. Isso lhe dá tempo para validar as atualizações antes que elas cheguem à produção.
Para ativar o diferimento automático, consulte a seção Visualizar e configurar a janela de manutenção.
Acesso necessário
Para gerenciar janelas de manutenção, você deve ter acesso Organization Owner ou Project Owner ao projeto.
Procedimento
Abra as configurações do seu projeto
No Atlas, vá para a página Project Settings.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Na barra lateral, clique em Project Settings.
A página Configurações do projeto é exibida.
Exibir e configurar janela de manutenção
Para exibir e configurar o período de manutenção usando a IU do Atlas:
Clique no botão Set Maintenance Window para exibir as configurações do período de manutenção.
Defina o dia e a hora em que você deseja que o Atlas inicie a manutenção do seu projeto.
Se você quiser que o Atlas adie automaticamente por uma semana qualquer manutenção programada, clique em Automatically defer maintenance for one week.
A ativação dessa opção configura o adiamento automático para futuras janelas de manutenção. Para adiar a manutenção programada no momento, use o botão Defer 1 Week.
Para definir um intervalo de horas protegidas em que o Atlas evita executar atualizações padrão, alterne a configuração Turn on protected hours para On. Você pode definir um intervalo máximo de 18 horas por dia.
Clique em Save para manter suas alterações ou clique em Cancel para descartá-las.
Para retornar os detalhes da janela de manutenção utilizando o Atlas CLI, execute o seguinte comando:
atlas maintenanceWindows describe [options]
Para atualizar a janela de manutenção utilizando o Atlas CLI, execute o seguinte comando:
atlas maintenanceWindows update [options]
Para saber mais sobre a sintaxe e os parâmetros dos comandos anteriores, consulte a documentação da CLI do Atlas para manutenção do atlasWindows e manutenção do atlasAtualização do Windows.
Limpe as configurações da janela de manutenção
Se você configurou um tempo de início da janela de manutenção preferencial, você poderá limpar as configurações utilizando o Atlas CLI ou a UI do Atlas. Limpar a configuração da janela de manutenção restaura as configurações da janela de manutenção padrão.
Para limpar o período de manutenção configurada usando a interface do Atlas, alterne a configuração Set Maintenance Window para Off.
Para limpar a janela de manutenção configurada utilizando o Atlas CLI, execute o seguinte comando:
atlas maintenanceWindows clear [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação do Atlas CLI para limpar atlas maintenanceWindows.
Responda à manutenção necessária
Quando a manutenção é necessária:
Entre 48 e 72 horas (2a3 dias) antes da manutenção programada, o Atlas exibe um banner na lista de cluster do seu projeto mostrando a data e a hora em que a manutenção está programada. Clique em Show Details para ver as operações de manutenção agendadas, como atualizações de versão do MongoDB , atualizações de políticas do sistema operacional ou outros tipos de manutenção.
O Atlas envia um e-mail aos usuários com a
Project Ownerfunção e atualiza a UI do Atlas para exibir a opção de iniciar a manutenção imediatamente ou de adiar a manutenção por uma semana.Observação
Para configurar como você recebe notificações de janela de manutenção agendada, consulte Configurar um alerta de janela de manutenção.
Iniciar manutenção agora
Para iniciar a manutenção imediatamente:
No banner de manutenção, clique em Show Details. Uma janela modal intitulada Scheduled Maintenance Operations aparece, mostrando a data e a hora agendadas juntamente com os tipos de operações de manutenção planejadas.
No modal Scheduled Maintenance Operations, clique no botão Begin Now. No modal de confirmação Start Cluster Maintenance Now, confirme clicando em Yes, start my maintenance now.
Para atualizar a janela de manutenção utilizando o Atlas CLI, execute o seguinte comando:
atlas maintenanceWindows update [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação da Atlas CLI para atualizar o maintenanceWindows do Atlas.
IMPORTANTE: Para trigger a manutenção imediatamente, passe a opção --startASAP.
# Trigger immediate maintenance for the project with the ID # 5e2211c17a3e5a48f5497de3: atlas maintenanceWindows update --startASAP --projectId 5e2211c17a3e5a48f5497de3 --output json
O Atlas fornece o ponto de extremidade Atualizar um período de manutenção para um projeto. Você pode trigger a manutenção imediatamente passando o campo startASAP opcional com um valor de true.
curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \ --digest --include \ --header "Accept: application/vnd.atlas.2025-03-12+json" \ --header "Content-Type: application/json" \ -X PATCH "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/maintenanceWindow" \ --data ' { "startASAP": true }'
Adiar manutenção
Use o procedimento a seguir para adiar a manutenção programada atualmente em uma semana. Para adiar automaticamente toda a manutenção futura, habilite o adiamento automático.
Observação
Você pode adiar um único evento de manutenção do projeto até duas vezes.
Para adiar a manutenção programada:
No banner de manutenção, clique em Show Details. Uma janela modal intitulada Scheduled Maintenance Operations aparece, mostrando a data e a hora agendadas juntamente com os tipos de operações de manutenção planejadas.
No modal Scheduled Maintenance Operations, clique no botão Defer 1 Week. No modal de confirmação Defer Maintenance to Next Week, confirme clicando em Yes, defer maintenance until next week.
Observação
Você pode adiar um único evento de manutenção do projeto até duas vezes.
Para adiar a janela de manutenção utilizando o Atlas CLI, execute o seguinte comando:
atlas maintenanceWindows defer [options]
Para saber mais sobre a sintaxe e os parâmetros do comando, consulte a documentação do Atlas CLI para adiar atlas maintenanceWindows.
O Atlas fornece o ponto de extremidade Adiar um período de manutenção para um projeto.
Observação
Você pode adiar um único evento de manutenção do projeto até duas vezes.