[#BloombergLP-balm-DefaultMetricsManager-create-06]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balm.adoc[balm]::xref:BloombergLP/balm/DefaultMetricsManager.adoc[DefaultMetricsManager]::create
:relfileprefix: ../../../
:mrdocs:

Create the default metrics manager that publishes to the specified `stream`.

== Synopsis

Declared in `<balm_defaultmetricsmanager.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
xref:BloombergLP/balm/MetricsManager.adoc[MetricsManager]*
create(
    std::ostream& stream,
    xref:BloombergLP/bslma/Allocator.adoc[bslma::Allocator]* basicAllocator = 0);
----

== Description

Create the default `MetricsManager` instance and configure it with a `StreamPublisher` that will publish recorded metrics to the specified `stream`, then return the address of the modifiable created metrics manager instance. Optionally specify `basicAllocator` to use to obtain memory. If `basicAllocator` is 0, the currently installed global allocator is used. The behavior is undefined unless `0 == MetricsManager::instance()` prior to calling this method, or if this method is called from one thread while another thread is attempting to access the default metrics manager instance (i.e., this method is _not_ thread‐safe).

== Return Value

address of the created default `MetricsManager` instance

== Parameters

[cols="1,4"]
|===
| Name| Description
| *stream*
| output stream to which recorded metrics are published
| *basicAllocator*
| memory allocator; null uses the default
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#