[#BloombergLP-balm-MetricsManager-publish-03a]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balm.adoc[balm]::xref:BloombergLP/balm/MetricsManager.adoc[MetricsManager]::publish
:relfileprefix: ../../../
:mrdocs:

Publish metrics associated with the specified `category` if `category` is enabled; otherwise (if `category` is not enabled) this method has no effect. Optionally specify a `resetFlag` that determines if the collected metrics are reset as part of this operation. If `category` is enabled (i.e., `category‐>isEnabled()` is `true`), this operation will collect aggregated metric values for `category` from any registered callbacks as well as from its own `CollectorRepository`, and then publish those records using any publishers associated with `category`. If `resetFlag` is `true`, the metrics being collected are reset to their default state. The metrics manager provides publishers the time interval over which the published metrics were collected. This interval is computed as the elapsed time since the last time the `category` was reset (either through a call to the `publish` or `collectSample` methods). If `category` has not previously been reset then this interval is taken to be the elapsed time since the creation of this metrics manager. Note that the alternative `publish` methods that publish multiple categories in a single invocation are more efficient than publishing a sequence of categories individually.

== Synopsis

Declared in `<balm_metricsmanager.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
publish(
    xref:BloombergLP/balm/Category.adoc[Category] const* category,
    bool resetFlag = true);
----


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