- Reference >
- Automation Agent >
- Automation Agent Configuration
Automation Agent Configuration¶
On this page
Configuration File¶
The location of the Automation Agent configuration file depends on your operating system:
RHEL, CentOS, Amazon Linux, and Ubuntu all use a package manager to install the agent. The package manager creates the following agent configuration file:
/etc/mongodb-mms/automation-agent.config
OS X, Windows, and other Linux systems use either a
tar
ormsi
file for the installation. The Automation Agent stores its configuration in the following file:<installation directory>/local.config
Settings¶
Ops Manager provides default values for many of the Automation Agent
Configuration settings. However, you must set the
mmsGroupId
and mmsApiKey
values.
Connection Settings¶
-
mmsGroupId
¶ Type: string
Required. The ID of your Ops Manager group. You can find it in Ops Manager under the Group Settings page in the Administration tab.
For example:
-
mmsApiKey
¶ Type: string
Required. The Ops Manager agent API key for the group. To retrieve the key from the Ops Manager interface, click the Administration tab, then the Group Settings page.
For example:
-
mmsBaseUrl
¶ Type: string
The URL of the Ops Manager Web Server.
Set this to the URL of your Ops Manager HTTP Service. For example:
-
logFile
¶ Type: string
The path to which Ops Manager should write the automation agent’s log. By default, the path is
/var/log/mongodb-mms-automation/automation-agent.log
, but you can choose an alternate location if desired.For example:
-
mmsConfigBackup
¶ Type:
The path to the file where the Automation Agent stores a backup copy of the Ops Manager automation configuration, which describes the desired state of the deployment.
For example:
Logging Settings¶
-
logLevel
¶ Type: string
The level of logging granularity. You can choose from the following severity levels, from most verbose to least. By default,
logLevel
isINFO
.DEBUG
ROUTINE
INFO
WARN
ERROR
DOOM
For example:
Each level includes the log items covered by the following levels. For instance, if you choose
DEBUG
, the Automation Agent logs all messages, includingROUTINE
,INFO
,WARN
,ERROR
, andDOOM
. By contrast, if you chooseDOOM
, the Automation Agent only logsDOOM
messages.
-
maxLogFiles
¶ Type: integer
The maximum number of rotate log files to retain. By default,
maxLogFiles
is10
. You can change the value to retain a different number of rotated log files. For example:
-
maxLogFileSize
¶ Type: integer
Specifies the maximum size, in bytes, that a log file can be before triggering log rotation. For example: