unit property

The unit in which the metric value is reported. It is only applicable if the value_type is INT64, DOUBLE, or DISTRIBUTION. The supported units are a subset of The Unified Code for Units of Measure standard:

Basic units (UNIT)

• bit bit
• By byte
• s second
• min minute
• h hour
• d day

Prefixes (PREFIX)

• k kilo (10**3)
• M mega (10**6)
• G giga (10**9)
• T tera (10**12)
• P peta (10**15)
• E exa (10**18)
• Z zetta (10**21)
• Y yotta (10**24)
• m milli (10**-3)
• u micro (10**-6)
• n nano (10**-9)
• p pico (10**-12)
• f femto (10**-15)
• a atto (10**-18)
• z zepto (10**-21)
• y yocto (10**-24)
• Ki kibi (2**10)
• Mi mebi (2**20)
• Gi gibi (2**30)
• Ti tebi (2**40)

Grammar

The grammar also includes these connectors:

• / division (as an infix operator, e.g. 1/s).
• . multiplication (as an infix operator, e.g. GBy.d)

The grammar for a unit is as follows:

 Expression = Component { "." Component } { "/" Component } ;

 Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
           | Annotation
           | "1"
           ;

 Annotation = "{" NAME "}" ;

Notes:

• Annotation is just a comment if it follows a UNIT and is equivalent to 1 if it is used alone. For examples, {requests}/s == 1/s, By{transmitted}/s == By/s.
• NAME is a sequence of non-blank printable ASCII characters not containing '{' or '}'.
• 1 represents dimensionless value 1, such as in 1/s.
• % represents dimensionless value 1/100, and annotates values giving a percentage.