4.13. dead letter address로 전달되지 않은 메시지 이동

프로세스

1. &lt ;broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 큐 이름과 일치하는 < address-setting > 요소에서 dead letter address name 및 최대 전달 시도 수를 설정합니다. 예를 들면 다음과 같습니다.

   <configuration ...>
      <core ...>
         ...
         <address-settings>
            ...
            <address-setting match="exampleQueue">
               <dead-letter-address>DLA</dead-letter-address>
               <max-delivery-attempts>3</max-delivery-attempts>
            </address-setting>
         ...
         <address-settings>
   <configuration ...>

   match

   브로커가 이 address-setting 섹션에서 구성을 적용하는 주소입니다. < address-setting > 요소의 match 특성에 와일드카드 표현식을 지정할 수 있습니다. 와일드카드 표현식은 < address-setting > 요소에 구성된 dead letter 설정을 일치하는 주소 세트와 연결하려는 경우에 유용합니다.

   dead-letter-address

   dead letter address의 이름입니다. 이 예에서 브로커는 큐 exampleQueue 에서 dead letter 주소 DLA 로 전달되지 않은 메시지를 이동합니다.

   max-delivery-attempts

   전달되지 않은 메시지를 구성된 dead letter 주소로 이동하기 전에 브로커가 수행한 최대 전달 시도 수입니다. 이 예에서 브로커는 전달 시도가 실패한 세 번의 배달 시도 후 전달되지 않은 메시지를 dead letter address로 이동합니다. 기본값은 10 입니다. 브로커가 무한 수의 재전송 시도를 만들려면 값 -1 을 지정합니다.

3. address 섹션에서 dead letter address 인 DLA 의 address 요소를 추가합니다. dead letter 큐를 dead letter 주소와 연결하려면 큐 의 name 값을 지정합니다. 예를 들면 다음과 같습니다.

   <configuration ...>
      <core ...>
         ...
         <addresses>
            <address name="DLA">
               <anycast>
                  <queue name="DLQ" />
               </anycast>
            </address>
         ...
         </addresses>
      </core>
   </configuration>

프로세스

1. &lt ;broker_instance_dir> /etc/broker.xml 구성 파일을 엽니다.

2. 일치하는 큐 또는 큐 집합에 대한 dead letter 주소를 정의하기 위해 이전에 추가한 <address-setting > 요소를 찾습니다. 예를 들면 다음과 같습니다.

   <configuration ...>
      <core ...>
         ...
         <address-settings>
            ...
            <address-setting match="exampleQueue">
               <dead-letter-address>DLA</dead-letter-address>
               <max-delivery-attempts>3</max-delivery-attempts>
            </address-setting>
         ...
         <address-settings>
   <configuration ...>

3. < address-setting > 요소에서 브로커에 dead letter 리소스(즉, 주소 및 큐)를 자동으로 생성하도록 지시하는 구성 항목과 이러한 리소스의 이름을 지정하는 방법을 추가합니다. 예를 들면 다음과 같습니다.

   <configuration ...>
      <core ...>
         ...
         <address-settings>
            ...
            <address-setting match="exampleQueue">
               <dead-letter-address>DLA</dead-letter-address>
               <max-delivery-attempts>3</max-delivery-attempts>
               <auto-create-dead-letter-resources>true</auto-create-dead-letter-resources>
               <dead-letter-queue-prefix>DLQ.</dead-letter-queue-prefix>
               <dead-letter-queue-suffix></dead-letter-queue-suffix>
            </address-setting>
         ...
         <address-settings>
   <configuration ...>

   auto-create-dead-letter-resources

   브로커가 전달되지 않은 메시지를 수신하기 위해 dead letter address 및 queue를 자동으로 생성하는지 여부를 지정합니다. 기본값은 false입니다.

   auto-create-dead-letter-resources 가 true 로 설정된 경우 브로커는 dead letter address 및 관련 dead letter 큐를 정의하는 <address> 요소를 자동으로 생성합니다. 자동으로 생성된 < address > 요소의 이름은 < dead-letter-address>에 지정하는 name 값과 일치합니다.

   브로커가 자동으로 생성된 < address > 요소에서 정의하는 dead letter 큐에는 멀티캐스트 라우팅 유형이 있습니다. 기본적으로 브로커는 배달되지 않은 메시지의 원래 주소와 일치하도록 dead letter 큐의 이름을 지정합니다(예: 주식 ).

   브로커는 _AMQ_ORIG_ADDRESS 속성을 사용하는 dead letter queue에 대한 필터도 정의합니다. 이 필터를 사용하면 dead letter 큐가 해당 원래 주소로 전송된 메시지만 수신합니다.

   dead-letter-queue-prefix

   브로커가 자동으로 생성된 dead letter 큐의 이름에 적용되는 접두사입니다. 기본값은 DLQ입니다.

   접두사 값을 정의하거나 기본값을 유지하는 경우 dead letter 큐의 이름은 접두사와 원래 주소(예: DLQ.stocks )의 연결입니다.

   dead-letter-queue-suffix

   브로커가 자동으로 생성된 dead letter 큐에 적용되는 접미사입니다. 기본값은 정의되지 않습니다(즉, 브로커는 접미사를 적용하지 않음).