[MESOS-8832] Resource metrics are named percent and documented in such a way even though they represent fractions - ASF JIRA

Attach files

Attach Screenshot

Add vote

Voters

Watch issue

Watchers

Link

Clone

Update Comment Author

Replace String in Comment

Update Comment Visibility

Delete Comments

XML

Word

Printable

JSON

Details

Type: Bug
Status: Open
Priority: Major
Resolution: Unresolved
Affects Version/s: None
Fix Version/s: None
Component/s: agent, documentation, master
Labels:
None

Description

A number of metrics reporting fractions of used resources are called *_percent and documented in that spirit which is confusing since percentages and fractions have e.g., different ranges and units, e.g.,

master/cpus_percent	Percentage of allocated CPUs	Gauge
master/cpus_used	Number of allocated CPUs	Gauge
master/cpus_total	Number of CPUs	Gauge
master/cpus_revocable_percent	Percentage of allocated revocable CPUs	Gauge
master/cpus_revocable_total	Number of revocable CPUs	Gauge
master/cpus_revocable_used	Number of allocated revocable CPUs	Gauge
master/disk_percent	Percentage of allocated disk space	Gauge
master/disk_used	Allocated disk space in MB	Gauge

Ideally we would rename these values (e.g., used _fraction instead of _percent suffix) and updated the documentation, but since this would be a breaking API change we'd likely need to support two forms simultanously.