You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: keps/sig-node/2371-cri-pod-container-stats/README.md
+18-3Lines changed: 18 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -651,8 +651,8 @@ Each compliant CRI implementation must:
651
651
652
652
Below is the proposed strategy for doing so:
653
653
654
-
1. The Alpha release will focus solely on `/stats/summary` endpoint, and `/metrics/cadvisor`support will follow in Beta.
655
-
2. For the Beta release, add initial support for CRI implementations to report these metrics
654
+
1. The Alpha release will add support for both `/stats/summary` endpoint and `/metrics/cadvisor`endpoint.
655
+
2. For the Beta release, add support for CRI implementations to report these metrics
656
656
- Initial research on the set of metrics required should be done. This will, possibly, allow the community to declare metrics that are not required to be moved to the CRI implementations.
657
657
- Testing on how performant cAdvisor+Kubelet are today should be done, to find a target, acceptable threshold of performance for the CRI implementations
658
658
- Creation of tests verifying the metrics are reported correctly should be created and verified with the existing cAdvisor implementation.
@@ -808,7 +808,9 @@ We expect no non-infra related flakes in the last month as a GA graduation crite
808
808
- Conformance tests for the fields in `/metrics/cadvisor` should be created.
809
809
- Validate performance impact of this feature is within allowable margin (or non-existent, ideally).
810
810
- The CRI stats implementation should perform better than they did with CRI+cAdvisor.
811
-
- cAdvisor stats provider may be marked as deprecated (depending on stability of new CRI based implementations).
811
+
- cAdvisor stats provider will be marked as deprecated, as well as the cAdvisor providing the metrics endpoint `/metrics/cadvisor`.
812
+
- Write migration documentation for entities relying on metrics from `/metrics/cadvisor`.
813
+
- Windows stats and metrics will be added.
812
814
813
815
#### Beta -> GA Graduation
814
816
@@ -1028,6 +1030,17 @@ resource usage (CPU, RAM, disk, IO, ...) in any components?**
1028
1030
This will not happen anymore.
1029
1031
- The CRI implementation may scrape the metrics less efficiently than cAdvisor currently does. This should be measured and evaluated as a requirement of Beta.
1030
1032
1033
+
1034
+
###### Can enabling / using this feature result in resource exhaustion of some node resources (PIDs, sockets, inodes, etc.)?
1035
+
1036
+
It is possible the CRI implementation could use more memory or CPU for the metrics gathering than cAdvisor does. In this case,
1037
+
one of those resources could be in jepordy of being exhausted. However, it is a explicit goal of beta criteria (and graduation generally)
1038
+
to prevent such regressions, so this feature will not be on by default if this is possible.
1039
+
1040
+
It's also worth noting that both of the CRI implementations are maintained in a similar fashion as cAdvisor: out-of-tree but by many
1041
+
Kubernetes maintainers, and so the risk of this happening with this feature is similar to the risk of it happening now.
1042
+
1043
+
1031
1044
### Troubleshooting
1032
1045
1033
1046
The Troubleshooting section currently serves the `Playbook` role. We may consider
@@ -1055,6 +1068,8 @@ _This section must be completed when targeting beta graduation to a release._
1055
1068
2022-01-25: KEP targeted at Beta in 1.24
1056
1069
2022-04-20: KEP deemed not ready for Beta in 1.24
1057
1070
2022-06-13: Move some Beta criteria to Alpha criteria in 1.25
0 commit comments