175 lines
6.1 KiB
Markdown
175 lines
6.1 KiB
Markdown
---
|
|
stage: Monitor
|
|
group: APM
|
|
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers
|
|
---
|
|
|
|
# Unit formats reference
|
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/201999) in GitLab 12.9.
|
|
|
|
You can select units to format your charts by adding `format` to your
|
|
[axis configuration](prometheus.md#dashboard-yaml-properties).
|
|
|
|
## Internationalization and localization
|
|
|
|
Currently, your [internationalization and localization options](https://en.wikipedia.org/wiki/Internationalization_and_localization) for number formatting are dependent on the system you are using i.e. your OS or browser.
|
|
|
|
## Engineering Notation
|
|
|
|
For generic or default data, numbers are formatted according to the current locale in [engineering notation](https://en.wikipedia.org/wiki/Engineering_notation).
|
|
|
|
While an [engineering notation exists for the web](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat), GitLab uses a version based off the [scientific notation](https://en.wikipedia.org/wiki/Scientific_notation). GitLab formatting acts in accordance with SI prefixes. For example, using GitLab notation, `1500.00` becomes `1.5k` instead of `1.5E3`. Keep this distinction in mind when using the engineering notation for your metrics.
|
|
|
|
Formats: `engineering`
|
|
|
|
SI prefixes:
|
|
|
|
| Name | Symbol | Value |
|
|
| ---------- | ------- | -------------------------- |
|
|
| `yotta` | Y | 1000000000000000000000000 |
|
|
| `zetta` | Z | 1000000000000000000000 |
|
|
| `exa` | E | 1000000000000000000 |
|
|
| `peta` | P | 1000000000000000 |
|
|
| `tera` | T | 1000000000000 |
|
|
| `giga` | G | 1000000000 |
|
|
| `mega` | M | 1000000 |
|
|
| `kilo` | k | 1000 |
|
|
| `milli` | m | 0.001 |
|
|
| `micro` | μ | 0.000001 |
|
|
| `nano` | n | 0.000000001 |
|
|
| `pico` | p | 0.000000000001 |
|
|
| `femto` | f | 0.000000000000001 |
|
|
| `atto` | a | 0.000000000000000001 |
|
|
| `zepto` | z | 0.000000000000000000001 |
|
|
| `yocto` | y | 0.000000000000000000000001 |
|
|
|
|
**Examples:**
|
|
|
|
| Data | Displayed |
|
|
| --------------------------------- | --------- |
|
|
| `0.000000000000000000000008` | 8y |
|
|
| `0.000000000000000000008` | 8z |
|
|
| `0.000000000000000008` | 8a |
|
|
| `0.000000000000008` | 8f |
|
|
| `0.000000000008` | 8p |
|
|
| `0.000000008` | 8n |
|
|
| `0.000008` | 8μ |
|
|
| `0.008` | 8m |
|
|
| `10` | 10 |
|
|
| `1080` | 1.08k |
|
|
| `18000` | 18k |
|
|
| `18888` | 18.9k |
|
|
| `188888` | 189k |
|
|
| `18888888` | 18.9M |
|
|
| `1888888888` | 1.89G |
|
|
| `1888888888888` | 1.89T |
|
|
| `1888888888888888` | 1.89P |
|
|
| `1888888888888888888` | 1.89E |
|
|
| `1888888888888888888888` | 1.89Z |
|
|
| `1888888888888888888888888` | 1.89Y |
|
|
| `1888888888888888888888888888` | 1.89e+27 |
|
|
|
|
## Numbers
|
|
|
|
For number data, numbers are formatted according to the current locale.
|
|
|
|
Formats: `number`
|
|
|
|
**Examples:**
|
|
|
|
| Data | Displayed |
|
|
| ---------- | --------- |
|
|
| `10` | 1 |
|
|
| `1000` | 1,000 |
|
|
| `1000000` | 1,000,000 |
|
|
|
|
## Percentage
|
|
|
|
For percentage data, format numbers in the chart with a `%` symbol.
|
|
|
|
Formats supported: `percent`, `percentHundred`
|
|
|
|
**Examples:**
|
|
|
|
| Format | Data | Displayed |
|
|
| ---------------- | ----- | --------- |
|
|
| `percent` | `0.5` | 50% |
|
|
| `percent` | `1` | 100% |
|
|
| `percent` | `2` | 200% |
|
|
| `percentHundred` | `50` | 50% |
|
|
| `percentHundred` | `100` | 100% |
|
|
| `percentHundred` | `200` | 200% |
|
|
|
|
## Duration
|
|
|
|
For time durations, format numbers in the chart with a time unit symbol.
|
|
|
|
Formats supported: `milliseconds`, `seconds`
|
|
|
|
**Examples:**
|
|
|
|
| Format | Data | Displayed |
|
|
| -------------- | ------ | --------- |
|
|
| `milliseconds` | `10` | 10ms |
|
|
| `milliseconds` | `500` | 100ms |
|
|
| `milliseconds` | `1000` | 1000ms |
|
|
| `seconds` | `10` | 10s |
|
|
| `seconds` | `500` | 500s |
|
|
| `seconds` | `1000` | 1000s |
|
|
|
|
## Digital (Metric)
|
|
|
|
Converts a number of bytes using metric prefixes. It scales to
|
|
use the unit that's the best fit.
|
|
|
|
Formats supported:
|
|
|
|
- `decimalBytes`
|
|
- `kilobytes`
|
|
- `megabytes`
|
|
- `gigabytes`
|
|
- `terabytes`
|
|
- `petabytes`
|
|
|
|
**Examples:**
|
|
|
|
| Format | Data | Displayed |
|
|
| -------------- | --------- | --------- |
|
|
| `decimalBytes` | `1` | 1B |
|
|
| `decimalBytes` | `1000` | 1kB |
|
|
| `decimalBytes` | `1000000` | 1MB |
|
|
| `kilobytes` | `1` | 1kB |
|
|
| `kilobytes` | `1000` | 1MB |
|
|
| `kilobytes` | `1000000` | 1GB |
|
|
| `megabytes` | `1` | 1MB |
|
|
| `megabytes` | `1000` | 1GB |
|
|
| `megabytes` | `1000000` | 1TB |
|
|
|
|
## Digital (IEC)
|
|
|
|
Converts a number of bytes using binary prefixes. It scales to
|
|
use the unit that's the best fit.
|
|
|
|
Formats supported:
|
|
|
|
- `bytes`
|
|
- `kibibytes`
|
|
- `mebibytes`
|
|
- `gibibytes`
|
|
- `tebibytes`
|
|
- `pebibytes`
|
|
|
|
**Examples:**
|
|
|
|
| Format | Data | Displayed |
|
|
| ----------- | ------------- | --------- |
|
|
| `bytes` | `1` | 1B |
|
|
| `bytes` | `1024` | 1KiB |
|
|
| `bytes` | `1024 * 1024` | 1MiB |
|
|
| `kibibytes` | `1` | 1KiB |
|
|
| `kibibytes` | `1024` | 1MiB |
|
|
| `kibibytes` | `1024 * 1024` | 1GiB |
|
|
| `mebibytes` | `1` | 1MiB |
|
|
| `mebibytes` | `1024` | 1GiB |
|
|
| `mebibytes` | `1024 * 1024` | 1TiB |
|