com.google.api.gax.batching

Class FlowControlEventStats

java.lang.Object

com.google.api.gax.batching.FlowControlEventStats

@InternalApi(value="For google-cloud-java client use only")
public class FlowControlEventStats
extends Object

Record the statistics of flow control events.

This class is populated by FlowController, which will record throttling events. Currently it only keeps the last flow control event, but it could be expanded to record more information in the future. The events can be used to dynamically adjust concurrency in the client. For example:

 // Increase flow control limits if there was throttling in the past 5 minutes and throttled time
 // was longer than 1 minute.
 while(true) {
    FlowControlEvent event = flowControlEventStats.getLastFlowControlEvent();
    if (event != null
         && event.getTimestampMs() > System.currentMillis() - TimeUnit.MINUTES.toMillis(5)
         && event.getThrottledTimeInMs() > TimeUnit.MINUTES.toMillis(1)) {
      flowController.increaseThresholds(elementSteps, byteSteps);
    }
    Thread.sleep(TimeUnit.MINUTE.toMillis(10));
 }
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FlowControlEventStats.FlowControlEvent A flow control event.

Constructor Summary

Constructors

Constructor and Description
FlowControlEventStats()

Method Summary

Modifier and Type	Method and Description
FlowControlEventStats.FlowControlEvent	getLastFlowControlEvent()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FlowControlEventStats

public FlowControlEventStats()

Method Detail

getLastFlowControlEvent

public FlowControlEventStats.FlowControlEvent getLastFlowControlEvent()