接続プールの監視

Overview

このガイドでは、Rust ドライバーを使用してドライバーの接続プールを監視する方法を説明します。 接続プールは、ドライバーが MongoDB インスタンスと維持するオープン コントロール プロトコル（TCP）接続のセットです。 接続プールを使用すると、アプリケーションで作成する必要がある新しい接続の数が減るため、アプリケーションの実行が高速化される可能性があります。

アプリケーション内の接続プールの変更に関する情報を使用することも、接続プールを監視して、ドライバーが接続を使用する方法の詳細を学習することもできます。

このガイドには、次のセクションが含まれています。

• イベントの説明では、ドライバーが生成できる接続プール イベントについて説明します。

• イベント サブスクリプションの例では、接続プール イベントをサブスクライブする方法を示すサンプル コードを提供します。

• サンプルイベント ドキュメントでは、各接続プール イベントのサンプルが提供されます。

• 追加情報では、このガイドで言及されている型とメソッドのリソースとAPIドキュメントへのリンクを提供します。

イベントの説明

次の接続プール イベントを監視できます。

イベント モニタリングの例

cmap_event_handlerクライアント オプションの値として EventHandlerインスタンスを割り当てることで、接続プール イベントを監視できます。 すべての接続プール イベントを処理する を構築するには、 メソッドまたはEventHandlercallback() async_callback()メソッドを使用します。

次の例では、MongoDB 配置に接続し、クライアントに接続プール イベントを監視するように指示して、各イベントを出力します。

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 への接続の詳細については、「 接続ガイド 」を参照してください。

アプリケーションのパフォーマンス向上の詳細については、パフォーマンスに関する考慮事項 のガイドを参照してください。