[#BloombergLP-balm-BdlmMetricsAdapter-registerCollectionCallback-02]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balm.adoc[balm]::xref:BloombergLP/balm/BdlmMetricsAdapter.adoc[BdlmMetricsAdapter]::registerCollectionCallback
:relfileprefix: ../../../
:mrdocs:

`registerCollectionCallback` overloads

== Synopses

Declared in `<balm_bdlmmetricsadapter.h>`

Register the specified `callback` with a monitoring system, using the specified `metricDescriptor` for the registration. Return the callback handle to be used with `removeCollectionCallback`. Note the information used for registration is implementation dependant, and may involve values computed from the supplied arguments.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
virtual
xref:BloombergLP/bdlm/MetricsAdapter/CallbackHandle.adoc[CallbackHandle]
xref:BloombergLP/bdlm/MetricsAdapter/registerCollectionCallback.adoc[registerCollectionCallback](
    xref:BloombergLP/bdlm/MetricDescriptor.adoc[MetricDescriptor] const& metricDescriptor,
    xref:BloombergLP/bdlm/MetricsAdapter/Callback.adoc[Callback] const& callback) = 0;
----

[.small]#xref:BloombergLP/bdlm/MetricsAdapter/registerCollectionCallback.adoc[_» more..._]#

Register the specified `callback` with the metrics manager specified at construction, using the specified `metricDescriptor`. If `metricDescriptor.metricsNamspace()` equals `bdlm::MetricDescriptor::k_USE_METRICS_ADAPTER_NAMESPACE_SELECTION`, use `defaultMetricNamespace()` for the namespace attribute during registration. If `metricDescriptor.objectIdentifier()` equals `bdlm::MetricDescriptor::k_USE_METRICS_ADAPTER_OBJECT_ID_SELECTION`, use the concatination of `defaultObjectIdentifierPrefix()`, a period, `metricDescriptor.objectTypeAbbreviation()`, a period, and `metricDescriptor.instanceNumber()` for the object identifier attribute during registration. The category name supplied to the `MetricsManager` provided at construction is the concatenation of the object type name attribute, a period, the metric name attribute, a period, and the object identifier attribute. Return the callback handle to be used with `removeCollectionCallback`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
virtual
xref:BloombergLP/bdlm/MetricsAdapter/CallbackHandle.adoc[CallbackHandle]
xref:BloombergLP/balm/BdlmMetricsAdapter/registerCollectionCallback-00.adoc[registerCollectionCallback](
    xref:BloombergLP/bdlm/MetricDescriptor.adoc[bdlm::MetricDescriptor] const& metricDescriptor,
    xref:BloombergLP/bdlm/MetricsAdapter/Callback.adoc[Callback] const& callback) override;
----

[.small]#xref:BloombergLP/balm/BdlmMetricsAdapter/registerCollectionCallback-00.adoc[_» more..._]#


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