docs(gax-grpc): explain use of == for log threshold

lqiu96 · lqiu96 · commit 827b22d9862e · 2026-04-17T17:09:52.000-04:00
diff --git a/sdk-platform-java/gax-java/gax-grpc/src/main/java/com/google/api/gax/grpc/ChannelPool.java b/sdk-platform-java/gax-java/gax-grpc/src/main/java/com/google/api/gax/grpc/ChannelPool.java
@@ -338,6 +338,8 @@ void resize() {
       consecutiveResizes = 0;
     }
 
+    // Log warning only once when the threshold is reached to avoid spamming logs.
+    // Using == instead of >= ensures we don't log on every subsequent resize cycle.
     if (consecutiveResizes == CONSECUTIVE_RESIZE_THRESHOLD) {
       LOG.warning(
           "Channel pool is repeatedly resizing. Consider adjusting `initialChannelCount` or `maxResizeDelta` to a more reasonable value. "

Original file line number	Diff line number	Diff line change
`@@ -338,6 +338,8 @@ void resize() {`
`338`	`338`	`consecutiveResizes = 0;`
`339`	`339`	`}`
`340`	`340`
	`341`	`+ // Log warning only once when the threshold is reached to avoid spamming logs.`
	`342`	`+ // Using == instead of >= ensures we don't log on every subsequent resize cycle.`
`341`	`343`	`if (consecutiveResizes == CONSECUTIVE_RESIZE_THRESHOLD) {`
`342`	`344`	`LOG.warning(`
`343`	`345`	"Channel pool is repeatedly resizing. Consider adjusting `initialChannelCount` or `maxResizeDelta` to a more reasonable value. "