메시지 재전송 시나리오
브로커가 메시지를 소비자에게 전달한 후 특정 조건에서 재전송(redelivery)을 수행한다. 다음 상황에서 메시지는 다시 큐로 돌아간다:
- 트랜잭션 기반 세션에서
session.rollback()호출 - 트랜잭션 세션에서
session.commit()완료 전session.close()실행 - CLIENT_ACKNOWLEDGE 모드에서
session.recover()호출 - 비트랜잭션 세션의 INDIVIDUAL_ACKNOWLEDGE 모드에서
session.recover()호출
AUTO_ACKNOWLEDGE 모드로 비동기 리스너를 구성한 경우, onMessage() 내부에서 처리 예외가 발생하고 이를 잡지 못하면 자동 재전송이 이루어진다.
DLQ 진입 조건
재전송 횟수가 브로커 설정 한도(기본값 6회)를 초과하면 소비자는 "poison ack"를 전송한다. 이 시점 해당 메시지는 poison pill로 분류되며 DLQ(Dead Letter Queue)로 이동한다.
주의할 점은 다음과 같다:
- 영구(persistent) 메시지가 만료되면 DLQ로 이동하지만, 비영구(non-persistent) 메시지는 DLQ로 들어가지 않는다.
- 별도 설정이 없으면 모든 실패 메시지는
ActiveMQ.DLQ라는 공용 큐에 모인다.
관리 콘 지표 해석
http://localhost:8161/admin 접속 후 큐 현황을 확인할 수 있다. 주요 컬럼 의미는 다음과 같다:
| 컬럼명 | 의미 |
|---|---|
| Number Of Consumers | 현재 연결된 소비자 수 |
| Number Of Pending Messages | 미소비 메시지 수(큐에 남아있는 메시지) |
| Messages Enqueued | 누적 enqueue 수, 재시작 시 초기화 |
| Messages Dequeued | 누적 dequeue 수, 재시작 시 초기화 |
영속화를 활성화한 경우, 재시작 후에도 Pending Messages에는 이전 미처리 메시지가 그대로 남아 있다.
개별 DLQ 정책 구성
activemq.xml의 <destinationPolicy> 영역에서 큐/토픽별 전략을 선언한다. 다음은 모든 큐에 대해 독립 DLQ를 생성하는 예시다:
<destinationPolicy>
<policyMap>
<policyEntries>
<policyEntry queue=">">
<deadLetterStrategy>
<individualDeadLetterStrategy
queuePrefix="DLQ."
useQueueForQueueMessages="true"/>
</deadLetterStrategy>
</policyEntry>
<policyEntry topic=">">
<pendingMessageLimitStrategy>
<constantPendingMessageLimitStrategy limit="1000"/>
</pendingMessageLimitStrategy>
</policyEntry>
</policyEntries>
</policyMap>
</destinationPolicy>
핵심 속성은 다음과 같다:
queuePrefix: DLQ 이름 앞에 붙는 접두어useQueueForQueueMessages: 큐 메시지를 큐 형태의 DLQ에 저장useQueueForTopicMessages: 토픽 메시지를 큐 형태의 DLQ에 저장(토픽 설정 시)
특정 east7-queue에 대해 <policyEntry queue="east7-queue">를 지정하면 해당 큐의 DLQ는 DLQ.east7-queue로 생성된다. queue=">" 와일드카드를 사용하면 모든 큐에 개별 DLQ가 할당된다.
확장 전략 예시
비영구 메시지도 DLQ에 보관하려면 processNonPersistent 속성을 활성화한다:
<policyEntry queue=">">
<deadLetterStrategy>
<sharedDeadLetterStrategy processNonPersistent="true"/>
</deadLetterStrategy>
</policyEntry>
반대로 만료된 메시지는 DLQ에 넣지 않으려면 processExpired를 비활성화한다:
<policyEntry queue=">">
<deadLetterStrategy>
<sharedDeadLetterStrategy processExpired="false"/>
</deadLetterStrategy>
</policyEntry>
업무 특성에 따라 individualDeadLetterStrategy와 sharedDeadLetterStrategy를 적절히 선택하여 운영해야 한다.