다음을 통해 공유

최종 기한 및 취소를 사용하여 안정적인 gRPC 서비스

  • 아티클

참고 항목

이 문서의 최신 버전은 아닙니다. 현재 릴리스는 이 문서의 .NET 9 버전을 참조 하세요.

Warning

이 버전의 ASP.NET Core는 더 이상 지원되지 않습니다. 자세한 내용은 .NET 및 .NET Core 지원 정책을 참조 하세요. 현재 릴리스는 이 문서의 .NET 8 버전을 참조 하세요.

Important

이 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적, 또는 묵시적인 보증을 하지 않습니다.

현재 릴리스는 이 문서의 .NET 9 버전을 참조 하세요.

작성자: James Newton-King

최종 기한 및 취소는 gRPC 클라이언트에서 진행 중인 호출을 중단하는 데 사용하는 기능입니다. 이 문서에서는 최종 기한 및 취소가 중요한 이유와 .NET gRPC 앱에서 사용하는 방법에 대해 설명합니다.

최종 기한

최종 기한을 사용하면 gRPC 클라이언트에서 호출이 완료될 때까지 대기하는 기간을 지정할 수 있습니다. 최종 기한이 초과하면 호출이 취소됩니다. 최종 기한 설정은 호출을 실행할 수 있는 기간에 대한 상한을 제공하기 때문에 중요합니다. 또한 오작동하는 서비스가 계속 실행되어 서버 리소스가 소진되는 것을 방지합니다. 최종 기한은 안정적인 앱을 빌드하는 데 유용한 도구이므로 구성해야 합니다.

최종 기한 구성:

  • 최종 기한은 호출할 때 CallOptions.Deadline을 사용하여 구성합니다.
  • 기본 최종 기한 값은 없습니다. gRPC 호출은 최종 기한을 지정하지 않는 한 시간이 제한되지 않습니다.
  • 최종 기한은 최종 기한이 초과하는 시점의 UTC 시간입니다. 예를 들어 DateTime.UtcNow.AddSeconds(5)는 최종 기한이 지금부터 5초임을 나타냅니다.
  • 이전 또는 현재 시간을 사용하면 호출이 바로 최종 기한을 초과하게 됩니다.
  • 최종 기한은 gRPC 호출을 통해 서비스에 전송되고 클라이언트와 서비스 모두에서 독립적으로 추적됩니다. 한 머신에서는 gRPC 호출이 완료되었지만 응답이 클라이언트에 반환된 시간까지 최종 기한이 초과하였을 수 있습니다.

최종 기한을 초과하는 경우 클라이언트와 서비스의 동작이 다릅니다.

  • 클라이언트는 기본 HTTP 요청을 즉시 중단하고 DeadlineExceeded 오류를 throw합니다. 클라이언트 앱에서는 오류를 catch하고 사용자에게 시간 제한 메시지를 표시하도록 선택할 수 있습니다.
  • 서버에서는 실행 중인 HTTP 요청이 중단되고 ServerCallContext.CancellationToken이 생성됩니다. HTTP 요청은 중단되지만 gRPC 호출은 메서드가 완료될 때까지 서버에서 계속 실행됩니다. 취소 토큰을 비동기 메서드에 전달하여 호출과 함께 메서드가 취소되도록 해야 합니다. 예를 들어 비동기 데이터베이스 쿼리와 HTTP 요청에 취소 토큰을 전달합니다. 취소 토큰을 전달하면 취소된 호출이 서버에서 신속하게 완료되어 다른 호출을 위한 리소스를 확보할 수 있습니다.

CallOptions.Deadline을 구성하여 gRPC 호출의 최종 기한을 설정합니다.

var client = new Greet.GreeterClient(channel);

try
{
    var response = await client.SayHelloAsync(
        new HelloRequest { Name = "World" },
        deadline: DateTime.UtcNow.AddSeconds(5));
    
    // Greeting: Hello World
    Console.WriteLine("Greeting: " + response.Message);
}
catch (RpcException ex) when (ex.StatusCode == StatusCode.DeadlineExceeded)
{
    Console.WriteLine("Greeting timeout.");
}

gRPC 서비스에서 ServerCallContext.CancellationToken을 사용합니다.

public override async Task<HelloReply> SayHello(HelloRequest request,
    ServerCallContext context)
{
    var user = await _databaseContext.GetUserAsync(request.Name,
        context.CancellationToken);

    return new HelloReply { Message = "Hello " + user.DisplayName };
}

최종 기한 및 재시도

gRPC 호출이 다시 시도 오류 처리 및 최종 기한으로 구성되면 최종 기한이 gRPC 호출에 대한 모든 재시도에서 시간을 추적합니다. 최종 기한을 초과하는 경우 gRPC 호출은 기본 HTTP 요청을 즉시 중단하고, 나머지 재시도를 건너뛰고, DeadlineExceeded 오류를 throw합니다.

최종 기한 전파

실행 중인 gRPC 서비스에서 gRPC를 호출하는 경우 최종 기한을 전파해야 합니다. 예시:

  1. 클라이언트 앱에서 최종 기한이 있는 FrontendService.GetUser를 호출합니다.
  2. FrontendService은 UserService.GetUser를 호출합니다. 클라이언트에 지정된 최종 기한을 새 gRPC 호출에 지정해야 합니다.
  3. UserService.GetUser에서 최종 기한을 받습니다. 클라이언트 앱의 최종 기한이 초과하면 올바르게 시간 초과됩니다.

호출 컨텍스트에서는 ServerCallContext.Deadline에 최종 기한을 제공합니다.

public override async Task<UserResponse> GetUser(UserRequest request,
    ServerCallContext context)
{
    var client = new User.UserServiceClient(_channel);
    var response = await client.GetUserAsync(
        new UserRequest { Id = request.Id },
        deadline: context.Deadline);

    return response;
}

수동으로 최종 기한을 전파하면 복잡할 수 있습니다. 최종 기한을 모든 호출에 전달해야 하므로 실수로 누락하기가 쉽습니다. 자동 솔루션은 gRPC 클라이언트 팩터리에서 사용할 수 있습니다. EnableCallContextPropagation을 지정합니다.

  • 최종 기한 및 취소 토큰을 자식 호출에 자동으로 전파합니다.
  • 자식 호출이 더 짧은 기한을 지정하는 경우 기한을 전파하지 않습니다. 예를 들어, 자식 호출에서 CallOptions.Deadline을 사용하여 5초의 새 기한을 지정하는 경우 전파된 10초의 기한은 사용되지 않습니다. 여러 기한을 사용할 수 있는 경우 가장 짧은 기한이 사용됩니다.
  • 복잡한 중첩 gRPC 시나리오에서 최종 기한 및 취소를 항상 전파하도록 하는 가장 좋은 방법입니다.
services
    .AddGrpcClient<User.UserServiceClient>(o =>
    {
        o.Address = new Uri("https://localhost:5001");
    })
    .EnableCallContextPropagation();

자세한 내용은 .NET의 gRPC 클라이언트 팩터리 통합을 참조하세요.

취소

취소를 사용하면 gRPC 클라이언트에서 더 이상 필요 없는 장기 실행 호출을 취소할 수 있습니다. 예를 들어 사용자가 웹 사이트의 페이지를 방문하면 실시간 업데이트를 스트리밍하는 gRPC 호출이 시작됩니다. 사용자가 페이지를 벗어나면 이 스트림을 취소해야 합니다.

호출 시 CallOptions.CancellationToken으로 취소 토큰을 전달하거나 Dispose를 호출하여 클라이언트에서 gRPC 호출을 취소할 수 있습니다.

private AsyncServerStreamingCall<HelloReply> _call;

public void StartStream()
{
    _call = client.SayHellos(new HelloRequest { Name = "World" });

    // Read response in background task.
    _ = Task.Run(async () =>
    {
        await foreach (var response in _call.ResponseStream.ReadAllAsync())
        {
            Console.WriteLine("Greeting: " + response.Message);
        }
    });
}

public void StopStream()
{
    _call.Dispose();
}

취소할 수 있는 gRPC 서비스는 다음을 수행해야 합니다.

  • ServerCallContext.CancellationToken을 비동기 메서드에 전달합니다. 비동기 메서드를 취소하면 서버 호출을 신속하게 완료할 수 있습니다.
  • 취소 토큰을 자식 호출에 전파합니다. 취소 토큰을 전파하면 자식 호출이 부모와 함께 취소됩니다. gRPC 클라이언트 팩터리 및 EnableCallContextPropagation()은 취소 토큰을 자동으로 전파합니다.

추가 리소스