Configuraciones del MongoDB Agent

Configuración de registro

logFile

Tipo: string

Especifica la ruta en la que Ops Manager debe guardar el registro del MongoDB Agent.

La ruta por defecto depende de tu plataforma. El agente de MongoDB utiliza el nombre de archivo por defecto automation-agent.log, independientemente de si la implementación utiliza automatización.

Importante

La rotación automática de los registros de tu MongoDB Agent solo ocurre cuando se realiza una actualización en el archivo de registro. Para rotar manualmente los registros del MongoDB Agent, consulta Rotar manualmente los registros del MongoDB Agent para más información.

Plataforma	Ruta por defecto
Linux	/var/log/mongodb-mms-automation/automation-agent.log
Windows	C:\MMSAutomation\log\mongodb-mms-automation\automation-agent.log

logFile=/path/to/mongodb-mms-automation/automation-agent.log

logLevel

Tipo: string

Especifica el nivel de granularidad de la generación de logs.

Advertencia

La configuración de proyecto de administrador para Monitoring Agent Log Level y Automation Agent Log Level anulan este parámetro.

Elija entre los siguientes niveles de gravedad, desde la mayor hasta la menor cantidad de información:

• DEBUG

• INFO

• WARN

• ERROR

• FATAL

Por defecto, logLevel INFOes.

logLevel=ROUTINE

Cada nivel incluye los elementos del registro incluidos en los niveles siguientes.

Ejemplo

• Si eliges DEBUG, el MongoDB Agent registra todos los mensajes, incluyendo INFO, WARN, ERROR y FATAL.

• Si eliges FATAL, el MongoDB Agent solo guarda registros de mensajes FATAL.

maxLogFiles

Tipo: entero

Especifica el número máximo de entradas de registro rotadas que se deben conservar.

Por defecto, el valor de se maxLogFiles establece 10 en. Puede cambiar el valor para conservar un número diferente de archivos de registro rotados.

maxLogFiles=15

maxLogFileDurationHrs

Tipo: float

Establece el número de horas después del cual los registros se rotan.

Nota

Rotar manualmente los registros del MongoDB Agent

En sistemas basados en UNIX y Linux, puedes rotar manualmente los registros del Agente de MongoDB. Emita un comando kill con la señal SIGUSR1 para el proceso agente:

kill -SIGUSR1 <AgentID>

En sistemas basados en Windows, puedes reiniciar manualmente el MongoDB Agent con un reinicio de servicio:

1. Haz clic en el menú Start.

2. Buscar services.

3. Encuentra el MongoDB Agent.

4. Haz clic con el botón derecho en el agente y selecciona Restart.

Esto rota los registros del Agente de MongoDB.

maxLogFileSize

Tipo: entero

Especifica el tamaño máximo, en bytes, de una entrada de registro antes de que los registros se roten. Si no se especifica, el Agente de MongoDB no rota los registros según el tamaño del archivo.

Por defecto, el valor de se establece maxLogFileSize en 268435456 bytes. Puede cambiar este valor para asignar un tamaño máximo diferente al archivo de registro.

maxLogFileSize=536870912

maxUncompressedLogFiles

Tipo: entero

Especifica el número máximo de archivos de registro rotados que se mantendrán sin comprimir. El agente de MongoDB comprime automáticamente cualquier archivo de registro adicional retenido hasta el maxLogFiles valor.

Por defecto, el valor de se maxUncompressedLogFiles establece 2 en. Puede cambiar el valor para comprimir una cantidad diferente de archivos de registro rotados.

maxUncompressedLogFiles=10

Configuración de la conexión

dialTimeoutSeconds

Tipo: entero

Especifica la cantidad de segundos que se deben esperar antes de que una conexión agote el tiempo de espera. Para aumentar el tiempo de espera de la conexión de MongoDB Agent, aumente el valor de dialTimeoutSeconds. Por defecto, las conexiones agotan el tiempo de espera después de 40 segundos. Sin embargo, el MongoDB Agent puede agotar el tiempo de espera de las conexiones con frecuencia por una o más de las siguientes razones:

• Alta latencia de red

• Alta carga del servidor.

• Grandes claves TLS

• Falta de TLS acelerador

• Velocidad de CPU insuficiente

MongoDB recomienda aumentar gradualmente el valor del dialTimeoutSeconds ajuste de configuración del agente de MongoDB para evitar tiempos de espera de conexión prematuros frecuentes.

dialTimeoutSeconds=40

Nota

Aumentar este valor también incrementa el tiempo necesario para implementar cambios de configuración en el MongoDB Agent. Experimenta con aumentos pequeños e incrementales hasta que determines el valor óptimo para tu implementación.

serverSelectionTimeoutSeconds

Tipo: entero

Especifica el número de segundos que el MongoDB Agent espera antes de dejar de intentar establecer la conexión con un proceso de MongoDB. Por defecto, el Agente de MongoDB abandona los intentos de establecer una conexión después de 10 segundos.

serverSelectionTimeoutSeconds=10

Configuración de proxy HTTP

httpProxy

Tipo: string

Especifica la URL de un servidor proxy HTTP que el Agente de MongoDB puede utilizar.

httpProxy=http://proxy.example.com:8080

Configuración de copia de seguridad de la configuración

mmsConfigBackup

Tipo: string

Especifica la ruta al archivo de copia de seguridad de la configuración de Ops Manager. Este archivo describe el estado deseado de la implementación.

Si no especifica la configuración, el agente de MongoDB escribe mmsConfigBackup el mongodb-mms-automation-cluster-backup.json archivo en una carpeta temporal del sistema operativo.

Si enableLocalConfigurationServer establece true en, el agente de MongoDB no escribe el mmsConfigBackup archivo.

mmsConfigBackup=/path/to/mms-cluster-config-backup.json

Nota

Cuando se instala Ops Manager, se almacena el archivo de copia de seguridad de configuración en uno de los siguientes lugares, dependiendo de tu plataforma:

Plataforma	Ruta del archivo de copia de seguridad de la configuración
Linux	/var/lib/mongodb-mms-automation/
Windows	%SystemDrive%\MMSAutomation

MongoDB Ops Manager TLS Settings

Especifique la configuración que el MongoDB Agent utiliza al comunicarse con Ops Manager usando TLS.

httpsCAFile

Tipo: string

Especifica la ruta absoluta que contiene los certificados de la Autoridad Certificadora de confianza en formato PEM. Este certificado verifica que el MongoDB Agent está comunicándose con la instancia designada de Ops Manager.

httpsCAFile=/path/to/ca.pem

Nota

Agregue la Autoridad de Certificación para el certificado downloads.mongodb.com a este archivo .pem si:

1. ¿Necesita que sus agentes de MongoDB descarguen sus instaladores de MongoDB de Internet,

2. Utiliza TLS para cifrar las conexiones y

3. Firma sus certificados con una Autoridad Certificadora privada. (Has configurado la opción httpsCAFile.)

Para aprender cómo descargar certificados TLS de otro sitio web, consulta la entrada OpenSSL Cookbook.

Importante

Cuando Ops Manager se inicia, almacena en caché la Autoridad Certificadora que proporcionaste. Si cambias el certificado de tu Autoridad Certificadora, reinicia Ops Manager.

sslRequireValidMMSServerCertificates

Tipo: booleano

Importante

Obsoleto. Utilice en su tlsRequireValidMMSServerCertificates lugar.

tlsRequireValidMMSServerCertificates

Tipo: booleano

Indica si el MongoDB Agent debe validar los certificados TLS presentados por Ops Manager.

Advertencia

Establecer esta opción en false desactiva la verificación de certificados y hace que las conexiones entre MongoDB Agent y Ops Manager sean susceptibles a ataques de man-in-the-middle. Solo se recomienda activar esta opción en false para fines de prueba.

tlsRequireValidMMSServerCertificates=true

sslMMSServerClientCertificate

Tipo: string

Importante

Obsoleto. Utilice en su tlsMMSServerClientCertificate lugar.

tlsMMSServerClientCertificate

Tipo: string

Especifica la ruta al archivo que contiene la clave privada del cliente, el certificado y los certificados intermedios opcionales en formato PEM. El agente de MongoDB utiliza el certificado del cliente al conectarse a Ops Manager a través de TLS si Ops Manager requiere certificados de cliente, como cuando Ops Manager se ejecuta con Client Certificate Mode configurado como Required for Agents Only o Required for All Requests.

Tip

Para aprender a configurar Client Certificate Mode, consulta Configuración de Ops Manager.

La clave privada cifrada para el .pem archivo de certificado debe estar en formato PKCS #. El agente de1 MongoDB no admite el formato PKCS8 #.

tlsMMSServerClientCertificate=/path/to/client.pem

sslMMSServerClientCertificatePassword

Tipo: string

Importante

Obsoleto. Utilice en su tlsMMSServerClientCertificatePassword lugar.

tlsMMSServerClientCertificatePassword

Tipo: string

Especifica la contraseña necesaria para descifrar la clave privada en el archivo. Esta configuración es necesaria cuando el archivo de certificado de tlsMMSServerClientCertificate cliente PEM está cifrado.

La clave privada cifrada para el .pem archivo de certificado debe estar en formato PKCS #. El agente de1 MongoDB no admite el formato PKCS8 #.

Nota

Utilice la tlsMMSServerClientCertificatePasswordExec opción en lugar de para especificar la contraseña desde un comando de tlsMMSServerClientCertificatePassword shell.

tlsMMSServerClientCertificatePassword=password

sslServerClientCertificate

Tipo: string

Especifica la ruta al archivo que contiene la clave privada del cliente, el certificado y los certificados intermedios opcionales en formato PEM. El agente de MongoDB utiliza el certificado del cliente al conectarse a Ops Manager a través de TLS si Ops Manager requiere certificados de cliente, como cuando Ops Manager se ejecuta con Client Certificate Mode configurado como Required for Agents Only o Required for All Requests.

Tip

• Consulta Client Certificate Mode en Configuración de Settings de Ops Manager para saber cómo especificar esta configuración en la Aplicación Ops Manager.

• Consulta Configurar el agente de MongoDB para utilizar TLS para habilitar conexiones TLS en el MongoDB Agent.

sslServerClientCertificate=/path/to/client.pem

sslServerClientCertificatePassword

Especifica la contraseña necesaria para descifrar la clave privada en el archivo sslServerClientCertificate. Esta configuración es necesaria cuando el archivo de certificado de cliente PEM está cifrado.

sslServerClientCertificatePassword=password

sslRequireValidMMSBackupServerCertificate

Especifica si el Agente de MongoDB debe validar los certificados TLS de Ops Manager.

Advertencia

Establecer esta opción en false desactiva la verificación de certificados y hace que las conexiones entre MongoDB Agent y Ops Manager sean susceptibles a ataques de man-in-the-middle. Solo se recomienda activar esta opción en false para fines de prueba.

sslRequireValidMMSBackupServerCertificate=true

Configuración de Migración en vivo

agentFeatureCloudMigrationEnabled

Tipo: booleano

Opcional.

Especifica si el MongoDB Agent en el host de migración está configurado para ejecutar el proceso de Migración en vivo desde una implementación fuente de Ops Manager a un clúster objetivo en Atlas.

Esta opción tiene como valor predeterminado false, lo que impide el uso de MongoDB Agent en este host para Migración en vivo a Atlas.

Para habilitar el proceso de migración en vivo, proporcione un host de migración y configure agentFeatureCloudMigrationEnabled en true.

cloudMigrationOplogPath

Tipo: string

Opcional.

Ruta a los archivos oplog. Si se especifica, esta configuración almacena en búfer el oplog ventana de sincronización inicial en el disco. Proporcione almacenamiento suficiente en el directorio especificado para el almacenamiento en búfer del oplog.

Configuración con origen externo

enableLocalConfigurationServer

Tipo: booleano

Especifica si el MongoDB Agent almacena los archivos de configuración de MongoDB en disco o en caché.

Esta opción está predeterminada en false, que almacena los archivos de configuración en disco. Si configura esta opción en true, se almacena la configuración en la memoria caché.

Si establece esta opción true en, el agente de MongoDB no escribe el mmsConfigBackup archivo.

No establezca esta opción en true si sus bases de datos MongoDB están FCV 4 ejecutando.2 o versiones anteriores.

Advertencia

Establecer esta opción como true afecta la disponibilidad de su implementación.

Cuando esta funcionalidad está activada, el MongoDB Agent no almacena la configuración del proceso de MongoDB en el disco. Si el servidor de aplicaciones de Ops Manager no está disponible y el MongoDB Agent intenta reiniciar, el MongoDB Agent deja de funcionar porque no dispone de la información de configuración necesaria. Si un proceso de MongoDB se bloquea mientras el MongoDB Agent no está funcionando, entonces el MongoDB Agent no puede reiniciar el proceso.

enableLocalConfigurationServer=false

Tip

Configura cómo el MongoDB Agent gestiona los archivos de configuración y las contraseñas

keepUnusedMongodbVersions

Tipo: booleano

Indicador que especifica si el agente de MongoDB conserva los binarios de versiones de MongoDB no utilizadas que descarga. Por defecto, eskeepUnusedMongodbVersions falso.

keepUnusedMongodbVersions=false

localConfigurationServerPort

Tipo: entero

Especifica el puerto al que se debe enviar la configuración del proceso de MongoDB cuando se utiliza el servidor de configuración local. Para establecer esta opción, debeenableLocalConfigurationServer true ser.

Si no se especifica, el MongoDB Agent elige automáticamente un puerto disponible.

localConfigurationServerPort=20128

mmsApiKeyExec

Tipo: string

Especifica un comando de shell para llamar a la clave API del agente de Ops Manager de tu proyecto de Ops Manager.

mmsApiKeyExec=echo $myKey

sslMMSServerClientCertificatePasswordExec

Tipo: string

Importante

Obsoleto. Utilice en su tlsMMSServerClientCertificatePasswordExec lugar.

tlsMMSServerClientCertificatePasswordExec

Tipo: string

Especifica un comando de shell para llamar a la contraseña necesaria para descifrar la clave privada en el MMSServerClientCertificate archivo. Se requiere esta configuración o tlsMMSServerClientCertificatePassword cuando el archivo de certificado de cliente PEM está cifrado.

tlsMMSServerClientCertificatePasswordExec=python /path/to/PEMPassword.py

Configuraciones de Kerberos de MongoDB

Especifica estos ajustes si Automatización de autenticación con hosts mediante Kerberos. Para configurar Kerberos, consulta Configura el MongoDB Agent para Kerberos.

krb5ConfigLocation

Tipo: string

Especifica una ruta absoluta a una ubicación no estándar del sistema para el archivo de configuración Kerberos.

krb5ConfigLocation=/path/to/krb_custom.conf

Nota

Ops Manager crea automáticamente una caché de credenciales Kerberos (tickets) para cada agente cuando se habilita Kerberos. Si desea modificar la ubicación de la caché de credenciales Kerberos, debe configurar la KRB5CCNAME variable de entorno con el nombre y la ruta de archivo deseados antes de ejecutar el agente.

Configuración de registros

1. En la navegación, haz clic en Deployment.

2. Haz clic en la pestaña Agents.

3. Haga clic en Downloads & Settings.

4. En la sección Agent Log Settings, haz clic en junto a Monitoring Log Settings.

5. Edita la configuración del registro de supervisión:

   Configuración	Valor por defecto	Valor sugerido por la consola
   Ruta del archivo de registro de Linux	/var/log/mongodb-mms-automation/monitoring-agent.log
   Ruta de la entrada de registro de Windows	%SystemDrive%\MMSAutomation\log\mongodb-mms-automation\monitoring-agent.log
   Rotar registros	Sí
   Límite de tamaño (MB)	1000
   Umbral de tiempo (horas)	24
   Máximo de archivos no comprimidos		5
   Porcentaje máximo del disco		2
   Número total de archivos de registro	0

6. Haga clic en Save.

Configuraciones personalizadas

1. En la navegación, haz clic en Deployment.

2. Haz clic en la pestaña Agents.

3. Haga clic en Downloads & Settings.

4. En la sección Custom Configuration, junto a Edit Custom Configurations, haz clic en .

5. Introduce la configuración de supervisión y el valor.

6. Haga clic en Save and Close.

Puedes configurar los siguientes ajustes de supervisión:

Configuración de registros

1. En la navegación, haz clic en Deployment.

2. Haz clic en la pestaña Agents.

3. Haga clic en Downloads & Settings.

4. En la sección Agent Log Settings, haz clic en junto a Backup Log Settings.

5. Edita la configuración del registro de copia de seguridad:

   Configuración	Valor por defecto	Valor sugerido por la consola
   Ruta del archivo de registro de Linux	/var/log/mongodb-mms-automation/backup-agent.log
   Ruta de la entrada de registro de Windows	%SystemDrive%\MMSAutomation\log\mongodb-mms-automation\backup-agent.log
   Rotar registros	Sí
   Límite de tamaño (MB)	1000
   Umbral de tiempo (horas)	24
   Máximo de archivos no comprimidos		5
   Porcentaje máximo del disco		2
   Número total de archivos de registro	0

6. Haga clic en Save.

Configuraciones personalizadas

1. En la navegación, haz clic en Deployment.

2. Haz clic en la pestaña Agents.

3. Haga clic en Downloads & Settings.

4. En la sección Custom Configuration, junto a Edit Custom Configurations, haz clic en .

5. Introduce un valor y una configuración de copia de seguridad.

6. Haga clic en Save and Close.

Puedes configurar las siguientes configuraciones de Copia de Seguridad: