Avançado
Janelas de Manutenção

Janelas de Manutenção

Janelas de Manutenção permitem programar períodos onde os alertas são suprimidos. Use para deployments planejados, migrações de banco de dados, atualizações de servidor e qualquer outra manutenção que possa causar indisponibilidade temporária.

Janelas de Manutenção estão disponíveis no plano STARTER ou superior.

Como funciona

Durante uma janela de manutenção:

  • Checks continuam rodando normalmente — o TheAlert não para de monitorar
  • Incidentes podem ser criados — o histórico é mantido fiel
  • Alertas são suprimidos — nenhuma notificação é enviada para integrações
  • Status Pages mostram o componente em modo de manutenção (opcional)

Quando a janela termina, o comportamento volta ao normal. Se o serviço ainda estiver DOWN ao final da janela, os alertas serão disparados normalmente.

⚠️

Se você esquecer de criar uma janela de manutenção antes de um deploy, pode cancelar alertas ativos manualmente nas configurações do incidente. Mas é muito melhor planejar com antecedência.

Criando uma janela de manutenção

  1. No menu lateral, acesse "Manutenção"
  2. Clique em "Nova Janela de Manutenção"
  3. Preencha os campos:

Nome

Descrição da manutenção para referência futura:

Deploy v2.5.0 — API Principal
Migração do banco de dados — PostgreSQL 14 → 16
Atualização do servidor de produção

Monitores afetados

Selecione os monitores que serão silenciados durante a janela. Você pode selecionar monitores individuais ou grupos inteiros.

Selecione apenas os monitores que serão realmente afetados pela manutenção. Manter outros monitores ativos garante que você saberá de problemas não relacionados à manutenção.

Data e hora de início

Informe quando a janela de manutenção começa. Use o horário local — o TheAlert converte para o fuso do seu workspace.

Data e hora de término

Informe quando os alertas devem voltar a funcionar. Seja generoso — é melhor criar uma janela maior do que precisar do que ter alertas disparando no meio de uma manutenção não concluída.

Salve

A janela fica agendada. Você pode ver todas as janelas pendentes na tela de Manutenção.

Exemplos de uso

Deploy com possível downtime

Nome: Deploy v3.0 — Migração de Schema
Monitores: API Principal, API de Autenticação
Início: 03/04/2026 02:00 BRT
Fim: 03/04/2026 03:30 BRT

Atualização de servidor

Nome: Atualização Ubuntu 22.04 → 24.04
Monitores: todos os monitores do servidor web-01
Início: 10/04/2026 00:00 BRT
Fim: 10/04/2026 04:00 BRT

Manutenção de banco de dados

Nome: Vacuum e Reindex PostgreSQL
Monitores: API Principal, API de Pedidos, API de Relatórios
Início: sábado, 15:00 BRT
Fim: sábado, 17:00 BRT

Janelas recorrentes

Para manutenções que acontecem regularmente (ex: toda segunda-feira de madrugada), crie uma janela recorrente configurando o padrão de recorrência:

  • Diária (todo dia no mesmo horário)
  • Semanal (mesmo dia da semana)
  • Mensal (mesmo dia do mês)

Status Page durante manutenção

Você pode configurar para que a Status Page exiba um banner de manutenção planejada para os visitantes:

⚙ Manutenção planejada
03/04/2026, 02:00–03:30 BRT
Deploy v3.0 — Migração de Schema

Isso previne que clientes entrem em pânico ao ver componentes em DEGRADED/DOWN e envia a mensagem de que você está no controle da situação.

Cancelar ou editar uma janela

Para cancelar ou modificar uma janela pendente:

  1. Manutenção → lista de janelas agendadas
  2. Clique na janela desejada
  3. Edite os detalhes ou clique em "Cancelar Janela"

Janelas em andamento também podem ser canceladas antecipadamente — os alertas voltam a funcionar imediatamente.

Histórico de manutenções

Todas as janelas de manutenção ficam registradas no histórico, junto com os monitores afetados e duração real. Isso é útil para:

  • Auditorias de disponibilidade
  • Cálculo de SLA (excluindo downtime planejado)
  • Análise de frequência de manutenções

Boas práticas

Crie a janela antes de iniciar a manutenção Idealmente, crie com 15-30 minutos de antecedência. Isso garante que a janela está ativa quando você começar.

Comunique na Status Page Para manutenções que afetam usuários, adicione a informação na Status Page com antecedência razoável (24-48 horas).

Seja generoso nos horários Se o deploy normalmente leva 20 minutos, crie uma janela de 60 minutos. Emergências acontecem.

Não abuse das janelas de manutenção Janelas de manutenção são para downtime planejado legítimo. Usá-las para suprimir alertas de problemas reais é contraproducente — você perde visibilidade de incidentes genuínos.

Próximos passos

Service MapThresholds de Alerta