메트릭 단위
메트릭 단위 (Metrics Units)
메트릭 단위는 타임시리즈 그래프, 쿼리 값 위젯, top list 같은 곳에 표시돼요. 그래프에 마우스를 올리면 해당 메트릭의 단위를 볼 수 있고, 전체 화면 모드에서는 그래프 하단에 단위가 표시됩니다.
단위는 수동으로 지정해야 하지만, 단위가 설정되어 있지 않으면 자릿수 표기(예: k, M, G)가 사용돼요. 단위가 설정되면 원시 데이터가 관련 자릿수를 사용해 읽기 쉬운 표시 단위로 자동 변환됩니다.
출처: 문서
본문
개요 (Overview)
메트릭 단위는 타임시리즈 그래프, 쿼리 값 위젯, top list 같은 곳에 표시됩니다.
타임시리즈 그래프에서는 아무 그래프에나 커서를 올리면 관련 단위를 볼 수 있어요. 단위는 수동으로 지정해야 하지만, 단위가 설정되지 않으면 자릿수 표기(예: 수천, 수백만, 수십억에 대해 각각 k, M, G)가 사용됩니다. 단위가 설정되면 원시 데이터가 그 관련 자릿수를 사용해 읽기 쉬운 표시 단위로 자동 변환됩니다.
예를 들어 3,000,000,000인 데이터포인트가 있다면:
- 이 데이터포인트에 단위를 지정하지 않았다면 "3G"가 표시됩니다.
- 이 데이터포인트가 bytes라고 지정했다면 "3GB"가 표시됩니다.
기본 제공 통합이 제공하는 메트릭의 경우, 해당 통합의 Data Collected 표를 보고 단위가 이미 정의되어 있는지 확인할 수 있어요: Shown as <unit>로 표시된 메트릭 이름은 통합이 단위를 설정한 것입니다. 이 표기가 없는 메트릭은 기본적으로 구성된 단위가 없으므로, 아래 단계로 수동으로 설정해야 합니다.
그래프 오른쪽 위의 전체 화면 버튼을 클릭하면 하단에 표시되는 단위를 볼 수 있어요.
메트릭 그래프에서 컨텍스트 메뉴(세로 점 3개)를 클릭해 Metrics Info 옵션을 찾으세요. 이 옵션은 메트릭 설명이 있는 패널을 열어 줍니다. 이 패널에서 메트릭 이름을 클릭하면 추가 분석이나 편집을 위해 메트릭 요약 페이지에서 메트릭이 열립니다.
메트릭 단위를 변경하려면 메트릭 요약 페이지로 이동해 메트릭을 선택하세요. Metadata 아래의 Edit을 클릭하고 드롭다운 메뉴에서 bit나 byte 같은 단위를 선택합니다.
단위 목록 (Unit list)
다음 단위가 Datadog에 제출된 메트릭과 연관될 수 있어요.
| 유형 | 단위 |
|---|---|
| BYTES | bit / byte (b) / kibibyte(KiB) / mebibyte (MiB) / gibibyte (GB) / tebibyte (TiB) / pebibyte (PiB) / exbibyte (EiB) |
| TIME | nanosecond (ns) / microsecond (μs) / millisecond (ms) / second (s) / minute (min) / hour (hr) / day / week (wk) |
| PERCENTAGE | percent_nano (n%) / percent (%) / apdex / fraction |
| NETWORK | connection (conn) / request (req) / packet (pkt) / segment (seg) / response (rsp) / message (msg) / payload / timeout / datagram / route / session / hop |
| SYSTEM | process (proc) / thread / host / node / fault / service (svc) / instance / cpu |
| DISK | file / inode / sector / block (blk) |
| GENERAL | buffer / error (err) / read (rd) / write (wr) / occurrence / event / time / unit / operation (op) / item / task / worker / resource (res) / garbage collection (gc) / email / sample (smpl) / stage / monitor / location / check / attempt / device (dev) / update (up) / method (mthd) / job / container / execution / throttle / invocation / user / success / build / prediction / exception |
| DB | table / index (idx) / lock / transaction (tx) / query / row / key / command (cmd) / offset / record / object / cursor / assertion (assert) / scan / document / shard / flush / merge / refresh / fetch / column (col) / commit / wait / ticket / question |
| CACHE | hit / miss / eviction / get / set |
| MONEY | dollar ($) / cent (¢) / microdollar (μ$) / euro (€) / pound (£) / pence (p) / yen (¥) |
| MEMORY | page (pg) / split |
| FREQUENCY | hertz (Hz) / kilohertz (kHz) / megahertz (MHz) / gigahertz (GHz) |
| LOGGING | entry |
| TEMPERATURE | decidegree celsius (d°C) / degree celsius (°C) / degree fahrenheit (°F) |
| CPU | nanocore (ncores) / microcore (μcores) / millicore (mcores) / core / kilocore (Kcores) / megacore (Mcores) / gigacore (Gcores) / teracore (Tcores) / petacore (Pcores) / exacore (Ecores) |
| POWER | nanowatt (nW) / microwatt (μW) / milliwatt (mW) / deciwatt (dW) / watt / kilowatt / megawatt / gigawatt / terrawatt |
| CURRENT | milliampere (mA) / ampere (A) |
| POTENTIAL | millivolt (mV) / volt (V) |
| APM | span |
| SYNTHETICS | run / step |
숫자 서식 (Number formatting)
단위 없는 서식 (Unitless formatting)
단위가 없는 메트릭에 대해 Datadog은 SI 접두사 k, M, G, T를 사용해요. T 이후에는 숫자가 지수 표기로 변환되며, 이는 아주 작은 숫자에도 사용됩니다. 기본적으로 Datadog은 소수 둘째 자리로 반올림해요. 지수 표기의 기본값은 소수점 이하 0자리입니다.
예시 (Examples)
| 원시 값 | 서식화 |
|---|---|
| 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)
단위는 가독성을 위해 그래프에서 자동으로 서식화됩니다. 단위가 어떻게 표시되는지 커스터마이즈하려면 단위 오버라이드로 시각화 커스터마이즈하기를 참고하세요.
예시 (Examples)
| 단위 | 패밀리 | 원시 값 | 서식화 |
|---|---|---|---|
| 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)
1분에서 1년 사이의 시간 단위는 더 사람이 읽기 쉽도록 여러 단위로 나뉘어요. 다음 규칙이 적용됩니다.
- 짧은 시간은 십진수 형태로 서식화됩니다.
- 가장 작은 시간 단위는 나노초(nanoseconds)예요.
- 긴 시간은 일(day) 단위의 십진수 형태로 서식화됩니다.
예시 (Examples)
| 원시 초 | 서식화 |
|---|---|
| 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 |