Você pode configurar instâncias demongosync do na inicialização utilizando opções de linha de comando ou um arquivo de configuração. O arquivo de configuração especifica valores para configurações que são equivalentes às opções de linha de comando mongosync.
Durante uma migração, é possível reconfigurar determinadas mongosync configurações do seguindo as etapas em Reconfigurar mongosync durante a sincronização.
Arquivo de configuração
Você pode escrever a maioria das opções de linha de comando mongosync em um arquivo YAML. O arquivo de configuração especifica valores para cada configuração usando o formato YAML.
Por exemplo:
cluster0: "mongodb://192.0.2.10:27017" cluster1: "mongodb://192.0.2.20:27017" logPath: "/var/log/mongosync" verbosity: "WARN"
Para usar um arquivo de configuração, inicie o mongosync com a opção --config para definir o caminho para o arquivo:
mongosync --config <configPath>
Configurações
Você pode definir as seguintes configurações do mongosync usando um arquivo de configuração.
Para configurar a mongosync partir da linha de comando, consulte Opções de linha de comando.
Observação
O comando start fornece opções adicionais para recursos como reversibility e user write blocking. Para obter mais detalhes, consulte a documentação da API start.
acceptDisclaimerTipo: bool
Aceita isenções de responsabilidade para o verificador incorporado.
Quando o processo
mongosynccomeça sem essa configuração, o usuário é solicitado a aceitar cada termo de responsabilidade.Esta configuração permite que os usuários que já leram e aceitaram isenções de responsabilidade aceitem o aviso e iniciem o processo
mongosync.Para definir a configuração
acceptDisclaimerna linha de comando, consulte a opção--acceptDisclaimer.Novidades na versão 1.9.
cluster0Tipo: string
Define o URI de conexão para o primeiro cluster. O primeiro cluster pode servir como origem ou destino no processo de sincronização. Designe os clusters de origem e de destino na chamada para o endpoint da API
start.Para obter mais informações sobre como conectar o
mongosync, consulte Conexões.Para definir a configuração
cluster0na linha de comando, consulte a opção--cluster0.
cluster1Tipo: string
Define o URI de conexão para o segundo cluster. O segundo cluster pode servir como origem ou destino no processo de sincronização. Designe os clusters de origem e de destino na chamada para o endpoint da API
start.Para obter mais informações sobre como conectar o
mongosync, consulte Conexões.Para definir a configuração
cluster1na linha de comando, consulte a opção--cluster1.
disableMetricsLoggingTipo: booleano
Novidades na versão 1.16.0.
Desativa o registro de métricas quando você executa o binário Mongosync.
AVISO: é altamente recomendável manter o registro de métricas ativado para facilitar a solução de problemas e o suporte eficazes.
Para obter mais informações, consulte Métricas do Mongosync.
Para definir a configuração
disableMetricsLoggingna linha de comando, consulte a opção--disableMetricsLogging.Para mais informações, consulte Coleta de Dados do Usuário.
disableTelemetryTipo: booleano
Novidades na versão 1,4,0.
Desabilita a collection de dados de telemetria para
mongosync.Por padrão, o
mongosynccoleta dados de uso agregados e anônimos para melhorar os produtos MongoDB. Ao executarmongosync, você pode desabilitar a coleta desses dados de telemetria.Para definir a configuração
disableTelemetryna linha de comando, consulte a opção--disableTelemetry.Para mais informações, consulte Coleta de Dados do Usuário.
disableVerificationTipo: booleano
Desabilita o Verificador incorporado. Quando desabilitado, o
mongosyncnão verifica a migração. Para métodos de verificação alternativos, consulte Verificar transferência de dados.Essa opção fornece uma solução alternativa para clientes que sofrem OOM kills ao executar
mongosynccom verificação e não podem alocar mais recursos ou tolerar reiniciar a verificação. Ele permite que a migração seja concluída com a verificação desativada. A verificação permanece desativada para reinicializações e reversões subsequentes.Esta opção não deve ser utilizada quando
mongosyncfor iniciado inicialmente. Em vez disso, desabilite a verificação com o parâmetro de solicitação /start,verification.enabled: falsepois a verificação está ativada por padrão.Para desativar a verificação na linha de comando, consulte a
--disableVerificationopção.Novidade na versão 1.10.
idTipo: string
Define um identificador para a instância
mongosync.Use esta configuração ao executar várias instâncias do
mongosyncem um cluster fragmentado, para sincronizar os fragmentos individualmente.O valor do identificador para esta configuração deve corresponder ao ID de fragmento do fragmento que ele sincroniza. Para localizar o ID de fragmento, utilize o comando
listShards.Para definir a configuração
idna linha de comando, consulte a opção--id.
loadLevelTipo: inteiro
Padrão:
3Define o nível de volume de trabalho do cluster para sincronizar dados entre os clusters de origem e destino:
4, a configuração mais alta, maximiza a carga de trabalho do cluster e sincroniza os dados mais rapidamente.1, a configuração mais baixa, minimiza o volume de trabalho do cluster e sincroniza os dados de forma mais lenta.
Para definir a configuração
loadLevelna linha de comando, consulte a opção--loadLevel.Aviso
Configurar
loadLevelmaior que o padrão de3pode afetar negativamente o desempenho do cluster de destino.Se houver gargalos de leitura no cluster de origem ou se houver gargalos de gravação no cluster de destino, diminuir
loadLevelpoderá melhorar o desempenho.Novidade na versão 1.4.
logPathTipo: string
Define o caminho para o diretório de logs. O Mongosync grava registros em arquivos neste diretório.
Para obter mais informações, consulte Registro de log.
Para definir a configuração
logPathna linha de comando, consulte a opção--logPath.
metricsLoggingFilepathTipo: string
Novidades na versão 1.16.0.
Define o caminho para o diretório de registro de métricas. O Mongosync grava registros de métricas em arquivos neste diretório.
Para obter mais informações, consulte Métricas do Mongosync.
Para definir a configuração
metricsLoggingFilepathna linha de comando, consulte a opção--metricsLoggingFilepath.
portTipo: inteiro
Padrão:
27182Define a porta usada pelo servidor HTTP para a API HTTP do Mongosync.
Para definir a configuração
portna linha de comando, consulte a opção--port.
verbosityTipo: string
Padrão:
DEBUGDefine o nível de verbosidade a ser usado em mensagens de registro. O Mongosync registra todas as mensagens no nível especificado e quaisquer mensagens em níveis inferiores.
A configuração
verbositysuporta os seguintes valores:TRACEDEBUGINFOWARNERRORFATALPANIC
Para definir a configuração
verbosityna linha de comando, consulte a opção--verbosity.
Reconfigurar mongosync durante a sincronização
Importante
Somente as seguintes configurações podem ser ajustadas durante uma migração. Outras configurações devem permanecer inalteradas entre mongosync reinicializações.
Enquanto mongosync estiver sincronizando, você pode reconfigurar as --config --disableTelemetryopções , , --loadLevel --logPath, --port, e --verbosity executando as seguintes etapas:
(Opcional) Pausar os mongosync processos
Execute em pause cada mongosync processo de em execução.
Você pode retomar os processos mongosync mais tarde a partir do estado de pausa, como mostrado na etapa final.
Dica
Se você não quiser retomar imediatamente as operações de sincronização de dados após a reconfiguração, considere pausar os processos mongosync. Isso é útil se você estiver coordenando operações de vários processos do mongosync.
(Opcional) Atualize seu arquivo de configuração
Se você utilizou a opção para definir o caminho para um arquivo de configuração quando inicializou pela --config primeira mongosync vez, atualize esse arquivo de configuração com o novo valor para cada configuração.
Inicialize os mongosync processos
Se você atualizou um arquivo de configuração na última etapa, inicialize os mongosync processos do com a opção definida para o caminho do arquivo de configuração --config atualizado:
mongosync --config <configPath>
Se você não utilizou a opção quando inicializou pela primeira vez --config mongosync o, inicialize os mongosync processos do com as opções de linha de comando definidas para seus valores atualizados:
mongosync \ --cluster0 "<cluster0_connection_string>" \ --cluster1 "<cluster1_connection_string>" \ --loadLevel <newLevel>
Para mais informações, consulte Inicializar mongosync.
Inicie ou retome os mongosync processos
Se você pausou algum mongosync processo anteriormente na primeira etapa opcional, execute resume nos mongosync processos pausados.
Se você interrompeu algum mongosync processo sem usar pause, execute start nos mongosync processos interrompidos. Para obter instruções mais detalhadas, consulte Migrar dados entre clusters.
mongosync retoma a sincronização aproximadamente onde estava antes de você interromper os processos anteriores. Todas as partições que estavam em andamento no momento do encerramento serão reiniciadas desde o início.