Skip to content

Commit 53d92ac

Browse files
Add more on custom metrics and API server/etcd unavailability behavior
1 parent 0e02a61 commit 53d92ac

File tree

1 file changed

+10
-1
lines changed
  • keps/sig-autoscaling/2702-graduate-hpa-api-to-GA

1 file changed

+10
-1
lines changed

keps/sig-autoscaling/2702-graduate-hpa-api-to-GA/README.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -421,7 +421,10 @@ Describe them, providing:
421421
- Which API(s):
422422
- Estimated increase:
423423
-->
424-
424+
Configuring custom metrics (the difference from v1 to v2) will result in API calls to the installed custom metrics adapter
425+
and the backing metrics store (which might be hosted in the cloud provider). These calls will happen every 15 seconds
426+
for each configured metric. Targets of type Value will retrieve for a single metric.
427+
Targets of type AverageValue will retrieve a metric for each pod.
425428

426429
###### Will enabling / using this feature result in increasing size or count of the existing API objects?
427430

@@ -469,6 +472,12 @@ details). For now, we leave it here.
469472
-->
470473

471474
###### How does this feature react if the API server and/or etcd is unavailable?
475+
If the API server or etcd are not available the HPA will not reconcile the scale subresource to the target metrics.
476+
This feature depends on other APIs served not from etcd but Metrics Server and custom metrics adapters.
477+
These are referenced in another section for monitoring to keep them alive. When one of the metrics is unavailable
478+
(e.g. a custom metric along side a resource metric) the HPA will continue to scale up if the other metric indicates
479+
to do so,this is for safety. However if one of the metrics is unavailable the HPA will not scale down
480+
in case the unavailable metric would have prevented a scale down. This is again for safety.
472481

473482
###### What are other known failure modes?
474483

0 commit comments

Comments
 (0)