/ /

Registro

mongosync mantiene un registro en curso de eventos, incluyendo entradas como la copia de colecciones e índices, eventos de flujo de cambios y llamadas a API.

Destino

mongosync puede escribir mensajes de registro en la salida estándar o en un archivo.

Salida estándar

Por defecto, mongosync genera mensajes de registro en stdout:

$ mongosync --config /etc/mongosync.conf

Ejemplo de salida:

{"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"}

Registrar en archivo

Para generar los mensajes de registro en un archivo, inicie mongosync con la --logPath opción o establecer la logPath configuración en el archivo de configuración.

Al registrar en un archivo, mongosync escribe los registros en un archivo en el directorio configurado. El directorio se crea si no existe. Si ya existe un archivo mongosync.log en el directorio, mongosync rota las entradas de registro para preservar los registros antiguos al comenzar un archivo nuevo.

$ ls /var/log/mongosync

Por ejemplo:

mongosync-2022-06-17T16-27-58.187.log  mongosync.log
mongosync-2022-06-21T13-31-42.668.log

La entrada de registro actualmente activa es mongosync.log. Los otros archivos son registros más antiguos que mongosync ha rotado.

Rotar entrada de registro

Si se inicia mongosync con la opción --logPath, se puede enviar una señal USR1 al proceso mongosync para rotar la entrada de registro:

kill -s USR1 $mongosync_pid

$mongosync_pid es el ID de proceso mongosync.

nivel de verbosidad

mongosync admite un nivel de verbosidad definido por el usuario para aumentar o disminuir el nivel de mensajes de registro que mongosync produce.

El nivel de verbosidad puede establecerse mediante la opción --verbosity desde la línea de comandos o el ajuste verbosity en el archivo de configuración.

Formato

mongosync emite mensajes de registro en formato JSON estructurado. Cada mensaje de registro es un documento que contiene los pares de clave-valor para esa entrada. Las claves etiquetan los elementos del mensaje de registro, los valores son los eventos reportados.

Por ejemplo:

{
     "level": "info",
     "mongosyncID": "shard01",
     "componentName": "Change Event Application",
     "time": "2022-06-21T09:31:42-04:00",
     "message": "Starting change stream reader."
}

Ejemplos

Para ver los mensajes de registro, vérifique el archivo mongosync.log en el directorio de registros. Se puede formatear el registro canalizando su contenido a jq o a un comando similar:

$ cat /var/log/mongosync/mongosync.log | jq

Ejemplo de salida:

{
   "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"
}

Volver

Limitaciones

Métricas