SYNOPSIS¶

bool
mongoc_client_pool_set_structured_log_opts (mongoc_client_pool_t *pool,


                                            const mongoc_structured_log_opts_t *opts);

Reconfigures this client pool's structured logging subsystem. See Structured Logging <>.

The mongoc_structured_log_opts_t <> is copied by the pool and may be safely destroyed by the caller after this API call completes. The application is responsible for ensuring any user_data referenced by opts remains valid for the lifetime of the pool.

By default, the mongoc_client_pool_t <> will have log options captured from the environment during mongoc_client_pool_new() <>. See mongoc_structured_log_opts_new() <> for a list of the supported options.

The structured logging subsystem may be disabled by passing NULL as opts or equivalently by passing NULL as the mongoc_structured_log_func_t <> in mongoc_structured_log_opts_set_handler() <>.

PARAMETERS¶

RETURNS¶

Returns true when used correctly. If called multiple times per pool or after the first client is initialized, returns false and logs a warning.

THREAD SAFETY¶

This function can only be called once on a pool, and must be called before the first call to mongoc_client_pool_pop() <>.

Thread safety within the handler is the application's responsibility. Handlers may be invoked concurrently by multiple pool users.

See also:

Structured Logging <>

Author¶

MongoDB, Inc

Copyright¶

2009-present, MongoDB, Inc.