Struct PoolBuilder 

pub struct PoolBuilder<DB: Database> { /* private fields */ }

Builder for constructing an instrumented Pool from a raw sqlx::Pool.

The builder auto-extracts connection attributes (host, port, namespace) from the pool’s connect options via the Database trait, then allows overriding any of them before calling build().

Example

let pool = PoolBuilder::from(sqlx_pool)
    .with_database("my_db")
    .build();

Implementations

impl<DB: Database> PoolBuilder<DB>

pub fn with_database(self, database: impl Into<String>) -> Self

Override the db.namespace attribute (the database name).

pub fn with_host(self, host: impl Into<String>) -> Self

Override the server.address attribute (the logical hostname).

pub fn with_port(self, port: u16) -> Self

Override the server.port attribute.

pub fn with_network_peer_address(self, address: impl Into<String>) -> Self

Set the network.peer.address attribute (the resolved IP address).

pub fn with_network_peer_port(self, port: u16) -> Self

Set the network.peer.port attribute (the resolved port).

pub fn with_query_text_mode(self, mode: QueryTextMode) -> Self

Configure how db.query.text is captured on spans. Defaults to QueryTextMode::Full.

pub fn with_pool_name(self, name: impl Into<String>) -> Self

Set the db.client.connection.pool.name attribute.

When a runtime feature (e.g. runtime-tokio) is also enabled, a background task is spawned that periodically records db.client.connection.count (idle/used). See with_pool_metrics_interval to configure the polling frequency.

pub fn with_pool_metrics_interval(self, interval: Duration) -> Self

Set the polling interval for db.client.connection.count. Defaults to 10 seconds.

Has no effect unless with_pool_name is also called and a runtime feature is enabled.

pub fn build(self) -> Pool<DB>

Consume the builder and produce an instrumented Pool.

Trait Implementations

impl<DB: Debug + Database> Debug for PoolBuilder<DB>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<DB: Database> From<Pool<DB>> for PoolBuilder<DB>

fn from(pool: Pool<DB>) -> Self

Create a builder from an existing sqlx::Pool, auto-extracting connection attributes from the backend’s connect options.