Azure Relay 예외
이 문서는 Azure Relay API를 통해 발생할 수 있는 몇 가지 예외를 설명합니다. 이 참조는 변경될 수 있으므로 나중에 다시 업데이트를 확인하세요.
예외 범주
Relay API는 다음과 같은 범주로 분류될 수 있는 예외를 생성합니다. 예외를 해결하기 위해 수행할 수 있는 권장 조치를 모두 나열합니다.
사용자 코딩 오류: System.ArgumentException, System.InvalidOperationException, System.OperationCanceledException, System.Runtime.Serialization.SerializationException.
일반 조치: 코드를 수정한 후 계속합니다.
설치/구성 오류: System.UnauthorizedAccessException.
일반 조치: 구성을 검토합니다. 필요에 따라 구성을 변경합니다.
일시적 예외: Microsoft.ServiceBus.Messaging.MessagingException, Microsoft.ServiceBus.Messaging.ServerBusyException, Microsoft.ServiceBus.Messaging.MessagingCommunicationException.
일반 조치: 작업을 다시 시도하거나 사용자에게 알립니다.
다른 예외: System.Transactions.TransactionException, System.TimeoutException.
일반 작업: 예외 형식에 따라 다릅니다. 다음 섹션에 있는 표를 참조하세요.
예외 유형
다음 표에서는 메시지 예외 유형과 원인을 열거합니다. 예외를 해결하기 위해 수행할 수 있는 권장 조치를 설명합니다.
| 예외 형식 | 설명 | 권장 조치 | 자동 또는 즉시 다시 시도 참고 |
|---|---|---|---|
| 시간 제한 | 서버가 OperationTimeout에서 제어하는 지정된 시간 안에 요청된 작업에 응답하지 않았습니다. 서버가 요청된 작업을 완료했을 수도 있습니다. 이 예외는 네트워크 또는 기타 인프라 지연으로 발생합니다. | 필요한 경우 시스템 상태에서 일관성을 확인하고 다시 시도합니다. TimeoutException을 참조하세요. | 일부 경우 다시 시도하면 문제가 해결될 수 있습니다. 코드에 재시도 논리를 추가합니다. |
| 유효하지 않은 작업 | 요청한 사용자 작업이 서버 또는 서비스 내에서 허용되지 않습니다. 자세한 내용은 예외 메시지를 참조하세요. | 코드 및 설명서를 확인합니다. 요청된 작업이 유효한지 확인합니다. | 다시 시도해도 소용이 없습니다. |
| 작업 취소됨 | 이미 종료, 중단 또는 삭제된 개체에서 작업을 호출하려 시도합니다. 드문 경우지만 앰비언트 트랜잭션이 이미 삭제되었을 수 있습니다. | 코드를 확인하고 삭제된 개체에 대해 작업을 호출하지 않는지 확인합니다. | 다시 시도해도 소용이 없습니다. |
| 무단 액세스 | TokenProvider 개체가 토큰을 확보할 수 없거나, 토큰이 유효하지 않거나, 토큰에 작업 수행을 위해 필요한 클레임이 없습니다. | 올바른 값을 사용하여 토큰 공급자를 만드는지 확인합니다. ACS(Access Control Service) 구성을 확인합니다. | 일부 경우 다시 시도하면 문제가 해결될 수 있습니다. 코드에 재시도 논리를 추가합니다. |
| 인수 예외 인수 Null 인수가 범위를 벗어남 |
다음 문제 중 하나 이상이 발생했습니다. 메서드에 제공된 하나 이상의 인수가 잘못되었습니다. NamespaceManager 또는 Create에 제공된 URI에 하나 이상의 경로 세그먼트가 포함됩니다. NamespaceManager 또는 Create에 제공된 URI 스키마가 올바르지 않습니다. 속성 값이 32KB보다 큽니다. |
호출 코드를 확인하고 인수가 정확한지 확인합니다. | 다시 시도해도 소용이 없습니다. |
| 서버 작업 중 | 서비스가 지금은 요청을 처리할 수 없습니다. | 클라이언트가 잠시 대기한 후 작업을 다시 시도할 수 있습니다. | 클라이언트는 특정 간격 후에 다시 시도될 수 있습니다. 재시도에서 다른 예외가 발생한 경우 해당 예외의 재시도 작동을 확인합니다. |
| 할당량이 초과됨 | 메시징 엔터티의 최대 허용 크기에 도달했습니다. | 엔터티나 하위 큐에서 메시지를 수신하여 엔터티에 공간을 만듭니다. QuotaExceededException을 참조하세요. | 그 사이 메시지가 제거되었으면 재시도가 도움이 될 수 있습니다. |
| 메시지 크기 초과됨 | 메시지 페이로드가 256KB 제한을 초과합니다. 256KB 제한은 총 메시지 크기입니다. 총 메시지 크기는 시스템 속성과 모든 Microsoft .NET 오버헤드가 포함됩니다. | 메시지 페이로드의 크기를 줄인 다음 작업을 다시 시도합니다. | 다시 시도해도 소용이 없습니다. |
QuotaExceededException
QuotaExceededException 은 특정 엔터티에 대한 할당량이 초과됐음을 나타냅니다.
릴레이의 경우 이 예외는 수신기의 최대수가 이 엔드포인트에 대해 초과되었음을 나타내는 System.ServiceModel.QuotaExceededException을 래핑합니다. 이는 예외 메시지의 MaximumListenersPerEndpoint 값에 표시됩니다.
TimeoutException
TimeoutException 은 사용자가 시작한 작업이 작업 시간 제한보다 더 오래 걸린다는 것을 나타냅니다.
ServicePointManager.DefaultConnectionLimit 속성 값을 확인합니다. 제한에 도달하면 TimeoutException이 발생할 수 있습니다.
릴레이의 경우 릴레이 발신자 연결을 처음 열 때 시간 제한 예외가 발생할 수 있습니다. 이 예외의 일반적인 원인은 다음과 같이 두 가지가 있습니다.
- OpenTimeout 값이 너무 작을 수 있습니다(1초 미만).
- 온-프레미스 릴레이 수신기는 응답하지 않을 수 있으며(또는 수신기에서 새 클라이언트 연결을 허용하지 못하도록 방지하는 방화벽 규칙 문제가 발생할 수 있음) OpenTimeout 값은 20초보다 작습니다.
예시:
'System.TimeoutException’: The operation did not complete within the allotted timeout of 00:00:10.
The time allotted to this operation may have been a portion of a longer timeout.
일반적인 원인
이 오류에는 두 가지 원인이 있습니다.
잘못된 구성
작동 조건에 대한 작업 시간 제한이 너무 작을 수도 있습니다. 클라이언트 SDK에서 작업 시간 제한에 대한 기본값은 60초입니다. 코드의 값이 너무 작은 값으로 설정되었는지 확인합니다. CPU 사용량 및 네트워크 상태는 작업이 완료되는 데 걸리는 시간에 영향을 줄 수 있습니다. 작업 시간 초과를 매우 작은 값으로 설정하는 것이 좋습니다.
일시적인 서비스 오류
경우에 따라 릴레이 서비스에서 요청을 처리하는 데 지연이 발생할 수 있습니다. 예를 들어 트래픽이 높은 경우 발생할 수 있습니다. 이 오류가 발생하면 작업이 성공할 때까지 지연 후 작업을 다시 시도할 수 있습니다. 동일한 작업을 여러 번 시도한 후에도 계속 실패하는 경우 알려진 서비스 중단이 있는지 확인하기 위해 Azure 서비스 상태 사이트를 확인하세요.
ConnectionLostException - NameRenewalFailed
증상
클라이언트에서 다음 예외를 수신합니다. Microsoft.Azure.Relay.ConnectionLostException : InternalServerError: NameRenewalFailed.
원인
Azure Relay 서비스는 24시간마다 수신기 연결을 다시 시작합니다. 이 동작은 의도된 것입니다. Azure Relay 서비스는 24시간마다 활성 수신기 연결을 끊고, 수신기는 재시도 메커니즘을 사용하여 서버와 다시 연결합니다.
해결
수신기가 서버에 자동으로 다시 연결될 때 사용자 쪽에서는 아무 작업도 수행되지 않습니다. 수신기가 다시 연결되지 않는 경우 지원 팀에 티켓을 제출하세요.