Exploração madeireira
O mongosync mantém um registro de eventos em execução, incluindo entradas como coleções e índices de cópia, eventos de fluxo de alterações e chamadas de API.
Destino
mongosync
pode escrever mensagens de log em stdout ou em um arquivo.
Saída padrão
Por padrão, o mongosync
gera mensagens de registro para stdout:
$ mongosync --config /etc/mongosync.conf
Saída de exemplo:
{"level":"info","mongosyncID":"shard02","verbosity":"INFO","id":"shard02","port":27301,"time":"2022-06-21T11:15:33-04:00","message":"Mongosync Options"} {"level":"info","mongosyncID":"shard02","time":"2022-06-21T11:15:33-04:00","message":"Initialized client0 with URI: mongodb://192.0.2.1:27130 and client1 with URI: mongodb://192.0.2.2:27140."} {"level":"info","mongosyncID":"shard02","time":"2022-06-21T11:15:33-04:00","message":"Preflight checks completed."} {"level":"info","mongosyncID":"shard02","time":"2022-06-21T11:15:33-04:00","message":"Launch replication thread"}
Log to File
Para gerar mensagens de registro no arquivo, inicie mongosync
com a opção --logPath
ou defina a configuração logPath
no arquivo de configuração.
Ao fazer login no arquivo, mongosync
grava logs em um arquivo no diretório configurado. O diretório é criado se não existir. Se um arquivo mongosync.log
já existir no diretório, o mongosync
rotaciona os arquivos de log para preservar os logs antigos à medida que inicia um novo arquivo.
$ ls /var/log/mongosync
Por exemplo:
mongosync-2022-06-17T16-27-58.187.log mongosync.log mongosync-2022-06-21T13-31-42.668.log
O arquivo de log atualmente ativo é mongosync.log
. Os outros arquivos são registros mais antigos que mongosync
rotacionou.
Girar arquivo de log
Se você iniciar o mongosync
com a opção --logPath
, você poderá enviar um sinal do USR1
para o processo do mongosync
para girar seu arquivo de log:
kill -s USR1 $mongosync_pid
$mongosync_pid
é o ID do processo mongosync
.
Detalhamento
mongosync
suporta verbosidade definida pelo usuário para aumentar ou diminuir o nível de mensagens de registro mongosync
geradas.
O nível de verbosidade pode ser configurado utilizando a opção --verbosity
da linha de comando ou a configuração verbosity
no arquivo de configuração.
Formatar
mongosync
gera mensagens de registro em formato JSON estruturado. Cada mensagem de registro é um documento que contém os pares de valores-chave para essa entrada. As chaves rotulam os elementos da mensagem de registro, os valores são os eventos relatados.
Por exemplo:
{ "level": "info", "mongosyncID": "shard01", "componentName": "Change Event Application", "time": "2022-06-21T09:31:42-04:00", "message": "Starting change stream reader." }
Exemplos
Para visualizar mensagens de registro, verifique o arquivo mongosync.log
no diretório de registros. Você pode formatar o registro encaminhando seu conteúdo para jq
ou um comando semelhante:
$ cat /var/log/mongosync/mongosync.log | jq
Saída de exemplo:
{ "level": "info", "mongosyncID": "shard02", "verbosity": "INFO", "id": "shard02", "port":27301, "time": "2022-06-21T11:15:33-04:00", "message": "Mongosync Options" } { "level": "info", "mongosyncID": "shard02", "time": "2022-06-21T11:15:33-04:00", "message": "Initialized client0 with URI: mongodb://192.0.2.1:27130 and client1 with URI: mongodb://192.0.2.2:27140." } { "level": "info", "mongosyncID": "shard02", "time": "2022-06-21T11:15:33-04:00", "message": "Preflight checks completed." } { "level": "info", "mongosyncID": "shard02", "time": "2022-06-21T11:15:33-04:00", "message": "Launch replication thread" }