Skip to content

Commit

Permalink
Prevent Execution of Delayed Tasks for Cancelled gRPC Requests (#6066)
Browse files Browse the repository at this point in the history
Motivation:
When blockingTaskExecutor is used in a gRPC service, tasks handling gRPC
requests are queued if the executor is busy with heavy blocking jobs.
https://github.com/line/armeria/blob/0960d091bfc7f350c17e68f57cc627de584b9705/grpc/src/main/java/com/linecorp/armeria/internal/server/grpc/AbstractServerCall.java#L363
If these tasks are delayed for too long, the corresponding gRPC requests
may time out and get cancelled. Despite the cancellation, the queued
tasks are still executed once the executor becomes available, leading to
unnecessary processing.
https://github.com/line/armeria/blob/0960d091bfc7f350c17e68f57cc627de584b9705/grpc/src/main/java/com/linecorp/armeria/internal/server/grpc/AbstractServerCall.java#L394-L404

Modifications:
- Updated `AbstractServerCall.invokeOnMessage()` to check if the request
is cancelled before calling `listener.onMessage`.

Result:
- Prevents execution of delayed tasks for gRPC requests that have
already been cancelled.

Co-authored-by: szymon.habrainski <[email protected]>
  • Loading branch information
minwoox and schiemon authored Jan 14, 2025
1 parent bbb0571 commit 8ae035e
Show file tree
Hide file tree
Showing 4 changed files with 173 additions and 7 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -94,7 +94,6 @@ final class HttpServerHandler extends ChannelInboundHandlerAdapter implements Ht

private static final Logger logger = LoggerFactory.getLogger(HttpServerHandler.class);

private static final CompletableFuture<?>[] EMPTY_FUTURES = {};
private static final String ALLOWED_METHODS_STRING =
HttpMethod.knownMethods().stream().map(HttpMethod::name).collect(Collectors.joining(","));

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import com.google.common.annotations.VisibleForTesting;
import com.google.common.base.Splitter;

import com.linecorp.armeria.common.HttpData;
Expand Down Expand Up @@ -111,8 +112,9 @@ public abstract class AbstractServerCall<I, O> extends ServerCall<I, O> {
private final String clientAcceptEncoding;
private final boolean autoCompression;

@VisibleForTesting
@Nullable
private final Executor blockingExecutor;
final Executor blockingExecutor;
private final InternalGrpcExceptionHandler exceptionHandler;

// Only set once.
Expand Down Expand Up @@ -382,6 +384,11 @@ protected final void onRequestComplete() {
}

protected final void invokeOnReady() {
if (blockingExecutor != null && cancelled) {
// Do not call listener.onReady() if the call is cancelled after
// this task was scheduled to blockingTaskExecutor.
return;
}
try {
if (listener != null) {
listener.onReady();
Expand All @@ -392,6 +399,11 @@ protected final void invokeOnReady() {
}

private void invokeOnMessage(I request, boolean halfClose) {
if (blockingExecutor != null && cancelled) {
// Do not call listener.onMessage() if the call is cancelled after
// this task was scheduled to blockingTaskExecutor.
return;
}
try (SafeCloseable ignored = ctx.push()) {
assert listener != null;
listener.onMessage(request);
Expand All @@ -404,6 +416,11 @@ private void invokeOnMessage(I request, boolean halfClose) {
}

protected final void invokeHalfClose() {
if (blockingExecutor != null && cancelled) {
// Do not call listener.onHalfClose() if the call is cancelled after
// this task was scheduled to blockingTaskExecutor.
return;
}
try (SafeCloseable ignored = ctx.push()) {
assert listener != null;
listener.onHalfClose();
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,155 @@
/*
* Copyright 2025 LINE Corporation
*
* LINE Corporation licenses this file to you under the Apache License,
* version 2.0 (the "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at:
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*/
package com.linecorp.armeria.internal.server.grpc;

import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
import static org.awaitility.Awaitility.await;

import java.util.concurrent.CompletableFuture;
import java.util.concurrent.atomic.AtomicBoolean;
import java.util.concurrent.atomic.AtomicReference;

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.RegisterExtension;
import org.reactivestreams.Subscriber;
import org.reactivestreams.Subscription;

import com.linecorp.armeria.client.grpc.GrpcClients;
import com.linecorp.armeria.common.FilteredHttpRequest;
import com.linecorp.armeria.common.HttpObject;
import com.linecorp.armeria.server.ServerBuilder;
import com.linecorp.armeria.server.grpc.GrpcService;
import com.linecorp.armeria.testing.junit5.server.ServerExtension;

import io.grpc.Metadata;
import io.grpc.ServerCall;
import io.grpc.ServerCall.Listener;
import io.grpc.ServerCallHandler;
import io.grpc.ServerInterceptor;
import io.grpc.ServerInterceptors;
import io.grpc.StatusRuntimeException;
import io.grpc.stub.StreamObserver;
import testing.grpc.Messages.StreamingInputCallRequest;
import testing.grpc.Messages.StreamingInputCallResponse;
import testing.grpc.TestServiceGrpc;
import testing.grpc.TestServiceGrpc.TestServiceStub;

class AbstractServerCallTest {

@RegisterExtension
static final ServerExtension server = new ServerExtension() {
@Override
protected void configure(ServerBuilder sb) throws Exception {
final AtomicReference<ServerCall<?, ?>> serverCallCaptor = new AtomicReference<>();
final GrpcService grpcService =
GrpcService.builder()
.useBlockingTaskExecutor(true)
.useClientTimeoutHeader(false)
.addService(ServerInterceptors.intercept(
new FooTestServiceImpl(),
new ServerInterceptor() {

@Override
public <T, U> Listener<T> interceptCall(
ServerCall<T, U> call, Metadata headers,
ServerCallHandler<T, U> next) {
serverCallCaptor.set(call);
return next.startCall(call, headers);
}
}))
.build();
sb.service(grpcService);
sb.decorator((delegate, ctx, req) -> {
final FilteredHttpRequest newReq = new FilteredHttpRequest(req) {
@Override
protected void beforeSubscribe(Subscriber<? super HttpObject> subscriber,
Subscription subscription) {
// This is called right before
// blockingExecutor.execute(() -> invokeOnMessage(request, endOfStream));
// in AbstractServerCall.
// https://github.com/line/armeria/blob/0960d091bfc7f350c17e68f57cc627de584b9705/grpc/src/main/java/com/linecorp/armeria/internal/server/grpc/AbstractServerCall.java#L363
final ServerCall<?, ?> serverCall = serverCallCaptor.get();
assertThat(serverCall).isInstanceOf(AbstractServerCall.class);
((AbstractServerCall<?, ?>) serverCall).blockingExecutor.execute(() -> {
// invokeOnMessage is not called until the request is cancelled.
await().until(serverCall::isCancelled);
// Now, AbstractServerCall.invokeOnMessage() is called and it doesn't call
// listener.onMessage() because the request is cancelled.
});
}

@Override
protected HttpObject filter(HttpObject obj) {
return obj;
}
};
ctx.updateRequest(newReq);
return delegate.serve(ctx, newReq);
});
sb.requestTimeoutMillis(100);
}
};

private static final AtomicBoolean isOnNextCalled = new AtomicBoolean();

@Test
void onMessageIsNotCalledWhenRequestCancelled() throws InterruptedException {
final TestServiceStub testServiceStub = GrpcClients.newClient(server.httpUri(), TestServiceStub.class);
final CompletableFuture<Throwable> future = new CompletableFuture<>();
final StreamObserver<StreamingInputCallRequest> streamingInputCallRequestStreamObserver =
testServiceStub.streamingInputCall(new StreamObserver<StreamingInputCallResponse>() {
@Override
public void onNext(StreamingInputCallResponse value) {}

@Override
public void onError(Throwable t) {
future.completeExceptionally(t);
}

@Override
public void onCompleted() {
}
});
streamingInputCallRequestStreamObserver.onNext(StreamingInputCallRequest.newBuilder().build());
assertThatThrownBy(future::get).hasCauseInstanceOf(StatusRuntimeException.class)
.hasMessageContaining("CANCELLED");
// Sleep additional 1 second to make sure that the onNext() is not called.
Thread.sleep(1000);
assertThat(isOnNextCalled).isFalse();
}

private static class FooTestServiceImpl extends TestServiceGrpc.TestServiceImplBase {

@Override
public StreamObserver<StreamingInputCallRequest> streamingInputCall(
StreamObserver<StreamingInputCallResponse> responseObserver) {
return new StreamObserver<StreamingInputCallRequest>() {
@Override
public void onNext(StreamingInputCallRequest value) {
// If this method is called that means listener.onMessage() in AbstractServerCall is called.
isOnNextCalled.set(true);
}

@Override
public void onError(Throwable t) {}

@Override
public void onCompleted() {}
};
}
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,6 @@
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.google.common.collect.ImmutableList;
import com.google.protobuf.Descriptors.ServiceDescriptor;

import com.linecorp.armeria.client.WebClient;
import com.linecorp.armeria.common.AggregatedHttpResponse;
Expand All @@ -48,10 +47,6 @@

class GrpcDocServiceJsonSchemaTest {

private static final ServiceDescriptor TEST_SERVICE_DESCRIPTOR =
testing.grpc.Test.getDescriptor()
.findServiceByName("TestService");

private static class TestService extends TestServiceImplBase {
@Override
public void unaryCallWithAllDifferentParameterTypes(
Expand Down

0 comments on commit 8ae035e

Please sign in to comment.