Unit of measure is missing for metrics endpoints about docs HOT 1 OPEN

Thanks for reporting! Hm.. yes, it looks like the swagger / OpenAPI file that's used for the API docs doesn't currently define a schema for the response; https://github.com/moby/moby/blob/v25.0.4/docs/api/v1.44.yaml#L7132-L7141, so currently (besides som "example" response), it only shows object;

I think that may have been done because the response differs between Windows and Linux daemons and because some of the fields returned are raw data originating from the kernel / cgroups (and information provided for various of those depend on kernel version and cgroups used (v1/v2)). But we should look if we can improve that; at least for fields that do not depend on cgroups / cgroup-versions.

For these specific fields, you can refer to the Go documentation for the underlyling structs used here's the links for the current (v25.0.2) release of the Docker Engine;

• github.com/docker/docker/api/types.CPUUsage (source-code: https://github.com/moby/moby/blob/v25.0.4/api/types/stats.go#L19)
• github.com/docker/docker/api/types.CPUStats (source-code: https://github.com/moby/moby/blob/v25.0.4/api/types/stats.go#L43)

Other stats-related structs can be found in the same file in the repository; https://github.com/moby/moby/blob/v25.0.4/api/types/stats.go

Some fields returned by the stats endpoint (as mentioned) may differ between platforms as they are collected from the underlying runtime (containerd, or the hcsshim runtime on Windows), and some of those are merely expose the underlying group data (for which you may have to refer to the Linux kernel documentation).

https://github.com/moby/moby/blob/v25.0.4/daemon/stats_unix.go#L89-L123
https://github.com/moby/moby/blob/v25.0.4/daemon/stats_windows.go#L45-L58

We should have a look though how much information we can add (or where needed, link to relevant (kernel) documentation).

from docs.