• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

temporalio / sdk-java / #425

10 Nov 2026 12:13AM UTC coverage: 71.697% (+0.06%) from 71.634%
#425

push

github

web-flow
Report poller target on each poll and in the worker heartbeat (for both fixed and autoscaling pools) (#3159)

8543 of 13993 branches covered (61.05%)

Branch coverage included in aggregate %.

58 of 65 new or added lines in 14 files covered. (89.23%)

7 existing lines in 4 files now uncovered.

33990 of 45330 relevant lines covered (74.98%)

0.75 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

75.27
/temporal-sdk/src/main/java/io/temporal/internal/worker/AsyncActivityPollTask.java
1
package io.temporal.internal.worker;
2

3
import static io.temporal.serviceclient.MetricsTag.METRICS_TAGS_CALL_OPTIONS_KEY;
4

5
import com.google.protobuf.DoubleValue;
6
import com.uber.m3.tally.Scope;
7
import io.grpc.Context;
8
import io.temporal.api.common.v1.WorkerVersionCapabilities;
9
import io.temporal.api.taskqueue.v1.PollerPoolInfo;
10
import io.temporal.api.taskqueue.v1.TaskQueue;
11
import io.temporal.api.taskqueue.v1.TaskQueueMetadata;
12
import io.temporal.api.workflowservice.v1.GetSystemInfoResponse;
13
import io.temporal.api.workflowservice.v1.PollActivityTaskQueueRequest;
14
import io.temporal.api.workflowservice.v1.PollActivityTaskQueueResponse;
15
import io.temporal.internal.common.GrpcUtils;
16
import io.temporal.serviceclient.MetricsTag;
17
import io.temporal.serviceclient.WorkflowServiceStubs;
18
import io.temporal.worker.MetricsType;
19
import io.temporal.worker.PollerTypeMetricsTag;
20
import io.temporal.worker.tuning.ActivitySlotInfo;
21
import io.temporal.worker.tuning.SlotPermit;
22
import io.temporal.worker.tuning.SlotReleaseReason;
23
import java.util.Objects;
24
import java.util.concurrent.CompletableFuture;
25
import java.util.function.IntSupplier;
26
import java.util.function.Supplier;
27
import javax.annotation.Nonnull;
28
import org.slf4j.Logger;
29
import org.slf4j.LoggerFactory;
30

31
public class AsyncActivityPollTask implements AsyncPoller.PollTaskAsync<ActivityTask> {
32
  private static final Logger log = LoggerFactory.getLogger(AsyncActivityPollTask.class);
1 ✔
33

34
  private final TrackingSlotSupplier<?> slotSupplier;
35
  private final WorkflowServiceStubs service;
36
  private final Scope metricsScope;
37
  private final PollActivityTaskQueueRequest pollRequest;
38
  private final Context.CancellableContext grpcContext = Context.ROOT.withCancellation();
1 ✔
39
  private final PollerTracker pollerTracker;
40

41
  @SuppressWarnings("deprecation")
42
  public AsyncActivityPollTask(
43
      @Nonnull WorkflowServiceStubs service,
44
      @Nonnull String namespace,
45
      @Nonnull String taskQueue,
46
      @Nonnull String identity,
47
      @Nonnull String workerInstanceKey,
48
      @Nonnull WorkerVersioningOptions versioningOptions,
49
      double activitiesPerSecond,
50
      @Nonnull TrackingSlotSupplier<ActivitySlotInfo> slotSupplier,
51
      @Nonnull Scope metricsScope,
52
      @Nonnull Supplier<GetSystemInfoResponse.Capabilities> serverCapabilities,
53
      @Nonnull PollerTracker pollerTracker,
54
      String workerControlTaskQueue) {
1 ✔
55
    this.service = service;
1 ✔
56
    this.slotSupplier = slotSupplier;
1 ✔
57
    this.metricsScope = metricsScope;
1 ✔
58
    this.pollerTracker = Objects.requireNonNull(pollerTracker);
1 ✔
59

60
    PollActivityTaskQueueRequest.Builder pollRequest =
61
        PollActivityTaskQueueRequest.newBuilder()
1 ✔
62
            .setNamespace(namespace)
1 ✔
63
            .setIdentity(identity)
1 ✔
64
            .setTaskQueue(TaskQueue.newBuilder().setName(taskQueue));
1 ✔
65
    pollRequest.setWorkerInstanceKey(workerInstanceKey);
1 ✔
66
    if (workerControlTaskQueue != null) {
1 !
67
      pollRequest.setWorkerControlTaskQueue(workerControlTaskQueue);
×
68
    }
69
    if (activitiesPerSecond > 0) {
1 ✔
70
      pollRequest.setTaskQueueMetadata(
1 ✔
71
          TaskQueueMetadata.newBuilder()
1 ✔
72
              .setMaxTasksPerSecond(DoubleValue.newBuilder().setValue(activitiesPerSecond).build())
1 ✔
73
              .build());
1 ✔
74
    }
75

76
    if (versioningOptions.getWorkerDeploymentOptions() != null) {
1 !
77
      pollRequest.setDeploymentOptions(
×
78
          WorkerVersioningProtoUtils.deploymentOptionsToProto(
×
79
              versioningOptions.getWorkerDeploymentOptions()));
×
80
    } else if (serverCapabilities.get().getBuildIdBasedVersioning()) {
1 !
81
      pollRequest.setWorkerVersionCapabilities(
×
82
          WorkerVersionCapabilities.newBuilder()
×
83
              .setBuildId(versioningOptions.getBuildId())
×
84
              .setUseVersioning(versioningOptions.isUsingVersioning())
×
85
              .build());
×
86
    }
87
    this.pollRequest = pollRequest.build();
1 ✔
88
  }
1 ✔
89

90
  /**
91
   * Supplies the poller pool's current scaling target. Installed by AsyncPoller, which owns the
92
   * scale report handle; null until then, and for a pool that is not autoscaling.
93
   */
94
  private volatile IntSupplier pollerTargetSupplier;
95

96
  @Override
97
  public void setPollerTargetSupplier(IntSupplier pollerTargetSupplier) {
98
    this.pollerTargetSupplier = pollerTargetSupplier;
1 ✔
99
    // Also hand it to the tracker, which is what the heartbeat builder can reach.
100
    pollerTracker.setPollerTargetSupplier(pollerTargetSupplier);
1 ✔
101
  }
1 ✔
102

103
  /** The poll request with the pool's target poller count attached. */
104
  private PollActivityTaskQueueRequest pollRequestWithScalingInfo() {
105
    IntSupplier supplier = pollerTargetSupplier;
1 ✔
106
    if (supplier == null) {
1 !
NEW
107
      return pollRequest;
×
108
    }
109
    return pollRequest.toBuilder()
1 ✔
110
        .setPollerPoolInfo(
1 ✔
111
            PollerPoolInfo.newBuilder().setTargetPollers(supplier.getAsInt()).build())
1 ✔
112
        .build();
1 ✔
113
  }
114

115
  @Override
116
  public CompletableFuture<ActivityTask> poll(SlotPermit permit) {
117
    PollActivityTaskQueueRequest request = pollRequestWithScalingInfo();
1 ✔
118
    if (log.isTraceEnabled()) {
1 !
NEW
119
      log.trace("poll request begin: " + request);
×
120
    }
121

122
    MetricsTag.tagged(metricsScope, PollerTypeMetricsTag.PollerType.ACTIVITY_TASK)
1 ✔
123
        .gauge(MetricsType.NUM_POLLERS)
1 ✔
124
        .update(pollerTracker.pollStarted());
1 ✔
125

126
    CompletableFuture<PollActivityTaskQueueResponse> response = null;
1 ✔
127
    try {
128
      response =
1 ✔
129
          grpcContext.call(
1 ✔
130
              () ->
131
                  GrpcUtils.toCompletableFuture(
1 ✔
132
                      service
133
                          .futureStub()
1 ✔
134
                          .withOption(METRICS_TAGS_CALL_OPTIONS_KEY, metricsScope)
1 ✔
135
                          .pollActivityTaskQueue(request)));
1 ✔
136
    } catch (Exception e) {
×
137
      MetricsTag.tagged(metricsScope, PollerTypeMetricsTag.PollerType.ACTIVITY_TASK)
×
138
          .gauge(MetricsType.NUM_POLLERS)
×
139
          .update(pollerTracker.pollCompleted());
×
140
      throw new RuntimeException(e);
×
141
    }
1 ✔
142

143
    return response
1 ✔
144
        .thenApply(
1 ✔
145
            r -> {
146
              if (r == null || r.getTaskToken().isEmpty()) {
1 !
147
                metricsScope.counter(MetricsType.ACTIVITY_POLL_NO_TASK_COUNTER).inc(1);
1 ✔
148
                return null;
1 ✔
149
              }
150
              pollerTracker.pollSucceeded();
1 ✔
151
              return new ActivityTask(
1 ✔
152
                  r,
153
                  permit,
154
                  () -> slotSupplier.releaseSlot(SlotReleaseReason.taskComplete(), permit));
1 ✔
155
            })
156
        .whenComplete(
1 ✔
157
            (r, e) -> {
158
              MetricsTag.tagged(metricsScope, PollerTypeMetricsTag.PollerType.ACTIVITY_TASK)
1 ✔
159
                  .gauge(MetricsType.NUM_POLLERS)
1 ✔
160
                  .update(pollerTracker.pollCompleted());
1 ✔
161
            });
1 ✔
162
  }
163

164
  @Override
165
  public void cancel(Throwable cause) {
166
    grpcContext.cancel(cause);
1 ✔
167
  }
1 ✔
168

169
  @Override
170
  public String getLabel() {
171
    return "AsyncActivityPollTask";
1 ✔
172
  }
173

174
  @Override
175
  public String toString() {
176
    return "AsyncActivityPollTask{}";
×
177
  }
178
}
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE TRIAL · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc