서버 설정

이 페이지의 내용

개요

서버 설정 구성

개요

이 가이드 에서는 Java 운전자 서버 설정을 관리하는 방법에 대해 학습 수 있습니다.

서버 설정 구성

서버 와 상호 작용할 때 드라이버의 동작을 수정하려면 연결 문자열 에 다음 매개 변수를 포함하세요.

옵션 이름	유형	설명
`appName`	문자열	연결 핸드셰이크 중에 MongoDB 인스턴스에 제공되는 애플리케이션의 이름을 지정합니다. 서버 로그 및 프로파일링에 사용할 수 있습니다. 기본값: `null`
`serverMonitoringMode`	문자열	드라이버가 사용하는 서버 모니터링 프로토콜을 지정합니다. `auto`로 설정하면 드라이버가 실행되는 환경에 따라 모니터링 모드가 결정됩니다. 드라이버는 FaaS(Function-as-a-Service) 환경에서 `poll` 모드를 사용하고 다른 환경에서는 `stream` 모드를 사용합니다. 기본값: `auto`
`heartbeatFrequencyMS`	integer	클러스터에 있는 각 서버의 현재 상태를 확인하기 위해 드라이버가 대기하는 빈도(밀리초)를 지정합니다. 기본값: `10000`(10초)

이 예시 클러스터 모니터 15 초마다 서버 에 연결을 시도하도록 지정합니다.

ConnectionString connectionString = "mongodb://<host>:<port>/?heartbeatFrequencyMS=15000"
MongoClient mongoClient = MongoClients.create(connectionString)

이러한 매개변수에 대한 자세한 내용은 ConnectionString API 문서를 참조하세요.

각 MongoDB 배포를 모니터링할 때 드라이버의 동작을 수정하기 위해 applyToServerSettings() 메서드를 체인으로 연결합니다.

다음 표에서는 설정을 연결하여 드라이버 동작을 수정할 수 있는 방법을 설명합니다.

메서드	설명
`addServerListener()`	서버 관련 이벤트에 대한 리스너를 추가합니다.
`addServerMonitorListener()`	서버 모니터 관련 이벤트에 대한 수신자(listener)를 추가합니다.
`applySettings()`	`ServerSettings` 객체에 지정된 서버 설정을 사용합니다.
`heartbeatFrequency()`	cluster 모니터가 서버에 연결을 시도하는 간격을 설정합니다. 기본값: `10 seconds`
`minHeartbeatFrequency()`	서버 모니터링 확인의 최소 간격을 설정합니다. 기본값: `500 milliseconds`

이 예시에서는 MongoDB 배포에서 다음과 같은 드라이버 동작을 지정합니다:

서버 모니터링 확인의 최소 간격은 다음과 같아야 합니다. 700 MILLISECONDS
cluster 모니터는 서버마다 연결을 시도합니다. 15 SECONDS

MongoClient mongoClient = MongoClients.create(
    MongoClientSettings.builder().applyConnectionString(new ConnectionString("<your connection string>"))
    .applyToServerSettings(builder ->
        builder.minHeartbeatFrequency(700, MILLISECONDS)
        .heartbeatFrequency(15, SECONDS))
    .build());

연결된 메서드에 대한 자세한 내용은 MongoClientSettings.Builder API 설명서를 참조하세요.

돌아가기

클러스터 설정

소켓 설정