Service Bus 메시징 예외(.NET)

아티클
10/30/2023

Service Bus .NET 클라이언트 라이브러리는 서비스 작업 또는 클라이언트에서 오류가 발생할 때 예외를 표시합니다. 가능하면 표준 .NET 예외 형식을 사용하여 오류 정보를 전달합니다. Service Bus와 관련된 시나리오의 경우 ServiceBusException 이 throw됩니다.

Service Bus 클라이언트는 구성된 다시 시도 옵션에 따라 일시적인 것으로 간주되는 예외를 자동으로 다시 시도합니다. 예외가 애플리케이션에 표시되면 모든 재시도가 실패하거나 예외가 비전환으로 간주되었습니다. 재시도 옵션 구성에 대한 자세한 내용은 재시도 옵션 사용자 지정 샘플에서 찾을 수 있습니다 .

ServiceBusException

예외에는 오류의 컨텍스트 및 상대적 심각도를 이해하는 데 도움이 되는 몇 가지 컨텍스트 정보가 포함됩니다.

EntityPath : 예외가 발생한 Service Bus 엔터티(사용 가능한 경우)를 식별합니다.
IsTransient : 예외가 복구 가능한 것으로 간주되는지 여부를 나타냅니다. 일시적인 것으로 간주되는 경우 Azure Service Bus는 이미 적절한 재시도 정책을 적용했으며 모든 재시도에 실패했습니다.
Message : 발생한 오류 및 관련 컨텍스트에 대한 설명을 제공합니다.
StackTrace : 호출 스택의 즉각적인 프레임을 나타내며 오류가 발생한 코드의 위치를 강조 표시합니다.
InnerException: 서비스 작업의 결과로 예외가 발생한 경우 Microsoft.Azure.Amqp.AmqpException OASIS AMQP(Advanced Message Queuing Protocol) 1.0 사양에 따라 오류를 설명하는 인스턴스인 경우가 많습니다.
Reason : 근본 원인을 분류하고 명확히 하는 데 도움이 되는 오류에 대해 잘 알려진 이유 집합을 제공합니다. 이러한 값은 예외 메시지의 텍스트를 검사하는 것이 이상적이지 않은 예외 필터링 및 기타 논리를 적용할 수 있도록 하기 위한 것입니다. 몇 가지 주요 실패 이유는 다음과 같습니다.
- ServiceTimeout: Service Bus 서비스가 예상 시간 내에 작업 요청에 응답하지 않았음을 나타냅니다. 일시적인 네트워크 문제 또는 서비스 문제 때문일 수 있습니다. Service Bus 서비스가 요청을 성공적으로 완료했거나 완료하지 않았을 수 있습니다. 상태 알 수 없습니다. 사용 가능한 다음 세션의 컨텍스트에서 이 예외는 엔터티에서 사용할 수 있는 잠금 해제된 세션이 없음을 나타냅니다. 이러한 오류는 자동으로 다시 시도되는 일시적인 오류입니다.
- QuotaExceeded: 일반적으로 단일 엔터티에 대해 너무 많은 활성 수신 작업이 있음을 나타냅니다. 이 오류를 방지하려면 잠재적 동시 수신 수를 줄입니다. 일괄 처리 수신을 사용하여 수신 요청당 여러 메시지를 수신하려고 시도할 수 있습니다. 자세한 내용은 Service Bus 할당량을 참조 하세요.
- MessageSizeExceeded: 메시지 크기가 최대 메시지 크기를 초과했음을 나타냅니다. 메시지 크기에는 메시지 본문과 연결된 메타데이터가 포함됩니다. 이 오류를 해결하는 가장 좋은 방법은 일괄 처리로 전송되는 메시지의 수 또는 메시지에 포함된 본문의 크기를 줄이는 것입니다. 크기 제한은 변경될 수 있으므로 자세한 내용은 Service Bus 할당량을 참조하세요.
- MessageLockLost: 메시지의 잠금이 손실되었음을 나타냅니다. 호출자는 메시지를 다시 받고 처리하려고 시도해야 합니다. 이 예외는 세션을 사용하지 않는 엔터티에만 적용됩니다. 이 오류는 처리가 잠금 기간보다 오래 걸리고 메시지 잠금이 갱신되지 않는 경우에 발생합니다. 일시적인 네트워크 문제로 인해 링크가 분리되거나 링크가 10분 동안 유휴 상태일 때도 이 오류가 발생할 수 있습니다.
  
  Service Bus 서비스는 상태 저장 상태인 AMQP 프로토콜을 사용합니다. 프로토콜의 특성으로 인해 메시지를 받은 후 클라이언트와 서비스를 연결하는 링크가 분리되지만 메시지가 해결되기 전에 메시지를 다시 연결할 때 메시지를 확인할 수 없습니다. 단기 일시적인 네트워크 오류, 네트워크 중단 또는 서비스가 10분 유휴 시간 제한으로 인해 연결을 분리할 수 있습니다. 링크의 다시 연결은 링크가 필요한 작업, 즉 메시지의 정착 또는 수신의 일부로 자동으로 수행됩니다. 이 동작으로 인해 잠금 만료 시간이 아직 경과되지 않았거나 SessionLockLost 발생하더라도 발생할 MessageLockLostServiceBusExceptionReason 수 있습니다.
- SessionLockLost: 세션의 잠금이 만료되었음을 나타냅니다. 호출자는 세션을 다시 수락하려고 시도해야 합니다. 이 예외는 세션 사용 엔터티에만 적용됩니다. 이 오류는 처리가 잠금 기간보다 오래 걸리고 세션 잠금이 갱신되지 않는 경우에 발생합니다. 일시적인 네트워크 문제로 인해 링크가 분리되거나 링크가 10분 동안 유휴 상태일 때도 이 오류가 발생할 수 있습니다. Service Bus 서비스는 상태 저장 상태인 AMQP 프로토콜을 사용합니다. 프로토콜의 특성으로 인해 메시지를 받은 후 클라이언트와 서비스를 연결하는 링크가 분리되지만 메시지가 해결되기 전에 메시지를 다시 연결할 때 메시지를 확인할 수 없습니다. 단기 일시적인 네트워크 오류, 네트워크 중단 또는 서비스가 10분 유휴 시간 제한으로 인해 연결을 분리할 수 있습니다. 링크의 다시 연결은 링크가 필요한 작업, 즉 메시지의 정착 또는 수신의 일부로 자동으로 수행됩니다. 이 동작으로 인해 잠금 만료 시간이 아직 경과되지 않았거나 SessionLockLost 발생하더라도 발생할 MessageLockLostServiceBusExceptionReason 수 있습니다.
- MessageNotFound: 이 오류는 엔터티에 없거나 현재 잠겨 있는 메시지에 대해 시퀀스 번호로 지연된 메시지를 수신하려고 할 때 발생합니다.
- SessionCannotBeLocked: 잠금이 이미 다른 위치에 있으므로 요청된 세션을 잠글 수 없음을 나타냅니다. 잠금이 만료되면 세션을 수락할 수 있습니다.
- GeneralError: Service Bus 서비스에서 요청을 처리하는 동안 오류가 발생했음을 나타냅니다. 이 오류는 종종 서비스 업그레이드 및 다시 시작으로 인해 발생합니다. 이러한 오류는 자동으로 다시 시도되는 일시적인 오류입니다.
- ServiceCommunicationProblem: 서비스와 통신하는 동안 오류가 발생했음을 나타냅니다. 이 문제는 일시적인 네트워크 문제 또는 서비스 문제에서 비롯될 수 있습니다. 이러한 오류는 자동으로 다시 시도되는 일시적인 오류입니다.
- ServiceBusy: 서비스에 의해 요청이 제한되었음을 나타냅니다. 요청을 제한할 수 있는 원인과 제한을 방지하는 방법을 설명하는 세부 정보는 여기에서 확인할 수 있습니다. 제한된 요청은 다시 시도되지만 클라이언트 라이브러리는 동일한 ServiceBusClient (또는 해당 클라이언트에서 만든 하위 형식)을 사용하여 더 이상 요청을 시도하기 전에 자동으로 10초 백오프를 적용합니다. 불안정한 메시지 또는 잠긴 세션에 대해 메시지 또는 세션 잠금이 손실될 가능성이 있으므로 엔터티의 잠금 기간이 10초 미만인 경우 문제가 발생할 수 있습니다. 제한된 요청은 일반적으로 성공적으로 다시 시도되므로 생성된 예외는 오류가 아닌 경고로 기록됩니다. 특정 경고 수준 이벤트 원본 이벤트는 43입니다(RunOperation에서 예외가 발생하고 다시 시도).
- MessagingEntityAlreadyExists: 이름이 같은 엔터티가 동일한 네임스페이스 아래에 있음을 나타냅니다.
- MessagingEntityDisabled: 메시징 엔터티를 사용할 수 없습니다. 포털을 사용하여 엔터티를 다시 사용하도록 설정합니다.
- MessagingEntityNotFound: Service Bus 서비스에서 Service Bus 리소스를 찾을 수 없습니다.

ServiceBusException 처리 - 예제

다음은 를 처리 ServiceBusException 하고 필터링하는 방법의 예입니다 Reason.

try
{
    // Receive messages using the receiver client
}
catch (ServiceBusException ex) when
    (ex.Reason == ServiceBusFailureReason.ServiceTimeout)
{
    // Take action based on a service timeout
}

기타 일반적인 예외

ArgumentException: 클라이언트가 클라이언트와 상호 작용할 ArgumentException 때 제공된 매개 변수가 유효하지 않은 경우 파생되는 이 예외를 throw합니다. 특정 매개 변수 및 문제의 특성에 대한 정보는 .에서 Message찾을 수 있습니다.
InvalidOperationException: 현재 구성에 유효하지 않은 작업을 수행하려고 할 때 발생합니다. 이 예외는 일반적으로 클라이언트가 작업을 지원하도록 구성되지 않은 경우에 발생합니다. 클라이언트에 전달되는 옵션을 조정하여 완화할 수 있는 경우가 많습니다.
NotSupportedException: 요청된 작업이 클라이언트에 대해 유효하지만 현재 상태에서 지원되지 않는 경우에 발생합니다. 시나리오에 대한 정보는 .에서 Message찾을 수 있습니다.
AggregateException: 작업에서 여러 예외가 발생할 수 있고 단일 오류로 표시될 때 발생합니다. 이 예외는 Service Bus 프로세서 또는 Service Bus 세션 프로세서를 시작하거나 중지할 때 가장 일반적으로 발생합니다.

이유: QuotaExceeded

특정 엔터티에 대한 할당량이 초과되었음을 나타내는 이유가 설정된 QuotaExceeded ServiceBusException입니다.

참고 항목

Service Bus 할당량은 할당량을 참조하세요.

큐 및 항목

큐 및 토픽의 경우 큐의 크기인 경우가 많습니다. 오류 메시지 속성에는 다음 예제와 같이 추가 세부 정보가 포함됩니다.

Message: The maximum entity size has been reached or exceeded for Topic: 'xxx-xxx-xxx'. 
    Size of entity in bytes:1073742326, Max entity size in bytes:
1073741824..TrackingId:xxxxxxxxxxxxxxxxxxxxxxxxxx, TimeStamp:3/15/2013 7:50:18 AM

이 메시지는 토픽이 크기 제한(이 경우 1GB(기본 크기 제한)을 초과했음을 나타냅니다.

네임스페이스

네임스페이스의 경우 QuotaExceeded 예외는 애플리케이션이 네임스페이스에 대한 최대 연결 수를 초과했음을 나타낼 수 있습니다. 예시:

<tracking-id-guid>_G12 ---> 
System.ServiceModel.FaultException`1[System.ServiceModel.ExceptionDetail]: 
ConnectionsQuotaExceeded for namespace xxx.

일반적인 원인

이 오류에는 배달 못 한 편지 큐와 작동하지 않는 메시지 수신자의 두 가지 일반적인 원인이 있습니다.

배달 못 한 편지 큐 A 판독기가 메시지를 완료하지 못하고 잠금이 만료되면 메시지가 큐/토픽으로 반환됩니다. 판독기에서 메시지를 완료하지 못하게 하는 예외가 발생하는 경우 발생할 수 있습니다. 메시지를 10번 읽은 후에는 기본적으로 배달 못 한 편지 큐로 이동합니다. 이 동작은 MaxDeliveryCount 속성에 의해 제어되며 기본값은 10입니다. 메시지가 배달 못 한 편지 큐에 쌓이면서 공간을 차지합니다.

이 문제를 해결하려면 다른 큐에서와 마찬가지로 배달 못 한 편지 큐에서 메시지를 읽고 완료합니다.
수신기 중지됨. 수신자가 큐 또는 구독에서 메시지 수신을 중지했습니다. 문제를 식별하는 방법은 활성 메시지 수를 확인하는 것입니다. 활성 메시지 수가 높거나 증가하는 경우 메시지는 작성되는 만큼 빠르게 읽지 않습니다.

이유: MessageLockLost

원인

PeekLock 수신 모드를 MessageLockLost 사용하여 메시지를 수신하고 클라이언트가 보유한 잠금이 서비스 쪽에서 만료됨을 나타내는 이유가 설정된 ServiceBusException입니다.

다음과 같은 다양한 이유로 인해 메시지 잠금이 만료될 수 있습니다.

클라이언트 애플리케이션에서 갱신하기 전에 잠금 타이머가 만료되었습니다.
클라이언트 애플리케이션이 잠금을 확보하고 영구 저장소에 저장한 다음, 다시 시작되었습니다. 다시 시작되면 클라이언트 애플리케이션은 수신 메시지를 살펴보고 메시지를 완료하려고 했습니다.

다음 시나리오에서도 이 예외가 발생할 수 있습니다.

서비스 업데이트
OS 업데이트
잠금을 보유하고 있는 동안 엔터티(큐, 토픽, 구독)의 속성 변경

해결

클라이언트 애플리케이션이 MessageLockLostException을 받으면 더 이상 메시지를 처리할 수 없습니다. 클라이언트 애플리케이션은 필요에 따라 분석을 위해 예외를 로깅하는 것을 고려할 수 있지만 클라이언트 는 메시지를 삭제해야 합니다 .

메시지 잠금이 만료되었으므로 큐(또는 구독)로 돌아가서 호출이 수신되는 다음 클라이언트 애플리케이션에서 처리할 수 있습니다.

MaxDeliveryCount를 초과하면 메시지가 DeadLetterQueue로 이동될 수 있습니다.

이유: SessionLockLost

원인

이유가 설정된 MessageLockLost ServiceBusException은 세션이 수락되고 클라이언트가 보유한 잠금이 서비스 쪽에서 만료되면 throw됩니다.

세션의 잠금은 다음과 같은 다양한 이유로 인해 만료될 수 있습니다.

클라이언트 애플리케이션에서 갱신하기 전에 잠금 타이머가 만료되었습니다.
클라이언트 애플리케이션이 잠금을 확보하고 영구 저장소에 저장한 다음, 다시 시작되었습니다. 다시 시작된 후 클라이언트 애플리케이션이 Inflight 세션을 검토하고 해당 세션에서 메시지를 처리하려고 했습니다.

다음 시나리오에서도 이 예외가 발생할 수 있습니다.

서비스 업데이트
OS 업데이트
잠금을 보유하고 있는 동안 엔터티(큐, 토픽, 구독)의 속성 변경

해결

클라이언트 애플리케이션이 SessionLockLostException을 받으면 더 이상 세션에서 메시지를 처리할 수 없습니다. 클라이언트 애플리케이션은 분석을 위해 예외를 로깅하는 것을 고려할 수 있지만 클라이언트 는 메시지를 삭제해야 합니다 .

세션에 대한 잠금이 만료되었으므로 큐(또는 구독)로 돌아가 세션을 수락하는 다음 클라이언트 애플리케이션에서 잠글 수 있습니다. 세션 잠금은 지정된 시간에 단일 클라이언트 애플리케이션이 확보하므로 순차적 처리가 보장됩니다.

TimeoutException

TimeoutException 은 사용자가 시작한 작업이 작업 시간 제한보다 더 오래 걸린다는 것을 나타냅니다.

이 제한에 도달하면 TimeoutException이 발생할 수 있으므로 ServicePointManager.Default커넥트ionLimit 속성의 값을 검사 합니다.

시간 제한은 서비스를 실행하는 리소스에 대한 Service Bus 서비스 업데이트(또는) OS 업데이트와 같은 기본 테넌트 작업 중 또는 그 사이에 발생할 것으로 예상됩니다. OS 업데이트 도중 엔터티가 이동하고 노드는 업데이트 또는 재부팅되며, 이로 인해 시간 제한이 발생할 수 있습니다. Azure Service Bus 서비스에 대한 SLA(서비스 수준 계약) 세부 정보는 Service Bus용 SLA를 참조하세요.

SocketException

원인

SocketException은 다음과 같은 경우에 throw됩니다.

지정된 시간 후에 호스트가 제대로 응답하지 않아 연결 시도가 실패하는 경우(TCP 오류 코드 10060)
연결된 호스트가 응답하지 않아 설정된 연결이 실패했습니다.
메시지를 처리하는 동안 오류가 발생했거나 원격 호스트에서 시간 제한을 초과했습니다.
기본 네트워크 리소스 문제입니다.

해결

SocketException 오류는 애플리케이션을 호스트하는 VM이 <mynamespace>.servicebus.windows.net이라는 이름을 해당 IP 주소로 변환할 수 없음을 의미합니다.

다음 명령이 IP 주소에 매핑하는 데 성공했는지 확인합니다.

PS C:\> nslookup <mynamespace>.servicebus.windows.net

다음과 같은 출력을 제공해야 합니다.

Name:    <cloudappinstance>.cloudapp.net
Address:  XX.XX.XXX.240
Aliases:  <mynamespace>.servicebus.windows.net

위의 이름이 IP 및 네임스페이스 별칭으로 확인되지 않으면 네트워크 관리자에게 검사 자세히 조사합니다. 이름 확인은 일반적으로 고객 네트워크의 리소스인 DNS 서버를 통해 수행됩니다. Azure DNS에서 DNS 확인을 수행하는 경우 Azure 지원 문의하세요.

이름 확인이 예상대로 작동하면 여기에서 Azure Service Bus에 대한 연결이 허용되는지 검사.

UnauthorizedAccessException

UnauthorizedAccessException은 제공된 자격 증명이 요청된 작업을 수행할 수 없음을 나타냅니다. 속성에는 Message 오류에 대한 세부 정보가 포함되어 있습니다.

를 생성 ServiceBusClient할 때 제공되는 권한 부여 유형에 따라 이러한 확인 단계를 수행하는 것이 좋습니다.

다음 단계

전체 Service Bus .NET API 참조는 Azure .NET API 참조를 참조하세요. 문제 해결 팁은 문제 해결 가이드를 참조하세요.

Share via