Unit formats reference

Introduced in GitLab 12.9.

Format the data in your dashboard panels.

You can select units to format your charts by adding format to your axis configuration.

Internationalization and localization

Currently, your internationalization and localization options for number formatting are dependent on the system you are using (that is, your OS or browser).

Engineering Notation

For generic or default data, numbers are formatted according to the current locale in engineering notation.

While an engineering notation exists for the web, GitLab uses a version based off the 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:

NameSymbolValue
yottaY1000000000000000000000000
zettaZ1000000000000000000000
exaE1000000000000000000
petaP1000000000000000
teraT1000000000000
gigaG1000000000
megaM1000000
kilok1000
millim0.001
microμ0.000001
nanon0.000000001
picop0.000000000001
femtof0.000000000000001
attoa0.000000000000000001
zeptoz0.000000000000000000001
yoctoy0.000000000000000000000001

Examples:

DataDisplayed
0.0000000000000000000000088y
0.0000000000000000000088z
0.0000000000000000088a
0.0000000000000088f
0.0000000000088p
0.0000000088n
0.000008
0.0088m
1010
10801.08k
1800018k
1888818.9k
188888189k
1888888818.9M
18888888881.89G
18888888888881.89T
18888888888888881.89P
18888888888888888881.89E
18888888888888888888881.89Z
18888888888888888888888881.89Y
18888888888888888888888888881.89e+27

Numbers

For number data, numbers are formatted according to the current locale.

Formats: number

Examples:

DataDisplayed
101
10001,000
10000001,000,000

Percentage

For percentage data, format numbers in the chart with a % symbol.

Formats supported: percent, percentHundred

Examples:

FormatDataDisplayed
percent0.550%
percent1100%
percent2200%
percentHundred5050%
percentHundred100100%
percentHundred200200%

Duration

For time durations, format numbers in the chart with a time unit symbol.

Formats supported: milliseconds, seconds

Examples:

FormatDataDisplayed
milliseconds1010ms
milliseconds500100ms
milliseconds10001000ms
seconds1010s
seconds500500s
seconds10001000s

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:

FormatDataDisplayed
decimalBytes11B
decimalBytes10001kB
decimalBytes10000001MB
kilobytes11kB
kilobytes10001MB
kilobytes10000001GB
megabytes11MB
megabytes10001GB
megabytes10000001TB

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:

FormatDataDisplayed
bytes11B
bytes10241KiB
bytes1024 * 10241MiB
kibibytes11KiB
kibibytes10241MiB
kibibytes1024 * 10241GiB
mebibytes11MiB
mebibytes10241GiB
mebibytes1024 * 10241TiB