Metrics Units

Metrics Units

Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel, n'hésitez pas à nous contacter.

Overview

Metric units are displayed 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. Units must be specified manually, but if no unit is set, order-of-magnitude notation (for example: K, M, and G for thousands, millions, and billions, respectively) is used. If a unit is set, the raw data is automatically converted to readable display units using their relevant orders of magnitude.

For example, if you have a data point that is 3,000,000,000:

  • If you haven’t specified a unit for this data point, “3G” is displayed.
  • If you specified this data point is in bytes, “3GB” is displayed.

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:

type unit(s)
BYTES bit / byte / kibibyte / mebibyte / gibibyte / tebibyte / pebibyte / exbibyte
TIME nanosecond / microsecond / millisecond / second / minute / hour / day / week
PERCENTAGE percent_nano / percent / apdex / fraction
NETWORK connection / request / packet / segment / response / message / payload / timeout / datagram / route / session / hop
SYSTEM process / thread / host / node / fault / service / instance / cpu
DISK file / inode / sector / block
GENERAL buffer / 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
DB table / index / lock / transaction / query / row / key / command / offset / record / object / cursor / assertion / scan / document / shard / flush / merge / refresh / fetch / column / commit / wait / ticket / question
CACHE hit / miss / eviction / get / set
MONEY dollar / cent / microdollar / euro
MEMORY page / split
FREQUENCY hertz / kilohertz / megahertz / gigahertz
LOGGING entry
TEMPERATURE decidegree celsius / degree celsius / degree fahrenheit
CPU nanocore / microcore / millicore / core / kilocore / megacore / gigacore / teracore / petacore / exacore
POWER nanowatt / microwatt / milliwatt / deciwatt / watt / kilowatt / megawatt / gigawatt / terrawatt
CURRENT milliampere / ampere
POTENTIAL millivolt / volt
APM span
SYNTHETICS run

Number formatting

Unitless formatting

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

Examples

Raw value Formatted
1 1
2.7182818284 2.72
1337 1.34K
31536000 31.54M
4294967296 4.29G
18446744073709552000 2e19
0.001 1e-3
2.3283064365386963e-10 2e-10
invalid N/A

Unit handling

Units are automatically formatted on your graphs for readability.

Examples

Unit Family Raw Value Formatted
byte bytes 1 1 B
kibibyte bytes 1234235 1.18 GiB
kibibyte bytes 45457878236741230000 40374.71 EiB
hertz frequency 6345223 6.35 MHz
cent money 1337 13.37 $
nanosecond time 0 0s
second time 0.03212 32.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.
  • Long times are formatted as days in decimal form.

Examples

Raw seconds Formatted
0.00123 1.23ms
0.00012345 123.45μs (microseconds)
1.2345e-9 1.23ns
95 1m 35s
3671 1h 1m
86390 1d
96400 1d 3h
52596400 608.75 days

Further Reading

Documentation, liens et articles supplémentaires utiles: