ARM 4.0 numeric id metric [ARM 4.0 Metrics]

A numeric ID is a numeric value that is used as an identifier, and not as a measurement value. More...

Typedefs
typedef arm_int32_t	arm_metric_numericID32_t
	32-bit integer metric numeric id type
typedef arm_int64_t	arm_metric_numericID64_t
	64-bit integer metric numeric id type

---

Detailed Description

A numeric ID is a numeric value that is used as an identifier, and not as a measurement value.

Examples are message numbers and error codes.

Numeric IDs are classified as non-calculable because it doesn't make sense to perform arithmetic with them. For example, the mean of the last seven message numbers would hardly ever provide useful information. By using a data type of numeric ID instead of a gauge or counter, the application indicates that arithmetic with the numbers is probably nonsensical. An agent could create statistical summaries based on these values, such as generating a frequency histogram by part number or error number.

ARM supports two numeric ID types:

• ARM_METRIC_FORMAT_NUMERICID32
• ARM_METRIC_FORMAT_NUMERICID64

Processing multiple values of the same numeric id

The last value passed when any of the arm_start_transaction(), arm_update_transaction(), or arm_stop_transaction() calls is made will be the value attributed to the transaction instance. For example, if a value is valid at arm_start_transaction() but not when any arm_update_transaction() or arm_stop_transaction() executes, the value passed at the arm_start_transaction() is used. If a value is valid when arm_start_transaction() executes and when arm_stop_transaction() executes, the value when arm_stop_transaction() executes is the value for the transaction instance. This convention is identical to the string convention.