[#BloombergLP-balm-MetricsManager-setAllCategoriesEnabled]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balm.adoc[balm]::xref:BloombergLP/balm/MetricsManager.adoc[MetricsManager]::setAllCategoriesEnabled
:relfileprefix: ../../../
:mrdocs:

Set whether each category currently registered with `metricRegistry()` is enabled to the specified `value`, and ensure that categories registered after this call are initialized as either enabled or disabled, accordingly. If a category is disabled it will not be published (see the `publish` methods), and higher level components may not record values for metrics belonging to the category (for an example, see the `balm_metric` documentation). This operation is logically equivalent to iterating over the list of categories currently registered with `metricRegistry()` and calling `setCategoryEnabled` on each category individually, and also setting a default `isEnabled()` value (for newly‐created categories). Hence, subsequent calls to `setCategoryEnabled` will override this value for a particular category. Note that this operation is thread‐safe, but _not_ atomic: Other threads may simultaneously access the current enabled status for a category while this operation completes. Also note that this operation has _linear_ runtime performance with respect to the total number of category holders registered with `metricRegistry()` (see `balm_metricregistry` and `balm_category` for information on category holders).

== Synopsis

Declared in `<balm_metricsmanager.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
setAllCategoriesEnabled(bool value);
----


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