Docs Menu
Docs Home
/
MongoDB Ops Manager
/

Ver, recuperar y administrar registros

Ops Manager recopila información de los registros tanto de los procesos de MongoDB como de sus agentes. Para los procesos de MongoDB, puedes acceder tanto a los registros en tiempo real como a los registros en disco.

El Agente de MongoDB emite el comando getLog con cada ping de supervisión. Este comando recopila las entradas de registro de la caché RAM de cada proceso de MongoDB.

Ops Manager habilita la recopilación de registros en tiempo real de forma predeterminada. Puede deshabilitar la recopilación de registros para todas las implementaciones de MongoDB en un proyecto de Ops Manager o para implementaciones individuales de MongoDB. Si deshabilita la recopilación de registros, Ops Manager seguirá mostrando las entradas de registro recopiladas previamente.

Para acceder a esta función, debe tener privilegios otorgados por uno de los siguientes roles:

  • Project Automation Admin

  • Project Backup Admin

  • Project Monitoring Admin

  • Project Owner

1
  1. Si aún no se muestra, se debe seleccionar la organización que contiene el proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no se muestra, se debe seleccionar el proyecto deseado en el menú Projects de la barra de navegación.

  3. Si aún no se muestra, haga clic en Deployment en la barra lateral.

  1. Haga clic en la vista Clusters.

2

Los cuatro botones se enumeran en el siguiente orden, de izquierda a derecha: Shards, Configs, Mongos y BIs.

Proceso
Muestra

Shards

Procesos mongod que alojan tus datos.

Configs

Procesos mongod que se ejecutan como servidores de configuración para almacenar los metadatos de un clúster particionado.

Mongos

Procesos mongos que enrutan datos en un clúster particionado.

BIs

Procesos de BI que acceden a datos en un clúster particionado.

3
4

La pestaña muestra información de registro.

5
1
  1. Si aún no se muestra, se debe seleccionar la organización que contiene el proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no se muestra, se debe seleccionar el proyecto deseado en el menú Projects de la barra de navegación.

  3. Si aún no se muestra, haga clic en Deployment en la barra lateral.

  1. Haga clic en la vista Clusters.

2
3
  1. Haz clic en la pestaña Logs.

  2. Cambie de Collect Logs For Host a Off o On, según lo desee.

4

Si desactiva la recopilación de registros, las entradas de registro existentes permanecen en la pestaña Logs, pero Ops Manager no recopila entradas nuevas.

1
2

Ops Manager recopila registros en disco incluso si la instancia de MongoDB no se está ejecutando. El Agente de MongoDB recopila los registros desde la ubicación especificada en la systemLog.path opción de configuración de MongoDB. Los registros en disco de MongoDB son un subconjunto de los registros en tiempo real y, por lo tanto, menos detallados.

Puede configurar la rotación de registros en disco. Ops Manager rota los registros de forma predeterminada.

Este procedimiento rota los registros del sistema y de auditoría para Ops Manager.

Para acceder a esta función, debe tener privilegios otorgados por uno de los siguientes roles:

1

Haga ... clic en el íconode puntos suspensivos en la línea de cualquier proceso, conjunto de réplicas o clúster fragmentado en el proyecto y luego haga clic Request Logs en.

2

Para seleccionar los registros que desea descargar, realice las siguientes acciones:

Acción
Propósito

Haga clic MongoDB Logs

Recopilar registros de los procesos MongoDB implementados.

Esta opción no está disponible para los procesos MongoDB implementados si la propiedad systemLog.destination está establecida syslog en.

Haga clic FTDC Data

Recopilar los archivos de datos de diagnóstico del mecanismo de recopilación(FTDC), como estadísticas del servidor y mensajes de estado.

Haga clic Automation Agent Logs

Recopilar registros de los agentes de automatización implementados.

Haga clic Backup Agent Logs

Recopilar registros de todos los agentes de respaldo implementados.

Esto difiere de otros registros. Los registros recopilados no se limitan a los hosts seleccionados, sino que incluyen todos los registros del Agente de Backup en la implementación.

Haga clic Monitoring Agent Logs

Recopilar registros de todos los agentes de monitoreo implementados.

Esto difiere de otros registros. Los registros recopilados no se limitan a los hosts seleccionados, sino que incluyen todos los registros del Agente de Monitoreo en la implementación.

Establecer Size per Log Type en MB

Introduzca el tamaño máximo acumulativo sin comprimir en megabytes de todos los archivos de registro seleccionados.

  • Este límite es acumulativo.

    • Para los registros de MongoDB o FTDC, esto limita el tamaño de los registros recopilados por proceso.

    • Para los agentes, esto limita el tamaño de los registros relacionados por agente.

  • Posteriormente, dichos archivos de registro se archivan y comprimen.

    Por ejemplo, si establece este valor en 50 MB, Ops Manager recopila un total de 50 MB de archivo de registro sin comprimir de cada proceso y y de cada agente para todos los registros que elija mongod mongos descargar.

  • Si el archivo de registro actual es menor que el tamaño especificado, Ops Manager también recopila el archivo rotado más reciente.

  • Si el tamaño total de las entradas de registro alcanza el tamaño especificado a la mitad de una entrada de registro, esta última entrada de registro se trunca hasta la línea más reciente que se encuentra dentro del tamaño especificado.

  • La cantidad máxima de entradas de registro que se pueden recopilar es de 20 GB. Este máximo incluye todas las entradas de registro recopiladas que no hayan caducado. Si solicitas registros adicionales y al recopilar esos registros se superan los 20 GB de registros recopilados, Ops Manager genera un error. La cantidad total de registros recopilados en comparación con el límite se muestra como Estimated Total Size.

Ejemplo

Elige recopilar 20 MB de registros de todos los procesos en un conjunto de réplicas. Este conjunto de réplicas tiene tres procesos mongod en dos hosts:

  • host1:27017

  • host2:27017

  • host2:27018

Su implementación ejecuta los siguientes agentes:

agente de automatización

host1, host2, host4, host5

agente de copias de seguridad

host4

Agente de supervisión

host4, host5

Cuando elige todos los tipos de registro para este conjunto de réplicas y limita a 20 MB por proceso, Ops Manager muestra que Estimated Total Size es 220 MB (11 procesos * 20 MB) de 20 GB.

Una vez iniciada la recopilación de registros, Ops Manager escanea los directorios de registros en busca de los mongod procesos y su FTDC asociado, desde la entrada de registro más reciente hasta 20 MB de archivos de registro o hasta el final del último registro recopilado. También se escanean todos los agentes de monitorización y backup de la implementación.

  • El agente de respaldo tiene 60 MB de registros.

  • Cada proceso MongoDB3 () tiene 7 MB de registros más 15 MB de datos FTDC por proceso.

  • Cada agente de monitoreo (2) tiene 30 MB de registros.

  • Cada agente de automatización (2) tiene 12 MB de registros.

El tamaño total de los registros recopilados es 150 MB:

(20 + (3 * (7 + 15)) + (2 * 20) + (2 * 12)) = 150

  • Se recopila un máximo de 20 MB de registros del agente de respaldo.

  • Se recopilan todos los registros de cada proceso7 de MongoDB: MB de MongoDB + 15 MB de datos de FTDC.

  • Se recopila un máximo de 20 MB de registros de cada agente de supervisión.

  • Se recopilan todos los registros del agente host1 host2 host4 de host5 automatización dey. y no alojan ningún proceso en el conjunto de réplicas.

La estructura del archivo resultante dentro del archivo descargado es:

host1/27017/mongodb
host1/27017/ftdc
host1/automation_agent
host2/27017/mongodb
host2/27017/ftdc
host2/27018/mongodb
host2/27018/ftdc
host2/automation_agent
host4/backup_agent
host4/monitoring_agent
host5/monitoring_agent
3

Para anonimizar sus registros, seleccione Replace IP addresses, hostnames, namespaces, strings with randomized values.

Esta opción sustituye las direcciones IP por un rango privado (192.168.x.x). Para nombres de host, esta opción sustituye solo FQDN. Otros nombres de host permanecen sin cambios. Los reemplazos siguen un patrón predecible. Por ejemplo, si blue.strawberry sustituye una instancia del FQDN test.internal, blue.strawberry sustituye todas las demás instancias de test.internal también.

Nota

Esto no utiliza la canalización de agregación $redact. Se trata de una función independiente con un conjunto más amplio de funciones.

4
5

El estado de entrada muestra Collecting Logs... y actualiza automáticamente su estado a medida que continúa la recopilación de registros.

  • Si Ops Manager no puede recuperar los archivos de registro, haga clic en Retry para recuperar nuevamente los archivos de registro fallidos.

  • Si se ha producido un error, aún puede descargar el archivo. Faltarán algunos de los archivos de registro solicitados.

6

Hacer clic en Download icon.

El tamaño del archivo que aparece en la página Log Request History es el tamaño sin comprimir. El archivo consume esa cantidad de espacio en disco en el host de destino una vez extraído.

Esta descarga solo se puede reiniciar, no reanudar. Si falla, deberá volver a descargar los registros.

El archivo se llama mongodb-logfiles_<instance_or_process>_<ISO8601_Format_Date>.tar.gz.

Los archivos extraídos utilizan la siguiente estructura de directorio:

<host>
automation_agent
automation-agent-verbose.log
automation-agent-verbose.log.<ISO8601_Format_Date>
backup_agent
backup-agent-verbose.log
backup-agent-verbose.log.<ISO8601_Format_Date>
monitoring_agent
monitoring-agent-verbose.log
monitoring-agent-verbose.log.<ISO8601_Format_Date>
<replica_set> // Sharded Cluster Only
<port>
ftdc
metrics.<ISO8601_Format_Date>
metrics.interim
mongodb
mongodb.log
mongodb.log.<ISO8601_Format_Date>
<port> // Replica Set or Standalone
ftdc
metrics.<ISO8601_Format_Date>
metrics.interim
mongodb
mongodb.log
mongodb.log.<ISO8601_Format_Date>

Los registros recopilados caducan y se eliminan después de 7 días. Para prolongar la vida útil de una entrada de registro específica, haz clic en el enlace extend de ese fichero en la página Log Request History.

Ops Manager puede rotar y comprimir los registros de los clústeres administrados por el Agente de MongoDB. Si el Agente de MongoDB solo supervisa un clúster, ignora sus registros.

Importante

Si está ejecutando MongoDB Enterprise versión 5.0 o posterior y MongoDB Agent 11.0.13.7055 o posterior, puede:

  • Establezca reglas separadas para rotar los registros del servidor y los registros de auditoría.

  • Comprima y elimine los registros de auditoría con Ops Manager. Por seguridad, recomendamos gestionar la compresión y eliminación de los registros de auditoría fuera de Ops Manager.

Si está ejecutando versiones anteriores de MongoDB Enterprise o MongoDB Agent, Ops Manager:

  • Utiliza su configuración System Log Rotation para rotar tanto los registros del servidor como los registros de auditoría.

  • No comprime ni elimina los registros de auditoría. Si configura la compresión y la eliminación, Ops Manager aplica esta configuración solo a los registros del servidor.

Los usuarios de la comunidad MongoDB pueden rotar, comprimir y eliminar únicamente los registros del servidor.

Nota

Al usar esta función, deshabilite cualquier servicio de rotación de registros basado en la plataforma, como logrotate. Elimine los indicadores reopen y rename de los archivos de configuración del proceso. Si el agente de MongoDB solo supervisa el clúster, este podría usar servicios basados ​​en la plataforma.

1
  1. Haga clic en Deployment.

  2. En la lista desplegable More, haga clic en MongoDB Log Settings.

2

Cambie de System Log Rotation a ON para rotar los registros del servidor.

Los usuarios de MongoDB Enterprise que ejecutan MongoDB Enterprise versión 5.0 o posterior y MongoDB Agent 11.0.13.7055 y posterior también pueden alternar Audit Log Rotation a ON para rotar los registros de auditoría y configurar la rotación de los registros de auditoría por separado.

Si está ejecutando versiones anteriores de MongoDB Enterprise o MongoDB Agent, configurar System Log Rotation en ON también rota los registros de auditoría.

Establezca la rotación de registros en OFF si no desea que Ops Manager rote sus registros. La rotación de registros es OFF de forma predeterminada.

Después de habilitar la rotación de registros, Ops Manager muestra configuraciones de rotación de registros adicionales.

3

Ops Manager rota los registros en sus hosts MongoDB según las siguientes configuraciones:

Campo
Necesidad
Acción
predeterminado

Size Threshold (MB)

Requerido

Ops Manager rota los archivos de registro que exceden este tamaño máximo de archivo de registro.

1000

Time Threshold (Hours)

Requerido

Ops Manager rota los registros que exceden esta duración.

24

Max Uncompressed Files

Opcional

Los archivos de registro pueden permanecer sin comprimir hasta que superen este número. Ops Manager comprime primero los archivos de registro más antiguos.

Si deja esta configuración vacía, Ops Manager utilizará el valor predeterminado de 5.

5

Max Percent of Disk

Opcional

Los archivos de registro pueden ocupar hasta este porcentaje de espacio en disco en el volumen de registro de su host MongoDB. Ops Manager elimina los archivos de registro más antiguos cuando superan este límite de espacio en disco.

Si deja esta configuración vacía, Ops Manager utilizará el valor predeterminado de 2%.

2%

Total Number of Files

Opcional

Número total de archivos de registro. Si no se especifica un número, el número total de archivos de registro predeterminado es 0 y se determina mediante otros valores de Rotate Logs.

0

Cuando haya terminado, haga clic en Save para revisar los cambios.

4

En caso contrario, haz clic en Cancel y podrás realizar cambios adicionales.

Ops Manager recolecta registros de todos tus agentes de MongoDB.

Para acceder a esta función, debe tener privilegios otorgados por uno de los siguientes roles:

1

La página muestra los registros del tipo de agente seleccionado en la lista desplegable View. La página filtra los registros según los filtros seleccionados mediante el icono del engranaje.

2

Para mostrar registros de un tipo diferente de agente, utilice la lista desplegable View.

Para mostrar los registros de un host específico o de procesos MongoDB, haga clic en el ícono del engranaje y realice sus selecciones.

Para borrar los filtros, haz clic en el icono de engranaje y haz clic en Remove Filters.

Para descargar los registros seleccionados, haga clic en el ícono del engranaje y haga clic en Download as CSV File.

Nota

Para ver los registros de un agente específico, también puede hacer clic en la lista All Agents de la pestaña Agents y luego hacer clic en view logs para el agente.

Si utiliza Automatización para administrar su clúster, siga este procedimiento para configurar la rotación de los archivos de registro del Agente.

Nota

Si no ha habilitado la automatización, consulte la siguiente documentación para obtener información sobre cómo configurar manualmente los ajustes de registro en los archivos de configuración del agente:

1
2
3
4

Haz click en el icono pencil para editar la configuración de registro del agente de supervisión o del agente de copias de seguridad:

Nombre
Tipo
Descripción

Linux Log File Path

string

Condicional: Registros en un host Linux. Ruta donde el agente escribe sus registros en un host Linux.

El valor sugerido es:

/var/log/mongodb-mms-automation/monitoring-agent.log

Windows Log File Path

string

Condicional: Registros en un host Windows. Ruta donde el agente escribe sus registros en un host Windows.

El valor sugerido es:

%SystemDrive%\MMSAutomation\log\mongodb-mms-automation\monitoring-agent.log

Rotate Logs

Palanca

Un interruptor para seleccionar si los registros deben rotarse.

Size Threshold (MB)

entero

El tamaño en el que los registros rotan automáticamente. El valor predeterminado es 1000.

Time Threshold (Hours)

entero

El tiempo durante el cual los registros rotan automáticamente. El valor predeterminado es 24.

Max Uncompressed Files

entero

Opcional. El máximo número de archivos de registro, incluido el actual, que deben permanecer sin comprimir. El valor sugerido 5 es.

Max Percent of Disk

entero

Opcional. El máximo porcentaje de espacio en disco en sus hosts MongoDB que los registros deberían consumir. El valor sugerido 2% es.

Total Number of Files

entero

Opcional. El número total de archivos de registro. Si no se especifica un número, el número total de archivos de registro predeterminado 0 es y se determina mediante otras opciones Rotate Logs de.

Cuando haya terminado, haga clic en Save.

5
6

En caso contrario, haz clic en Cancel y podrás realizar cambios adicionales.

Puede utilizar Ops Manager para revisar una variedad de archivos de registro:

Puede cambiar la duración de la conservación de algunos registros de Ops Manager. Es posible que su empresa necesite conservar los datos de registro por requisitos legales. Puede modificar su política de conservación de registros para cumplir con dichos requisitos.

Volver

Slack