연결 풀 모니터링

개요

이 가이드에서는 Rust 드라이버를 사용하여 드라이버의 연결 풀을 모니터링하는 방법을 보여줍니다. 연결 풀은 드라이버가 MongoDB 인스턴스를 사용해 유지 관리하는 개방형 전송 제어 프로토콜(TCP) 연결의 집합입니다. 연결 풀은 애플리케이션이 생성해야 하는 새로운 연결 수를 줄이는 데 도움이 되므로 애플리케이션이 더 빠르게 실행될 수 있습니다.

애플리케이션에서 연결 풀의 변경 사항에 대한 정보를 사용하거나 연결 풀을 모니터링하여 드라이버가 연결을 사용하는 방식에 대해 자세히 알아볼 수 있습니다.

이 가이드에는 다음 섹션이 포함되어 있습니다.

• 이벤트 설명 에서는 운전자 가 생성할 수 있는 연결 풀 이벤트에 대해 설명합니다.

• 이벤트 구독 예제 에서는 연결 풀 이벤트를 구독 하는 방법을 보여주는 샘플 코드를 제공합니다.

• 예제 이벤트 문서 는 각 연결 풀 이벤트 의 샘플을 제공합니다.

• 추가 정보 에서는 이 가이드 에 언급된 유형 및 메서드에 대한 리소스 및 API 문서 링크를 제공합니다.

이벤트 설명

다음 연결 풀 이벤트를 모니터 할 수 있습니다.

이벤트 모니터링 예시

EventHandler 인스턴스 를 cmap_event_handler 클라이언트 옵션의 값으로 할당하여 연결 풀 이벤트를 모니터 할 수 있습니다. 모든 연결 풀 이벤트를 처리하는 EventHandler 을 구성하려면 callback() 또는 async_callback() 메서드를 사용합니다.

다음 예시 에서는 MongoDB deployment 에 연결하여 연결 풀 이벤트를 모니터 하도록 클라이언트 에 지시하고 각 이벤트 를 출력합니다.

let mut client_options = ClientOptions::parse("<connection string>").await?;
client_options.cmap_event_handler = Some(EventHandler::callback(|ev| println!("{:?}", ev)));
let client = Client::with_options(client_options)?;
// ... perform actions with the client to generate events

이벤트 문서 예시

다음 섹션에서는 각 유형의 연결 풀 모니터링 이벤트에 대한 샘플 출력을 보여줍니다.

PoolCreatedEvent {
  address: ...,
  options: {...}
}

PoolReadyEvent {
  address: ...
}

PoolClearedEvent {
  address: ...,
  service_id: ...,
}

PoolClosedEvent {
  address: ...
}

ConnectionCreatedEvent {
  address: ...,
  connection_id: 1
}

ConnectionReadyEvent {
  address: ...,
  connection_id: 1
}

ConnectionClosedEvent {
  address: ...,
  connection_id: 1,
  reason: ...,
  /* private fields */
}

ConnectionCheckOutStartedEvent {
  address: ...,
}

ConnectionCheckOutFailedEvent {
  address: ...,
  reason: ...,
  /* private fields */
}

ConnectionCheckedOutEvent {
  address: ...,
  connection_id: 1
}

ConnectionCheckedInEvent {
  address: ...,
  connection_id: 1
}

추가 정보

MongoDB 배포 모니터링에 대해 자세히 알아보려면 MongoDB를 모니터링하는 방법 문서를 참조하세요.

MongoDB 연결에 학습 보려면 연결 가이드를 참조하세요.

애플리케이션 성능 개선에 대한 자세한 내용은 성능 고려 사항 가이드를 참조하세요.