diff --git a/docs/reference/api/docker_remote_api_v1.19.md b/docs/reference/api/docker_remote_api_v1.19.md
index 4af832e4bb..a33b9e217e 100644
--- a/docs/reference/api/docker_remote_api_v1.19.md
+++ b/docs/reference/api/docker_remote_api_v1.19.md
@@ -682,20 +682,37 @@ This endpoint returns a live stream of a container's resource usage statistics.
"cpu_stats" : {
"cpu_usage" : {
"percpu_usage" : [
- 16970827,
- 1839451,
- 7107380,
- 10571290
+ 8646879,
+ 24472255,
+ 36438778,
+ 30657443
],
- "usage_in_usermode" : 10000000,
- "total_usage" : 36488948,
- "usage_in_kernelmode" : 20000000
+ "usage_in_usermode" : 50000000,
+ "total_usage" : 100215355,
+ "usage_in_kernelmode" : 30000000
},
- "system_cpu_usage" : 20091722000000000,
- "throttling_data" : {}
+ "system_cpu_usage" : 739306590000000,
+ "throttling_data" : {"periods":0,"throttled_periods":0,"throttled_time":0}
+ },
+ "precpu_stats" : {
+ "cpu_usage" : {
+ "percpu_usage" : [
+ 8646879,
+ 24350896,
+ 36438778,
+ 30657443
+ ],
+ "usage_in_usermode" : 50000000,
+ "total_usage" : 100093996,
+ "usage_in_kernelmode" : 30000000
+ },
+ "system_cpu_usage" : 9492140000000,
+ "throttling_data" : {"periods":0,"throttled_periods":0,"throttled_time":0}
}
}
+The precpu_stats is the cpu statistic of last read, which is used for calculating the cpu usage percent. It is not the exact copy of the “cpu_stats” field.
+
Query Parameters:
- **stream** – 1/True/true or 0/False/false, pull stats once then disconnect. Default `true`.
diff --git a/docs/reference/api/docker_remote_api_v1.20.md b/docs/reference/api/docker_remote_api_v1.20.md
index c1a06fff5e..085744932f 100644
--- a/docs/reference/api/docker_remote_api_v1.20.md
+++ b/docs/reference/api/docker_remote_api_v1.20.md
@@ -695,20 +695,37 @@ This endpoint returns a live stream of a container's resource usage statistics.
"cpu_stats" : {
"cpu_usage" : {
"percpu_usage" : [
- 16970827,
- 1839451,
- 7107380,
- 10571290
+ 8646879,
+ 24472255,
+ 36438778,
+ 30657443
],
- "usage_in_usermode" : 10000000,
- "total_usage" : 36488948,
- "usage_in_kernelmode" : 20000000
+ "usage_in_usermode" : 50000000,
+ "total_usage" : 100215355,
+ "usage_in_kernelmode" : 30000000
},
- "system_cpu_usage" : 20091722000000000,
- "throttling_data" : {}
+ "system_cpu_usage" : 739306590000000,
+ "throttling_data" : {"periods":0,"throttled_periods":0,"throttled_time":0}
+ },
+ "precpu_stats" : {
+ "cpu_usage" : {
+ "percpu_usage" : [
+ 8646879,
+ 24350896,
+ 36438778,
+ 30657443
+ ],
+ "usage_in_usermode" : 50000000,
+ "total_usage" : 100093996,
+ "usage_in_kernelmode" : 30000000
+ },
+ "system_cpu_usage" : 9492140000000,
+ "throttling_data" : {"periods":0,"throttled_periods":0,"throttled_time":0}
}
}
+The precpu_stats is the cpu statistic of last read, which is used for calculating the cpu usage percent. It is not the exact copy of the “cpu_stats” field.
+
Query Parameters:
- **stream** – 1/True/true or 0/False/false, pull stats once then disconnect. Default `true`.
diff --git a/docs/reference/api/docker_remote_api_v1.21.md b/docs/reference/api/docker_remote_api_v1.21.md
index 68349e5d49..1ccde5a2b8 100644
--- a/docs/reference/api/docker_remote_api_v1.21.md
+++ b/docs/reference/api/docker_remote_api_v1.21.md
@@ -773,20 +773,37 @@ This endpoint returns a live stream of a container's resource usage statistics.
"cpu_stats" : {
"cpu_usage" : {
"percpu_usage" : [
- 16970827,
- 1839451,
- 7107380,
- 10571290
+ 8646879,
+ 24472255,
+ 36438778,
+ 30657443
],
- "usage_in_usermode" : 10000000,
- "total_usage" : 36488948,
- "usage_in_kernelmode" : 20000000
+ "usage_in_usermode" : 50000000,
+ "total_usage" : 100215355,
+ "usage_in_kernelmode" : 30000000
},
- "system_cpu_usage" : 20091722000000000,
- "throttling_data" : {}
+ "system_cpu_usage" : 739306590000000,
+ "throttling_data" : {"periods":0,"throttled_periods":0,"throttled_time":0}
+ },
+ "precpu_stats" : {
+ "cpu_usage" : {
+ "percpu_usage" : [
+ 8646879,
+ 24350896,
+ 36438778,
+ 30657443
+ ],
+ "usage_in_usermode" : 50000000,
+ "total_usage" : 100093996,
+ "usage_in_kernelmode" : 30000000
+ },
+ "system_cpu_usage" : 9492140000000,
+ "throttling_data" : {"periods":0,"throttled_periods":0,"throttled_time":0}
}
}
+The precpu_stats is the cpu statistic of last read, which is used for calculating the cpu usage percent. It is not the exact copy of the “cpu_stats” field.
+
Query Parameters:
- **stream** – 1/True/true or 0/False/false, pull stats once then disconnect. Default `true`.
diff --git a/docs/reference/api/docker_remote_api_v1.22.md b/docs/reference/api/docker_remote_api_v1.22.md
index 7082cd7470..743421bd01 100644
--- a/docs/reference/api/docker_remote_api_v1.22.md
+++ b/docs/reference/api/docker_remote_api_v1.22.md
@@ -867,20 +867,37 @@ This endpoint returns a live stream of a container's resource usage statistics.
"cpu_stats" : {
"cpu_usage" : {
"percpu_usage" : [
- 16970827,
- 1839451,
- 7107380,
- 10571290
+ 8646879,
+ 24472255,
+ 36438778,
+ 30657443
],
- "usage_in_usermode" : 10000000,
- "total_usage" : 36488948,
- "usage_in_kernelmode" : 20000000
+ "usage_in_usermode" : 50000000,
+ "total_usage" : 100215355,
+ "usage_in_kernelmode" : 30000000
},
- "system_cpu_usage" : 20091722000000000,
- "throttling_data" : {}
+ "system_cpu_usage" : 739306590000000,
+ "throttling_data" : {"periods":0,"throttled_periods":0,"throttled_time":0}
+ },
+ "precpu_stats" : {
+ "cpu_usage" : {
+ "percpu_usage" : [
+ 8646879,
+ 24350896,
+ 36438778,
+ 30657443
+ ],
+ "usage_in_usermode" : 50000000,
+ "total_usage" : 100093996,
+ "usage_in_kernelmode" : 30000000
+ },
+ "system_cpu_usage" : 9492140000000,
+ "throttling_data" : {"periods":0,"throttled_periods":0,"throttled_time":0}
}
}
+The precpu_stats is the cpu statistic of last read, which is used for calculating the cpu usage percent. It is not the exact copy of the “cpu_stats” field.
+
Query Parameters:
- **stream** – 1/True/true or 0/False/false, pull stats once then disconnect. Default `true`.
diff --git a/docs/reference/api/docker_remote_api_v1.23.md b/docs/reference/api/docker_remote_api_v1.23.md
index 45ecd8dbb6..6a4d121f52 100644
--- a/docs/reference/api/docker_remote_api_v1.23.md
+++ b/docs/reference/api/docker_remote_api_v1.23.md
@@ -871,20 +871,37 @@ This endpoint returns a live stream of a container's resource usage statistics.
"cpu_stats" : {
"cpu_usage" : {
"percpu_usage" : [
- 16970827,
- 1839451,
- 7107380,
- 10571290
+ 8646879,
+ 24472255,
+ 36438778,
+ 30657443
],
- "usage_in_usermode" : 10000000,
- "total_usage" : 36488948,
- "usage_in_kernelmode" : 20000000
+ "usage_in_usermode" : 50000000,
+ "total_usage" : 100215355,
+ "usage_in_kernelmode" : 30000000
},
- "system_cpu_usage" : 20091722000000000,
- "throttling_data" : {}
+ "system_cpu_usage" : 739306590000000,
+ "throttling_data" : {"periods":0,"throttled_periods":0,"throttled_time":0}
+ },
+ "precpu_stats" : {
+ "cpu_usage" : {
+ "percpu_usage" : [
+ 8646879,
+ 24350896,
+ 36438778,
+ 30657443
+ ],
+ "usage_in_usermode" : 50000000,
+ "total_usage" : 100093996,
+ "usage_in_kernelmode" : 30000000
+ },
+ "system_cpu_usage" : 9492140000000,
+ "throttling_data" : {"periods":0,"throttled_periods":0,"throttled_time":0}
}
}
+The precpu_stats is the cpu statistic of last read, which is used for calculating the cpu usage percent. It is not the exact copy of the “cpu_stats” field.
+
Query Parameters:
- **stream** – 1/True/true or 0/False/false, pull stats once then disconnect. Default `true`.