This class provides a mechanism for describing a metric. A MetricDescription holds the category to which the metric belongs, and a null-terminated string containing the name of the metric.
Declared in <balm_metricdescription.h>
class MetricDescription;| Name | Description |
|---|---|
UserDataKey | A key used to refer to a data value associated with a metric. Note that a UserDataKey can be used by clients of balm to associate additional information with a metric. See balm_metricregistry for information on obtaining a unique key. |
| Name | Description |
|---|---|
MetricDescription [constructor] | Create a metric description for the specified category and the specified name. Optionally specify a basicAllocator used to supply memory. If basicAllocator is 0, the currently installed default allocator is used. The initial value for preferredPublicationType is e_UNSPECIFIED, and the initial value for format is 0. The behavior is undefined unless name and category remain valid, and the contents of name remain unmodified, for the lifetime of this object. |
category | Return the address of the non-modifiable category object indicating the category of the metric described by this object. |
format | Return a shared pointer to the non-modifiable format for this metric description. Note that the returned shared pointer may be null if a format has not been provided for the described metric. |
name | Return the address of the non-modifiable, null-terminated string containing the name of the described metric. |
preferredPublicationType | Return the preferred publication type of this metric. The preferred publication type of this metric indicates the preferred aggregate to publish for this metric, or PublicationType::UNSPECIFIED if there is no preference. Note that there is no uniform definition for how publishers will interpret this value; an UNSPECIFIED value generally indicates that the all the collected aggregates (total, count, minimum, and maximum value) should be published. |
print | Print the category and name of this metric description to the specified output stream in some single-line human-readable form, and return a reference to the modifiable stream. |
printDescription | Print the properties of this metric description to the specified output stream in some single-line human-readable form, and return a reference to the modifiable stream. |
setCategory | Set the category of this metric description to the object at the specified category address. The behavior is undefined unless category remains valid for the lifetime of this object. |
setFormat | Set the format for this metric description to the specified format. |
setName | Set the name of this metric description to the specified name. The behavior is undefined unless the contents of name remains valid and unmodified for the lifetime of this object. |
setPreferredPublicationType | Set the preferred publication type of this metric to the specified type. The preferred publication type of this metric indicates the preferred aggregate to publish for this metric, or PublicationType::UNSPECIFIED if there is no preference. Note that there is no uniform definition for how publishers will interpret this value; an UNSPECIFIED value generally indicates that all the collected aggregates (total, count, minimum, and maximum value) should be published. |
setUserData | Associate the specified value with the specified data key. The behavior is undefined unless key >= 0. Note that this method allows clients of balm to associate (opaque) application-specific information with a metric. |
userData | Return the non-modifiable value associated with the specified user-data key. If the data for key has not been set, a value of 0 is returned, which is indistinguishable from a valid key with a 0 value. The behavior is undefined unless key >= 0. Note that this method allows clients of balm to access the (opaque) application-specific information that they have previously associated with a metric (via setUserData). |