Skip to content

Commit e495afb

Browse files
Updates proposal with experimental metric details and formatting fixes
Signed-off-by: anurag.ag <[email protected]>
1 parent 8ff799f commit e495afb

File tree

1 file changed

+13
-4
lines changed

1 file changed

+13
-4
lines changed

A100-client-side-weighted-round-robin-slow-start.md

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -116,7 +116,8 @@ using the formula from [gRFC A58][A58]:
116116

117117
$$weight = \dfrac{qps}{utilization + \dfrac{eps}{qps} * error\\_utilization\\_penalty}$$
118118

119-
This base weight represents the endpoint's capacity based on its current performance metrics. When an endpoint enters the
119+
This base weight represents the endpoint's capacity based on its current performance metrics. When an endpoint enters
120+
the
120121
warmup period after being in a non-ready state, its weight will be scaled by a factor that increases non-linearly from
121122
`min_weight_percent` to 100% over the duration of `slow_start_window`.
122123

@@ -250,13 +251,16 @@ The following metric will be exposed to help monitor the slow start behavior:
250251
- Type: Counter
251252
- Description: Number of endpoints currently in slow start period
252253
- Labels:
253-
- `grpc.lb.locality`: The locality of the endpoints [gRFC A78][A78]
254-
- `grpc.lb.backend_service`: The backend service name [gRFC A89][A89]
255-
- `grpc.target`: gRPC channel target [gRFC A66][A66]
254+
- `grpc.lb.locality`: The locality of the endpoints [gRFC A78][A78]
255+
- `grpc.lb.backend_service`: The backend service name [gRFC A89][A89]
256+
- `grpc.target`: gRPC channel target [gRFC A66][A66]
256257

257258
This metric will help operators monitor the number of endpoints currently in slow start mode across different localities
258259
and backend services.
259260

261+
Please note that this metric will start as experimental and off by default, and we will consider stabilizing it in the
262+
future.
263+
260264
## Rationale
261265

262266
The slow start feature helps prevent overwhelming new endpoints by gradually increasing their traffic load. This is
@@ -311,8 +315,13 @@ The functionality is being implemented in Java. It will be implemented in Go, C+
311315
Java Implementation: https://github.com/grpc/grpc-java/pull/12200
312316

313317
[Envoy Slow Start Documentation]: https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/slow_start
318+
314319
[A58]: A58-client-side-weighted-round-robin-lb-policy.md
320+
315321
[A66]: A66-otel-stats.md
322+
316323
[A78]: A78-grpc-metrics-wrr-pf-xds.md
324+
317325
[A79]: A79-non-per-call-metrics-architecture.md
326+
318327
[A89]: A89-backend-service-metric-label.md

0 commit comments

Comments
 (0)