github/kubernetes
1
0
Fork 0
mirror of https://github.com/k3s-io/kubernetes.git synced 2025-08-05 02:09:56 +00:00
Code Issues Projects Releases Wiki Activity

Extend CRI API to support PSI

Browse Source
This commit is contained in:
Haowei Cai 2025-03-20 19:28:20 +00:00
parent 92a42e65ec
commit 77118d4ca0
1 changed files with 36 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
staging/src/k8s.io/cri-api/pkg/apis/runtime/v1/api.proto
View File

@ -748,6 +748,8 @@ message LinuxPodSandboxStats {
ProcessUsage process = 4; ProcessUsage process = 4;
// Stats of containers in the measured pod sandbox. // Stats of containers in the measured pod sandbox.
repeated ContainerStats containers = 5; repeated ContainerStats containers = 5;
// IO usage gathered for the pod sandbox.
IoUsage io = 6;
} }
// WindowsPodSandboxStats provides the resource usage statistics for a pod sandbox on windows // WindowsPodSandboxStats provides the resource usage statistics for a pod sandbox on windows
@ -1793,6 +1795,8 @@ message ContainerStats {
FilesystemUsage writable_layer = 4; FilesystemUsage writable_layer = 4;
// Swap usage gathered from the container. // Swap usage gathered from the container.
SwapUsage swap = 5; SwapUsage swap = 5;
// IO usage gathered from the container.
IoUsage io = 6;
} }
// WindowsContainerStats provides the resource usage statistics for a container specific for Windows // WindowsContainerStats provides the resource usage statistics for a container specific for Windows
@ -1807,6 +1811,27 @@ message WindowsContainerStats {
WindowsFilesystemUsage writable_layer = 4; WindowsFilesystemUsage writable_layer = 4;
} }
// PSI statistics for an individual resource.
message PsiStats {
// PSI data for all tasks in the cgroup.
PsiData Full = 1;
// PSI data for some tasks in the cgroup.
PsiData Some = 2;
}
// PSI data for an individual resource.
message PsiData {
// Total time duration for tasks in the cgroup have waited due to congestion.
// Unit: nanoseconds.
uint64 Total = 1;
// The average (in %) tasks have waited due to congestion over a 10 second window.
double Avg10 = 2;
// The average (in %) tasks have waited due to congestion over a 60 second window.
double Avg60 = 3;
// The average (in %) tasks have waited due to congestion over a 300 second window.
double Avg300 = 4;
}
// CpuUsage provides the CPU usage information. // CpuUsage provides the CPU usage information.
message CpuUsage { message CpuUsage {
// Timestamp in nanoseconds at which the information were collected. Must be > 0. // Timestamp in nanoseconds at which the information were collected. Must be > 0.
@ -1816,6 +1841,8 @@ message CpuUsage {
// Total CPU usage (sum of all cores) averaged over the sample window. // Total CPU usage (sum of all cores) averaged over the sample window.
// The "core" unit can be interpreted as CPU core-nanoseconds per second. // The "core" unit can be interpreted as CPU core-nanoseconds per second.
UInt64Value usage_nano_cores = 3; UInt64Value usage_nano_cores = 3;
// CPU PSI statistics.
PsiStats psi = 4;
} }
// WindowsCpuUsage provides the CPU usage information specific to Windows // WindowsCpuUsage provides the CPU usage information specific to Windows
@ -1845,6 +1872,15 @@ message MemoryUsage {
UInt64Value page_faults = 6; UInt64Value page_faults = 6;
// Cumulative number of major page faults. // Cumulative number of major page faults.
UInt64Value major_page_faults = 7; UInt64Value major_page_faults = 7;
// Memory PSI statistics.
PsiStats psi = 8;
}
message IoUsage {
// Timestamp in nanoseconds at which the information were collected. Must be > 0.
int64 timestamp = 1;
// IO PSI statistics.
PsiStats psi = 2;
} }
message SwapUsage { message SwapUsage {