debian-mirror-gitlab/doc/operations/metrics/dashboards/yaml_number_format.md

stage	group	info
Monitor	APM	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 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 i.e. 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:

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