Metrics Units

Metrics Units

Overview

Metric units are displayed automatically in places such as on timeseries graphs, query value widgets, and top lists.

On timeseries graphs, you can hover your cursor over any graph to see the relevant units. The raw data is automatically converted to readable display units such as fractions of a second (ms) and millions of bytes per second (MiB/s).

Units are also displayed at the bottom of timeboard graphs, and metric descriptions are available by selecting Metrics Info from the gear dropdown:

To change a metric unit, navigate to the metric summary page and select a metric. Click Edit under Metadata and select a unit, such as bit or byte from the dropdown menu.

Unit list

The following units may be associated with metrics submitted to Datadog:

typeunit(s)
BYTESbit / byte / kibibyte / mebibyte / gibibyte / tebibyte / pebibyte / exbibyte
TIMEnanosecond / microsecond / millisecond / second / minute / hour / day / week
PERCENTAGEpercent_nano / percent / apdex / fraction
NETWORKconnection / request / packet / segment / response / message / payload / timeout / datagram / route / session
SYSTEMprocess / thread / host / node / fault / service / instance / cpu
DISKfile / inode / sector / block
GENERALbuffer / error / read / write / occurrence / event / time / unit / operation / item / task / worker / resource / garbage collection / email / sample / stage / monitor / location / check / attempt / device / update / method / job / container / execution / throttle / invocation / user / success / build / prediction / exception
DBtable / index / lock / transaction / query / row / key / command / offset / record / object / cursor / assertion / scan / document / shard / flush / merge / refresh / fetch / column / commit / wait / ticket / question
CACHEhit / miss / eviction / get / set
MONEYdollar / cent / microdollar / euro
MEMORYpage / split
FREQUENCYhertz / kilohertz / megahertz / gigahertz
LOGGINGentry
TEMPERATUREdecidegree celsius / degree celsius / degree fahrenheit
CPUnanocore / microcore / millicore / core / kilocore / megacore / gigacore / teracore / petacore / exacore
POWERnanowatt / microwatt / milliwatt / deciwatt / watt / kilowatt / megawatt / gigawatt / terrawatt
CURRENTmilliampere / ampere
POTENTIALmillivolt / volt
APMspan
SYNTHETICSrun

Number formatting

Unitless formatting

For unitless metrics, Datadog uses the SI suffixes K, M, G, and T. After T, numbers are converted to exponential notation, which is also used for very small numbers. By default, Datadog rounds to two decimal places. For exponential notation, the default is zero decimal places.

Examples

Raw valueFormatted
11
2.71828182842.72
13371.34K
3153600031.54M
42949672964.29G
184467440737095520002e19
0.0011e-3
2.3283064365386963e-102e-10
invalidN/A

Unit handling

Units are automatically formatted on your graphs for readability.

Examples

UnitFamilyRaw ValueFormatted
bytebytes11 B
kibibytebytes12342351.18 GiB
kibibytebytes4545787823674123000040374.71 EiB
hertzfrequency63452236.35 MHz
centmoney133713.37 $
nanosecondtime00s
secondtime0.0321232.12ms

Time formatting

Time units between a minute and a year are split into multiple units to be more human-readable. The following conventions apply:

  • Short times are formatted in decimal form.
  • The smallest time unit is nanoseconds.
  • Very long times are formatted as days in decimal form.

Examples

Raw secondsFormatted
0.001231.23ms
0.00012345123.45μs (microseconds)
1.2345e-91.23ns
951m 35s
36711h 1m
863901d
964001d 3h
52596400608.75 days

Further Reading

Additional helpful documentation, links, and articles: