다음을 통해 공유

복원력 있는 앱 개발 소개

복원력은 일시적인 오류로부터 복구하고 계속 작동하는 앱의 기능입니다. .NET 프로그래밍의 컨텍스트에서 복원력은 오류를 정상적으로 처리하고 신속하게 복구할 수 있는 앱을 디자인하여 달성됩니다. .NET에서 복원력 있는 앱을 빌드하는 데 도움이 되도록 NuGet에서 다음 두 패키지를 사용할 수 있습니다.

NuGet 패키지 설명
📦 Microsoft.Extensions.Resilience 이 NuGet 패키지는 일시적인 오류에 대해 앱을 강화하는 메커니즘을 제공합니다.
📦 Microsoft.Extensions.Http.Resilience 이 NuGet 패키지는 HttpClient 클래스에 대한 복원력 메커니즘을 제공합니다.

이 두 NuGet 패키지는 인기 있는 오픈 소스 프로젝트인 Polly를 기반으로 빌드됩니다. Polly는 개발자가 재시도, 회로 차단기, 시간 제한, 격벽 격리, 속도 제한, 대체 및 헤징과 같은 전략을 유창하고 스레드로부터 안전한 방식으로 표현할 수 있는 .NET 복원력 및 일시적인 오류 처리 라이브러리입니다.

중요합니다

Microsoft.Extensions.Http.Polly NuGet 패키지는 더 이상 사용되지 않습니다. 앞에서 언급한 패키지 중 하나를 대신 사용합니다.

시작하기

.NET에서 복원력을 시작하려면 Microsoft.Extensions.Resilience NuGet 패키지를 설치합니다.

dotnet add package Microsoft.Extensions.Resilience

자세한 내용은 .NET 애플리케이션에서 dotnet 패키지 추가 또는 패키지 종속성 관리를 참조하세요.

복원력 파이프라인 빌드

복원력을 사용하려면 먼저 복원력 기반 전략의 파이프라인을 빌드해야 합니다. 구성된 각 전략은 구성 순서대로 실행됩니다. 즉, 순서가 중요합니다. 진입점은 IServiceCollection 형식의 AddResiliencePipeline 확장 메서드입니다. 이 메서드는 파이프라인의 식별자와 파이프라인을 구성하는 대리자를 사용합니다. 대리자는 파이프라인에 복원력 전략을 추가하는 데 사용되는 인스턴스 ResiliencePipelineBuilder를 전달합니다.

다음 문자열 기반 key 예제를 고려합니다.

using Microsoft.Extensions.DependencyInjection;
using Polly;
using Polly.CircuitBreaker;
using Polly.Registry;
using Polly.Retry;
using Polly.Timeout;

var services = new ServiceCollection();

const string key = "Retry-Timeout";

services.AddResiliencePipeline(key, static builder =>
{
    // See: https://www.pollydocs.org/strategies/retry.html
    builder.AddRetry(new RetryStrategyOptions
    {
        ShouldHandle = new PredicateBuilder().Handle<TimeoutRejectedException>()
    });

    // See: https://www.pollydocs.org/strategies/timeout.html
    builder.AddTimeout(TimeSpan.FromSeconds(1.5));
});

앞의 코드는 다음과 같습니다.

  • 새 ServiceCollection 인스턴스를 만듭니다.
  • 파이프라인을 식별하기 위해 key를 정의합니다.
  • 인스턴스에 복원력 파이프라인을 추가합니다 ServiceCollection .
  • 재시도 및 시간 제한 전략을 사용하여 파이프라인을 구성합니다.

각 파이프라인은 지정된 key파이프라인에 대해 구성되며 각 key 파이프라인은 공급자로부터 파이프라인을 가져올 때 해당 ResiliencePipeline 파이프라인을 식별하는 데 사용됩니다. 메서드 key 의 제네릭 형식 매개 변수입니다 AddResiliencePipeline .

탄력성 파이프라인 작성기 확장

파이프라인에 전략을 추가하려면 인스턴스에서 사용 가능한 Add* 확장 메서드 ResiliencePipelineBuilder 를 호출합니다.

  • AddRetry: 문제가 일시적이고 사라질 수 있는 경우에 유용한 오류가 발생하면 다시 시도합니다.
  • AddCircuitBreaker: 고장났거나 사용 중인 경우, 시간을 낭비하지 않고 상황을 악화시키지 않기 위해 시도를 중단하십시오. 이는 당신에게 도움이 됩니다.
  • AddTimeout: 리소스를 확보하여 성능을 향상시킬 수 있는 시간이 너무 오래 걸리면 포기합니다.
  • AddRateLimiter: 수락하는 요청 수를 제한하여 인바운드 로드를 제어할 수 있습니다.
  • AddConcurrencyLimiter: 아웃바운드 로드를 제어할 수 있는 요청 수를 제한합니다.
  • AddFallback: 오류가 발생할 때 다른 작업을 수행하여 사용자 환경을 개선합니다.
  • AddHedging: 대기 시간이 높거나 오류가 발생할 경우 여러 요청을 실행하여 응답성을 향상시킬 수 있습니다.

자세한 내용은 복원력 전략을 참조하세요. 예를 들어 복원력 있는 HTTP 앱 빌드: 주요 개발 패턴을 참조하세요.

메트릭 확장

증강은 이름/값 쌍으로 이루어진 잘 알려진 상태로 원격 분석의 자동 증강입니다. 예를 들어 앱은 작업 및 결과 코드를 포함하는 로그를 열로 내보내 일부 작업의 결과를 나타낼 수 있습니다. 상황과 주변 컨텍스트에 따라, 원격 분석 백엔드로 전송되는 로그에 클러스터 이름, 프로세스 이름, 지역, 테넌트 ID 등을 추가하는 확장을 실행합니다. 보강이 추가되면 앱 코드는 보강된 메트릭의 이점을 활용하기 위해 추가 작업을 수행할 필요가 없습니다.

풍부화 작동 방식

로그 및 메트릭을 생성하는 1,000개의 전역 분산 서비스 인스턴스를 상상해 보십시오. 서비스 대시보드에서 문제가 발생하면 문제가 있는 지역 또는 데이터 센터를 신속하게 식별하는 것이 중요합니다. 보강을 통해 메트릭 레코드에 분산 시스템의 오류를 정확히 파악하는 데 필요한 정보가 포함됩니다. 보강이 없으면 이 상태를 내부적으로 관리하고, 로깅 프로세스에 통합하고, 수동으로 전송하는 앱 코드가 부담됩니다. 보강은 이 프로세스를 간소화하여 앱의 논리에 영향을 주지 않고 원활하게 처리합니다.

복원성의 경우, 강화 요소를 추가할 때 다음과 같은 차원이 송신되는 원격 분석 데이터에 추가됩니다.

  • error.type: 예외 정보의 카디널리티 버전이 낮습니다.
  • request.name: 요청의 이름입니다.
  • request.dependency.name: 종속성의 이름입니다.

내부적으로, 복원성 강화는 Polly의 원격 분석을 기반으로 구축됩니다 MeteringEnricher. 자세한 내용은 Polly: 계량 강화를 참조하세요.

복원력 보강 추가

복원력 파이프라인을 등록하는 것 외에도 복원력 보강을 등록할 수도 있습니다. 보강을 추가하려면 인스턴스에서 AddResilienceEnricher(IServiceCollection) 확장 메서드를 호출합니다 IServiceCollection .

services.AddResilienceEnricher();

확장 메서드를 AddResilienceEnricher 호출하여 기본 Polly 라이브러리에 기본 제공되는 차원 위에 차원을 추가합니다. 다음 강화 차원이 추가됩니다.

복원력 파이프라인 사용

구성된 복원력 파이프라인을 사용하려면 ResiliencePipelineProvider<TKey>에서 파이프라인을 가져와야 합니다. 이전에 key 파이프라인을 추가했을 때 그것은 string 형식이었으므로 ResiliencePipelineProvider<string>에서 파이프라인을 가져와야 합니다.

using ServiceProvider provider = services.BuildServiceProvider();

ResiliencePipelineProvider<string> pipelineProvider =
    provider.GetRequiredService<ResiliencePipelineProvider<string>>();

ResiliencePipeline pipeline = pipelineProvider.GetPipeline(key);

앞의 코드는 다음과 같습니다.

  • 인스턴스 ServiceProvider에서 ServiceCollection를 생성합니다.
  • ResiliencePipelineProvider<string> 서비스 공급자에서 가져옵니다.
  • ResiliencePipeline에서 ResiliencePipelineProvider<string>를 가져옵니다.

복원력 파이프라인 실행

복원력 파이프라인을 사용하려면 인스턴스에서 사용 가능한 Execute* 메서드를 호출합니다 ResiliencePipeline . 예를 들어 ExecuteAsync 메서드를 호출하는 예제를 살펴봅시다.

await pipeline.ExecuteAsync(static cancellationToken =>
{
    // Code that could potentially fail.

    return ValueTask.CompletedTask;
});

앞의 코드는 ExecuteAsync 메서드 내에서 대리자를 실행합니다. 오류가 발생하면 구성된 전략이 실행됩니다. 예를 들어 세 번 다시 시도하도록 구성된 경우 RetryStrategy 대리자는 오류가 전파되기 전에 네 번 실행됩니다(초기 시도 1회 및 재시도 3회).

다음 단계

안정적인 HTTP 앱 빌드: 주요 개발 패턴재시도된 호출의 멱등성 처리 문제를 고려합니다.

  • Last updated on