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.
Los registros de MongoDB proporcionan la información de registro de diagnóstico para tu
mongodymongosprocesos.Los registros del agente brindan información sobre el comportamiento de sus agentes de Ops Manager.
Registros en tiempo real de MongoDB
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 por defecto. Puede desactivar la recopilación de registros para todas las implementaciones de MongoDB en un Proyecto de Ops Manager o para implementaciones individuales de MongoDB. Si se desactiva la colección de registros, Ops Manager seguirá mostrando las entradas de registros recopiladas anteriormente.
Ver registros en tiempo real de MongoDB
Para acceder a esta funcionalidad, debes tener privilegios otorgados por uno de los siguientes roles:
Navega hasta el Clusters vista para tu implementación.
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.
Si aún no se muestra, se debe seleccionar el proyecto deseado en el menú Projects de la barra de navegación.
Si aún no se muestra, haz clic en Deployment en la barra lateral.
Haga clic en la vista Clusters.
(Opcional) Para clústeres particionados, filtra qué tipo de proceso está enumerado.
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. |
Habilitar o deshabilitar la recopilación de registros para una implementación
Navegue a la Clusters vista para su implementación.
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.
Si aún no se muestra, se debe seleccionar el proyecto deseado en el menú Projects de la barra de navegación.
Si aún no se muestra, haz clic en Deployment en la barra lateral.
Haga clic en la vista Clusters.
Habilita o deshabilita la recopilación de registros para el proyecto
Registros en disco de MongoDB
Ops Manager recopila registros en disco incluso si la instancia de MongoDB no se está ejecutando. El Agente de MongoDB recopila los registros de la ubicación que especificaste en la opción de configuración de MongoDB systemLog.path opción de configuración. Los registros en disco de MongoDB son un subconjunto de los registros en tiempo real y, por lo tanto, menos detallados.
Puedes configurar la rotación de registros para los registros en el disco. Ops Manager rota los registros por defecto.
Este procedimiento rota tanto los registros del sistema como los de auditoría para Ops Manager.
Ver registros en disco de MongoDB
Para acceder a esta funcionalidad, debes tener privilegios otorgados por uno de los siguientes roles:
Haz clic en la implementación de la cual deseas descargar los registros, luego haz clic en Request Logs
Haz clic en el ícono de elipsis ... en la línea de cualquier proceso, set de réplicas, o clúster en el proyecto, luego haz clic en Request Logs.
Seleccione qué tipos de registros de Ops Manager por proceso desea recopilar y el tamaño máximo acumulado de estos registros.
Para seleccionar los registros que desea descargar, realice las siguientes acciones:
Acción | Propósito |
|---|---|
Haga clic MongoDB Logs | Reunir registros de los procesos MongoDB desplegados. Esta opción no está disponible para los procesos implementados de MongoDB si la propiedad systemLog.destination está configurada en |
Haga clic MongoDB FTDC Data | Reúne los archivos de datos de diagnóstico del mecanismo de recolección (FTDC), tales como estadísticas del servidor y mensajes de estado. |
Haga clic Automation Logs | Recopilar registros de los agentes de automatización implementados. |
Haga clic Backup 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 Logs | Reúne registros de todos los agentes de supervisión 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 Filter By Size en MB | Ingresa el tamaño máximo acumulado sin comprimir en megabytes de todas las entradas de registro seleccionadas.
|
Configura Filter By Date Range | Introduzca un rango de fechas para limitar los registros recopilados a ese rango.
|
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:27017host2:27017host2:27018
Su implementación ejecuta los siguientes agentes:
agente de automatización |
|
agente de copias de seguridad |
|
Agente de supervisión |
|
Cuando seleccionas todos los tipos de registros para este set de réplicas y limitas a 20 MB por proceso, Ops Manager muestra que el Estimated Total Size es 220 MB (11 procesos * 20 MB) de 20 GB.
Una vez que comienza la colección de registros, Ops Manager escanea los directorios de registros en busca de los procesos mongod y su correspondiente FTDC desde la entrada de registro más reciente hasta que se recolecten 20 MB de archivos registro o se llegue al final del último registro. También se escanean todos los agentes de supervisión y copias de seguridad de la implementación.
El agente de respaldo tiene 60 MB de registros.
Cada proceso de MongoDB (3) tiene 7 MB de logs 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 recolectados 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 copias de seguridad.
Se recopilan todos los registros de cada proceso de MongoDB: 7 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 recogen todos los registros del agente de automatización de
host1yhost2.host4yhost5no host ningún proceso en el set de réplicas.
La estructura del fichero resultante dentro del fichero 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
(Opcional) Redactar información confidencial de los registros.
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.
Consulta el progreso en la página Log Request History.
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 puedes descargar el fichero. Faltarán algunas de las entradas de registro solicitadas.
Descargar el fichero de registros recopilados.
Hacer clic en Download icon.
El tamaño listado para el fichero en la página Log Request History es el tamaño sin comprimir. El fichero consume esa cantidad de espacio en disco en el host de destino una vez que se extrae.
Esta descarga solo puede reiniciarse, no reanudarse. Si la descarga falla, debe descargar los registros nuevamente.
El fichero se llama mongodb-logfiles_<instance_or_process>_<ISO8601_Format_Date>.tar.gz.
Los archivos extraídos utilizan la siguiente estructura de directorios:
<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>
Nota
Al extraer el fichero tar en un host Microsoft Windows, utiliza una utilidad de extracción de ficheros que sea compatible con Cabeceras extendidas PAX. Algunas utilidades de fichero para Windows presentan problemas con los encabezados extendidos PAX para tar.
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.
Configurar la rotación de registros
Ops Manager puede rotar y comprimir los registros de los clústeres que gestiona el MongoDB Agent. Si el MongoDB Agent solo supervisa un clúster, ignora los registros de ese clúster.
Importante
Si utilizas MongoDB Enterprise versión 5.0 o posterior y MongoDB Agent 11.0.13.7055 o posterior, puedes:
Establece reglas separadas para girar 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 el MongoDB Agent, Ops Manager:
Utiliza tu configuración de System Log Rotation para rotar tanto los registros del servidor como los registros de auditoría.
No comprime ni borra registros de auditoría. Si se configura la compresión y la eliminación, Ops Manager aplica estas configuraciones únicamente a los registros del servidor.
Los usuarios de MongoDB Community sólo pueden rotar, comprimir y borrar los registros del servidor.
Nota
Cuando utilices esta funcionalidad, desactiva cualquier servicio de rotación de registros basado en la plataforma, como logrotate. Elimina los flags reopen y rename de los archivos de configuración del proceso. Si el MongoDB Agent solo supervisa el clúster, dicho clúster puede utilizar servicios basados en plataformas.
Habilitar la rotación de registros.
Activa System Log Rotation a ON para rotar los registros del servidor.
Los usuarios de MongoDB Enterprise que ejecuten la versión 5.0 o posterior de MongoDB Enterprise y el Agente de MongoDB 11.0.13.7055 y posteriores también pueden alternar Audit Log Rotation a ON para rotar los registros de auditoría y configurar la rotación de registros de auditoría por separado.
Si ejecutas versiones anteriores de MongoDB Enterprise o el MongoDB Agent, establecer 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 está OFF por defecto.
Después de habilitar la rotación de registros, Ops Manager muestra configuraciones de rotación de registros adicionales.
Configura los ajustes de rotación de registros.
Ops Manager rota los registros en tus hosts MongoDB según las siguientes configuraciones:
Campo | Necesidad | Acción | predeterminado |
|---|---|---|---|
Size Threshold (MB) | Requerido | Ops Manager rota las entradas de registro que superan este tamaño máximo de entrada de registro. |
|
Time Threshold (Hours) | Requerido | Ops Manager rota los registros que superan esta duración. |
|
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 |
|
Max Percent of Disk | Opcional | Las entradas de registro pueden ocupar hasta este porcentaje del espacio en disco en el volumen de registros de tu host de MongoDB. Ops Manager borra las entradas de registro más antiguas una vez que se ha superado este umbral de disco. Si deja esta configuración vacía, Ops Manager utilizará el valor predeterminado de |
|
Total Number of Files | Opcional | Número total de entradas de registro. Si no se especifica un número, el número total de entradas de registro es |
|
Cuando haya terminado, haga clic en Save para revisar los cambios.
Registros del agente
Ops Manager recolecta registros de todos tus agentes de MongoDB.
Ver registros del agente
Para acceder a esta funcionalidad, debes tener privilegios otorgados por uno de los siguientes roles:
Filtra las entradas del registro.
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, haz clic en el icono de engranaje y haz clic en Download as CSV File.
Nota
Para ver los registros de un agente específico, también puedes hacer clic en la lista All Agents de la pestaña Agents y luego hacer clic en view logs para el agente.
Configurar la rotación de registros del 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 has habilitado la Automatización, consulta la siguiente documentación para información sobre cómo configurar manualmente los ajustes de registro en los archivos de configuración del agente:
Edita la configuración de los registros.
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 de Linux. La ruta en la que el agente escribe sus registros en un host Linux. El valor sugerido es: | |
Windows Log File Path | string | Condicional: Registros en un host de Windows. La ruta en la que el agente escribe sus registros en un host de Windows. El valor sugerido es: | |
Rotate Logs | Alternar | Un interruptor para seleccionar si los registros deben rotarse. | |
Size Threshold (MB) | entero | El tamaño en el que los registros giran automáticamente. El valor por defecto es | |
Time Threshold (Hours) | entero | La duración del tiempo en que los registros se rotan automáticamente. El valor por defecto es | |
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 | |
Max Percent of Disk | entero | opcional. El mayor porcentaje de espacio en disco en tus hosts de MongoDB que los registros deben consumir. El valor sugerido 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 |
Cuando haya terminado, haga clic en Save.
Ops Manager Registros
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.