Esta página descreve as alterações e as novas funcionalidades introduzidas no MongoDB Mongosync 1.17.
1.17.0 Versão
1 de outubro de 2025
Novas funcionalidades
Informações de métricas
A partir da versão 1.17, o mongosync registra métricas que contêm informações sobre o uso de CPU e memória do host como porcentagens do total de CPU e memória disponíveis. Ele também registra essas informações no nível de depuração.
/progress Informações da rede
mongosync 1.17 adiciona os campos source.pingLatencyMs e destination.pingLatencyMs à resposta do endpoint /progress.
Desativação automática do balanceador
A partir da versão 1.17, mongosync desativa o balanceador nos clusters de origem e destino durante a inicialização se detectar que os balancers não estão desabilitados.
Isso se aplica somente durante a inicialização. Se mongosync detectar que algum dos balanceador está ativado após o início da migração, mongosync falhará.
Depois de desativar o balanceador, mongosync aguarda 15 minutos para garantir que as migrações de chunk em andamento sejam concluídas antes de continuar com a migração.
Se a migração não for reversível e mongosync desabilitar o balanceador de origem ou destino durante a inicialização, após um commit bem-sucedido mongosync reativará o(s) balanceador(s) que ele(s) desativou. Se a migração for reversível, mongosync não reativará nenhum balancer para evitar que os usuários esperem 15 minutos.
IMPORTANTE: se mongosync desabilitar o balanceador para qualquer um dos clusters e depois falhar antes de confirmar, você deverá reativar o(s) balanceador(s) manualmente usando o balancerStart comando de banco de dados se não planeja executar mongosync novamente.
Melhorias no desempenho
Construir índices após a cópia da collection
mongosync 1.17 cria índices após a cópia da coleção por padrão, o que resulta em uma migração mais rápida para bancos de dados indexados. Para obter mais informações, consulte os parâmetros de solicitação de endpoint /start.
Problemas corrigidos
mongosynccria 90 chunks por shard de destino por padrão, em vez de 2 chunks.Corrige um bug no qual o verificador incorporado pode calcular incorretamente IDs internos para collections fragmentadas com chaves de shard que incluem vários pontos (
.).Remove o tempo limite de 6horas do verificador incorporado para o hash inicial. Isso reduz os erros de tempo limite para grandes coleções ou clusters lentos.
Corrige um bug raro em que o verificador não processava corretamente um evento de renomeação de coleção se estivesse usando a filtragem de namespace , levando a falhas repetidas que impediram a conclusão do processo de confirmação.
Outras alterações
mongosyncagora comprime arquivos de log quando os gira. A partir da versão 1.17, todos os arquivos além do arquivo de log atual são compactados usandogzip.mongosyncfalhará se houver uma janela de balanceamento configurada no cluster de origem ou destino.Artefatos de versão, como tarballs e arquivos zip, agora incluem um arquivo com um relatório SARIF no formato JSON. Este relatório contém os resultados da ferramenta de análise estática que
mongosyncexecuta para procurar problemas de segurança.mongosyncverifica se há escritas incorretas no cluster de origem durante o commit. Se alguma escrita no cluster de origem for detectada, a migração falhará.O verificador incorporado ativa a compactação de rede por padrão.
O endpoint /progress agora relata
canCommit: falseaté que o verificador esteja em um estado apropriado para commit.
Atualizações ao vivo
Atualizações em tempo real para 1.17 não são suportadas.
Versão mínima suportada
Para obter informações sobre as versões mínimas suportadas, consulte Compatibilidade de versão do MongoDB Server .
Para obter o melhor desempenho, atualize os clusters de origem e destino para a versão de patch mais recente do MongoDB Server antes da migração. Para obter mais informações, consulte Atualizar para a versão de patch autogerenciada mais recente do MongoDB.