MongoDB Agent 설정

로깅 설정

logFile

유형: 문자열

Ops Manager가 MongoDB Agent의 로그를 쓸 경로를 지정합니다.

기본 경로는 플랫폼에 따라 다릅니다. 배포에서 자동화를 사용하는지 여부에 관계없이 MongoDB Agent는 기본 파일 이름 automation-agent.log를 사용합니다.

중요

MongoDB Agent 로그의 자동 로테이션은 로그 파일이 업데이트될 때만 발생합니다. MongoDB Agent 로그를 수동으로 로테이션하려면 자세한 내용 은 MongoDB Agent 로그 수동 으로 로테이션을 참조하세요.

플랫폼	기본 경로
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

유형: 문자열

로깅 세분화 수준을 지정합니다.

경고

Monitoring Agent Log Level 및 Automation Agent Log Level에 대한 관리자 프로젝트 설정이 이 매개 변수를 재정의합니다.

가장 많은 양의 정보부터 적은 양의 정보까지, 원하는 수준을 선택합니다.

• DEBUG

• INFO

• WARN

• ERROR

• FATAL

기본값 으로 logLevel 은 INFO 입니다.

logLevel=ROUTINE

각 수준에는 하위 수준에 포함된 로그 항목이 포함됩니다.

예시

• DEBUG를 선택하면 MongoDB Agent가 INFO, WARN, ERROR 및 FATAL을 포함한 모든 메시지를 로그합니다.

• FATAL을 선택하면 MongoDB Agent는 FATAL 메시지만 로그합니다.

maxLogFiles

유형: integer

보존할 로테이션된 로그 파일의 최대 개수를 지정합니다.

기본값 으로 maxLogFiles 10 설정하다 됩니다. 다른 수의 로테이션된 로그 파일을 유지하도록 값을 변경할 수 있습니다.

maxLogFiles=15

maxLogFileDurationHrs

형식: float

로그가 로테이션되는 기간(시간 단위)을 지정합니다.

참고

수동으로 MongoDB Agent 로그 로테이션

UNIX 및 Linux 기반 시스템에서는 MongoDB Agent 로그를 수동으로 로테이션할 수 있습니다. Agent 프로세스에 대해 SIGUSR1 신호와 함께 kill 명령을 실행합니다:

kill -SIGUSR1 <AgentID>

Windows 기반 시스템에서는 Service 재시작을 통해 MongoDB Agent를 수동으로 재시작할 수 있습니다:

1. Start 메뉴를 클릭합니다.

2. services를 검색합니다.

3. MongoDB Agent를 찾습니다.

4. Agent를 마우스 오른쪽 버튼으로 클릭하고 Restart를 클릭합니다.

이렇게 하면 MongoDB Agent 로그가 로테이션됩니다.

maxLogFileSize

유형: integer

로그가 로테이션되기 전 로그 파일의 최대 크기(바이트)를 지정합니다. 지정하지 않으면, MongoDB Agent는 파일 크기에 따라 로그를 로테이션하지 않습니다.

기본적으로 maxLogFileSize 값은 268435456 바이트로 설정됩니다. 값을 변경하여 로그 파일에 다른 최대 크기를 할당할 수 있습니다.

maxLogFileSize=536870912

maxUncompressedLogFiles

유형: integer

압축되지 않은 상태로 유지할 로테이션된 로그 파일의 최대 개수를 지정합니다. MongoDB Agent는 추가로 보존되는 로그 파일을 maxLogFiles 값까지 자동으로 압축합니다.

기본적으로 maxUncompressedLogFiles 2 설정됩니다. 다른 수의 회전된 로그 파일을 압축하도록 값을 변경할 수 있습니다.

maxUncompressedLogFiles=10

연결 설정

dialTimeoutSeconds

유형: integer

연결 시간이 초과되기 전에 대기할 시간(초)을 지정합니다. 기본적으로 연결은 40초 후에 시간 초과됩니다. 그러나 MongoDB Agent는 다음 중 하나 이상의 이유로 인해 연결 시간이 자주 초과될 수 있습니다.

• 높은 네트워크 지연 시간

• 높은 서버 부하

• 대형 TLS 키

• TLS 가속기 부족

• CPU 속도 부족

MongoDB 는 dialTimeoutSeconds MongoDB Agent 구성 설정의 값을 점진적으로 늘려 연결 시간 초과가 조기에 자주 발생하는 것을 방지할 것을 권장합니다.

dialTimeoutSeconds=40

참고

이 값을 늘리면 MongoDB Agent에 구성 변경 사항을 배포하는 데 필요한 시간도 늘어납니다. 배포에 알맞는 최적의 값을 찾을 때까지 조금씩 해당 값을 늘리면서 실험해 보세요.

serverSelectionTimeoutSeconds

유형: integer

MongoDB Agent가 MongoDB 프로세스에 대한 연결 시도를 중지하기 전에 대기하는 시간(초)을 지정합니다. 기본적으로 MongoDB Agent는 10초 후에 연결 시도를 중단합니다.

serverSelectionTimeoutSeconds=10

HTTP 프록시 설정

httpProxy

유형: 문자열

MongoDB Agent가 사용할 수 있는 HTTP 프록시 서버의 URL을 지정합니다.

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

구성 백업 설정

mmsConfigBackup

유형: 문자열

Ops Manager 구성 백업 파일의 경로를 지정합니다. 이 파일은 원하는 배포 상태를 설명합니다.

mmsConfigBackup 설정을 지정하지 않으면 MongoDB Agent가 mongodb-mms-automation-cluster-backup.json 파일을 운영 체제의 임시 폴더에 씁니다.

enableLocalConfigurationServer 을 true 로 설정하면 MongoDB Agent가 mmsConfigBackup 파일을 쓰지 않습니다.

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

참고

Ops Manager가 설치되면 플랫폼에 따라 구성 백업 파일이 다음 위치 중 하나에 저장됩니다.

플랫폼	구성 백업 파일 경로
Linux	/var/lib/mongodb-mms-automation/
Windows	%SystemDrive%\MMSAutomation

MongoDB Ops Manager MongoDB Ops Manager TLS 설정

MongoDB Agent가 TLS를 사용하여 Ops Manager와 통신할 때 사용하는 설정을 지정합니다.

httpsCAFile

유형: 문자열

신뢰할 수 있는 인증 기관 인증서가 포함된 절대 경로를 PEM 형식으로 지정합니다. 이 인증서는 MongoDB Agent가 지정된 Ops Manager 인스턴스와 통신하고 있는지 확인합니다.

httpsCAFile=/path/to/ca.pem

참고

다음에 해당하는 경우 downloads.mongodb.com 인증서에 대한 인증 기관을 이 .pem 파일에 추가합니다:

1. MongoDB Agents가 인터넷에서 MongoDB 설치 프로그램을 다운로드해야 합니다.

2. TLS를 사용하여 연결을 암호화합니다.

3. 사설 인증 기관을 통해 인증서에 서명했습니다. (httpsCAFile 옵션을 설정합니다.)

다른 웹 사이트에서 TLS 인증서를 다운로드하는 방법을 알아보려면 OpenSSL Cookbook 항목을 참조하세요.

중요

Ops Manager가 시작되면 제공한 인증 기관을 캐시합니다. 인증 기관 인증서를 변경하는 경우 Ops Manager를 다시 시작하세요.

sslRequireValidMMSServerCertificates

유형: 부울

중요

더 이상 사용되지 않습니다. 대신 tlsRequireValidMMSServerCertificates 을(를) 사용하세요.

tlsRequireValidMMSServerCertificates

유형: 부울

MongoDB Agent가 Ops Manager에서 제공하는 TLS 인증서의 유효성을 검사할지 여부를 지정합니다.

경고

이 옵션을 false로 설정하면 인증서 검증이 비활성화되고 MongoDB Agent와 Ops Manager 간의 연결이 중간자(man-in-the-middle) 공격에 취약해집니다. 이 옵션을 false로 설정하는 것은 테스트 목적으로만 사용하는 것이 좋습니다.

tlsRequireValidMMSServerCertificates=true

sslMMSServerClientCertificate

유형: 문자열

중요

더 이상 사용되지 않습니다. 대신 tlsMMSServerClientCertificate 을(를) 사용하세요.

tlsMMSServerClientCertificate

유형: 문자열

클라이언트의 비공개 키, 인증서 및 선택적 중간 인증서를 포함하는 파일의 경로를 PEM 형식으로 지정합니다. MongoDB Agent는 Ops Manager에 클라이언트 인증서가 필요한 경우(예: Ops Manager가 Required for Agents Only 또는 Required for All Requests로 설정된 상태에서 Client Certificate Mode를 사용해 실행되는 경우) TLS를 통해 Ops Manager에 연결할 때 클라이언트 인증서를 사용합니다.

팁

다음도 참조하세요.

Client Certificate Mode를 설정하는 방법을 알아보려면 Ops Manager 구성 설정을 참조하세요.

인증서 파일의 암호화된 비공개 키는 .pem PKCS #1 에 있어야 합니다. 형식. MongoDB Agent가 PKCS를 지원하지 않습니다.8 # 형식.

tlsMMSServerClientCertificate=/path/to/client.pem

sslMMSServerClientCertificatePassword

유형: 문자열

중요

더 이상 사용되지 않습니다. 대신 tlsMMSServerClientCertificatePassword 을(를) 사용하세요.

tlsMMSServerClientCertificatePassword

유형: 문자열

tlsMMSServerClientCertificate 파일 에 있는 비공개 키를 해독하는 데 필요한 비밀번호를 지정합니다. 이 설정은 클라이언트 인증서 PEM 파일 이 암호화됨 경우 필요합니다.

인증서 파일의 암호화된 비공개 키는 .pem PKCS #1 에 있어야 합니다. 형식. MongoDB Agent가 PKCS를 지원하지 않습니다.8 # 형식.

참고

명령에서 비밀번호를 지정하려면 tlsMMSServerClientCertificatePassword 대신 tlsMMSServerClientCertificatePasswordExec 옵션을 사용합니다.shell

tlsMMSServerClientCertificatePassword=password

sslServerClientCertificate

유형: 문자열

클라이언트의 비공개 키, 인증서 및 선택적 중간 인증서를 포함하는 파일의 경로를 PEM 형식으로 지정합니다. MongoDB Agent는 Ops Manager에 클라이언트 인증서가 필요한 경우(예: Ops Manager가 Required for Agents Only 또는 Required for All Requests로 설정된 상태에서 Client Certificate Mode를 사용해 실행되는 경우) TLS를 통해 Ops Manager에 연결할 때 클라이언트 인증서를 사용합니다.

팁

다음도 참조하세요.

• Ops Manager 애플리케이션에서 해당 설정을 지정하는 방법을 알아보려면 Ops Manager 구성 설정에서 Client Certificate Mode를 확인합니다.

• MongoDB Agent에 대한 TLS 연결을 활성화하려면 TLS를 사용하도록 MongoDB Agent 구성을 참조하세요.

sslServerClientCertificate=/path/to/client.pem

sslServerClientCertificatePassword

sslServerClientCertificate 파일에서 비공개 키를 해독하는 데 필요한 암호를 지정합니다. 이 설정은 클라이언트 인증서 PEM 파일이 암호화된 경우 필요합니다.

sslServerClientCertificatePassword=password

sslRequireValidMMSBackupServerCertificate

MongoDB Agent가 Ops Manager로부터 TLS 인증서의 유효성을 검사할지 여부를 지정합니다.

경고

이 옵션을 false로 설정하면 인증서 검증이 비활성화되고 MongoDB Agent와 Ops Manager 간의 연결이 중간자(man-in-the-middle) 공격에 취약해집니다. 이 옵션을 false로 설정하는 것은 테스트 목적으로만 사용하는 것이 좋습니다.

sslRequireValidMMSBackupServerCertificate=true

푸시 실시간 마이그레이션 설정

agentFeatureCloudMigrationEnabled

유형: 부울

선택 사항입니다.

마이그레이션 호스트의 MongoDB Agent가 소스 Ops Manager 배포에서 Atlas의 대상 클러스터로 실시간 마이그레이션 프로세스를 실행하도록 구성할지 여부를 지정합니다.

이 옵션의 기본값은 false이며, 이는 MongoDB Agent가 이 호스트에서 Atlas로의 실시간 마이그레이션을 사용하지 못하도록 합니다.

실시간 마이그레이션 프로세스를 활성화하려면 마이그레이션 호스트를 프로비저닝하고 agentFeatureCloudMigrationEnabled를 true로 설정합니다.

cloudMigrationOplogPath

유형: 문자열

선택 사항입니다.

oplog 파일의 경로입니다. 지정된 경우 이 설정은 초기 동기화 oplog 윈도우를 디스크에 버퍼링합니다. 지정된 디렉토리에 oplog 버퍼링을 위한 충분한 스토리지를 프로비저닝합니다.

외부 소스 구성 설정

enableLocalConfigurationServer

유형: 부울

MongoDB Agent가 MongoDB 프로세스 구성 파일을 디스크에 저장하는지 또는 메모리에 캐시하는지 여부를 지정합니다.

이 옵션의 기본값은 디스크에 구성 파일을 저장하는 false입니다. 이 옵션을 true로 설정하면 구성이 메모리에 캐시됩니다.

이 옵션을 true 로 설정하다 하면 MongoDB Agent 가 mmsConfigBackup 파일 을 쓰기 (write) 하지 않습니다.

MongoDB 데이터베이스에서 FCV 4.2 이하 버전을 실행하는 경우 이 옵션을 true 로 설정하지 마세요.

경고

이 옵션을 true로 설정하면 배포 가용성에 영향을 미칩니다.

이 기능이 활성화되면 MongoDB Agent는 MongoDB 프로세스 구성을 디스크에 저장하지 않습니다. Ops Manager 앱 서버를 사용할 수 없는 상태에서 MongoDB Agent가 다시 시작하려고 하면 필요한 구성 정보가 없기 때문에 MongoDB Agent의 실행이 중지됩니다. MongoDB Agent가 실행 중이지 않은 상태에서 MongoDB 프로세스가 작동을 멈추면, MongoDB Agent가 프로세스를 다시 시작할 수 없습니다.

enableLocalConfigurationServer=false

팁

다음도 참조하세요.

MongoDB Agent가 구성 파일 및 비밀번호를 관리하는 방법 구성

keepUnusedMongodbVersions

유형: 부울

MongoDB Agent 가 다운로드한 미사용 MongoDB 버전 바이너리를 보관하는지 여부를 나타내는 플래그입니다. 기본값 으로 keepUnusedMongodbVersions 은 false입니다.

keepUnusedMongodbVersions=false

localConfigurationServerPort

유형: integer

로컬 구성 서버를 사용할 때 MongoDB 프로세스 구성을 제공할 포트를 지정합니다. 이 옵션을 설정하려면 이enableLocalConfigurationServer 여야 true 합니다.

지정하지 않으면 MongoDB Agent가 사용 가능한 포트를 자동으로 선택합니다.

localConfigurationServerPort=20128

mmsApiKeyExec

유형: 문자열

Ops Manager 프로젝트의 Ops Manager 에이전트 API 키를 호출하는 셸 명령을 지정합니다.

mmsApiKeyExec=echo $myKey

sslMMSServerClientCertificatePasswordExec

유형: 문자열

중요

더 이상 사용되지 않습니다. 대신 tlsMMSServerClientCertificatePasswordExec 을(를) 사용하세요.

tlsMMSServerClientCertificatePasswordExec

유형: 문자열

MMSServerClientCertificate 파일 에서 비공개 키를 해독하는 데 필요한 비밀번호를 호출하는 shell 명령을 지정합니다. 클라이언트 인증서 PEM 파일 이 암호화됨 경우 이 설정 또는 tlsMMSServerClientCertificatePassword 가 필요합니다.

tlsMMSServerClientCertificatePasswordExec=python /path/to/PEMPassword.py

MongoDB Kerberos 설정

자동화가 Kerberos를 사용하여 호스트를 인증하는 경우 이 설정을 지정합니다. Kerberos를 구성하려면 Kerberos용 MongoDB Agent 구성을 참조하세요.

krb5ConfigLocation

유형: 문자열

Kerberos 구성 파일의 비시스템 표준 위치에 대한 절대 경로를 지정합니다.

krb5ConfigLocation=/path/to/krb_custom.conf

참고

MongoDB Ops Manager는 Kerberos 가 활성화되면 각 에이전트에 대한 Kerberos 자격 증명(티켓) 캐시를 자동으로 생성합니다. Kerberos 자격 증명 캐시 의 위치를 재정의하려는 경우 인 경우 에이전트를 실행하기 KRB5CCNAME 전에 환경 변수를 원하는 파일 이름 및 경로로 설정해야 합니다.

로그 설정

1. 탐색에서 Deployment를 클릭합니다.

2. Agents 탭을 클릭합니다.

3. Downloads & Settings를 클릭합니다.

4. Agent Log Settings 섹션에서 Monitoring Log Settings 옆에 있는 을(를) 클릭합니다.

5. 모니터링 로그 설정을 편집합니다:

   설정	기본값	콘솔 권장 값
   Linux 로그 파일 경로	/var/log/mongodb-mms-automation/monitoring-agent.log
   Windows 로그 파일 경로	%SystemDrive%\MMSAutomation\log\mongodb-mms-automation\monitoring-agent.log
   로그 로테이션	네
   크기 임계값(MB)	1000
   시간 임계값(시간)	24
   최대 비압축 파일		5
   디스크의 최대 비율		2
   총 로그 파일 수	0

6. Save를 클릭합니다.

사용자 지정 설정

1. 탐색에서 Deployment를 클릭합니다.

2. Agents 탭을 클릭합니다.

3. Downloads & Settings를 클릭합니다.

4. Custom Configuration 섹션에서 Edit Custom Configurations 옆에 있는 을(를) 클릭합니다.

5. 모니터링 구성 설정과 값을 입력합니다.

6. Save and Close를 클릭합니다.

다음과 같은 모니터링 설정을 구성할 수 있습니다.

로그 설정

1. 탐색에서 Deployment를 클릭합니다.

2. Agents 탭을 클릭합니다.

3. Downloads & Settings를 클릭합니다.

4. Agent Log Settings 섹션에서 Backup Log Settings 옆에 있는 을(를) 클릭합니다.

5. 백업 로그 설정을 편집합니다:

   설정	기본값	콘솔 권장 값
   Linux 로그 파일 경로	/var/log/mongodb-mms-automation/backup-agent.log
   Windows 로그 파일 경로	%SystemDrive%\MMSAutomation\log\mongodb-mms-automation\backup-agent.log
   로그 로테이션	네
   크기 임계값(MB)	1000
   시간 임계값(시간)	24
   최대 비압축 파일		5
   디스크의 최대 비율		2
   총 로그 파일 수	0

6. Save를 클릭합니다.

사용자 지정 설정

1. 탐색에서 Deployment를 클릭합니다.

2. Agents 탭을 클릭합니다.

3. Downloads & Settings를 클릭합니다.

4. Custom Configuration 섹션에서 Edit Custom Configurations 옆에 있는 을(를) 클릭합니다.

5. 백업 구성 설정과 값을 입력합니다.

6. Save and Close를 클릭합니다.

다음과 같은 백업 설정을 구성할 수 있습니다: