Getting detailed information about a counter helps you understand and process the information you get from a stats command.
- Enter the following command:
stats explain counters object_name [counter_name]
- object_name is the name of the object the counter is associated with.
- counter_name is the name of the counter you want more details about. If counter_name is omitted, information about all counters on the specified object is returned.
The following fields are returned for every specified counter:
The Properties field describes the type of information that is returned by this counter. Properties include the following types:
- percent for values that are a percentage value, such as cpu_busy
- rate for values that describe a value per time, such as disk_data_read
- average for values that return an average, such as write_latency
- raw for simple values that have no type, such as num_processors
The Unit field describes how value returned by this counter can be interpreted. The Unit field can be in one of the following groups of values:
- percent for counters with a Properties of percent
- The unit per time period for counters with a Properties of rate, such as kb_per_sec or per_sec.
- The time unit for counters that return timing values, such as write_latency
Example of stats explain counters command
toaster> stats explain counters system cpu_busy
Counters for object name: system
Description: Percentage of time one or more processors is busy in the system