6.4. 관리 작업
AMQ Broker를 관리하기 위해 ScanSetting 또는 JMS 메시지를 사용하든 동일한 API 관리 작업을 사용할 수 있습니다. 관리 API를 사용하면 브로커, 주소 및 대기열을 관리할 수 있습니다.
6.4.1. 브로커 관리 작업
관리 API를 사용하여 브로커를 관리할 수 있습니다.
- 대기열 나열, 생성, 배포 및 제거
getQueueNames()메서드를 사용하여 배포된 대기열 목록을 검색할 수 있습니다.대기열을 만들거나 삭제할 수 있습니다.
createQueue(),deployQueue(), ordestroyQueue()on theActiveMQServerControl(ObjectNameorg.apache.activemq.artemis:broker="BROKER_NAME"또는 리소스 이름서버).deployQueue가 아무 작업도 수행하지 않는 동안 큐가 이미 존재하는 경우createQueue가 실패합니다.- 대기열 일시 정지 및 재시작
-
QueueControl은 기본 큐를 일시 중지하고 다시 시작할 수 있습니다. 대기열이 일시 중지되면 메시지가 수신되지만 전달되지 않습니다. 다시 시작되면 대기 중인 메시지 전달이 시작됩니다. - 원격 연결 나열 및 닫기
listRemoteAddresses()를 사용하여 클라이언트의 원격 주소를 검색합니다.closeConnectionsForAddress()메서드를 사용하여 원격 주소와 연결된 연결을 닫을 수도 있습니다.또는
listConnectionIDs()를 사용하여 연결 ID를 나열하고listSessions()를 사용하여 지정된 연결 ID에 대한 모든 세션을 나열합니다.- 트랜잭션 관리
브로커가 충돌하는 경우 브로커가 재시작되면 일부 트랜잭션에 수동 개입이 필요할 수 있습니다. 다음 방법을 사용하여 발생한 문제를 해결하는 데 도움이 됩니다.
listPreparedTransactions()메서드 목록을 사용하여 준비 상태에 있는 트랜잭션(Transaction이 불투명 Base64 Strings로 표시)을 나열합니다.이기종 트랜잭션을 해결하기 위해
commitPreparedTransaction()또는rollbackPreparedTransaction()를 사용하여 지정된 준비된 트랜잭션을 커밋하거나 롤백합니다.listHeuristicCommittedTransactions()및listHeuristicRolledBackTransactions메서드를 사용하여 가상적으로 완료된 트랜잭션을 나열합니다.- 메시지 카운터 활성화 및 재설정
enableMessageCounters()또는disableMessageCounters()메서드를 사용하여 메시지 카운터를 활성화 및 비활성화합니다.resetAllMessageCounters()및resetAllMessageCounterHistories()메서드를 사용하여 메시지 카운터를 재설정합니다.- 브로커 구성 및 속성 검색
-
ActiveMQServerControl은 모든 속성(예: 브로커의 버전을 검색하는getVersion()메서드)을 통해 브로커의 구성을 노출합니다. - Core Bridge 및 diverts 나열, 생성 및 제거
getBridgeNames()및getDivertNames()메서드를 각각 사용하여 배포된 Core Bridge 및 diverts를 나열합니다.createBridge()및destroyBridge()또는createDivert()및 destroyDivert() 및destroyDivert()를 사용하여 브리지 및 diverts를 생성하거나 삭제합니다(ObjectNameorg.apache.activemq.artemis:broker="BROKER_NAME"또는 리소스 이름서버).- 브로커를 중지하고 현재 연결된 모든 클라이언트에서 장애 조치를 강제 수행
ActiveMQServerControl에서forcefailover()를 사용합니다(ObjectNameorg.apache.activemq.artemis:broker="BROKER_NAME"또는 리소스 이름서버)참고이 방법은 실제로 브로커를 중지하므로 오류가 발생할 수 있습니다. 정확한 오류는 메서드를 호출하는 데 사용한 관리 서비스에 따라 다릅니다.
6.4.2. 주소 관리 작업
관리 API를 사용하여 주소를 관리할 수 있습니다.
ObjectName org.apache.activemq.artemis:broker=" <broker-name> ", component=addresses,address=" <address-name> " 또는 리소스 이름 주소 관리합니다.
. <address-name >과 함께 AddressControl 클래스를 사용하여주소를
addRole() 또는 removeRole() 메서드를 사용하여 주소에 대한 역할 및 권한을 수정합니다. getRoles() 메서드를 사용하여 큐와 연결된 모든 역할을 나열할 수 있습니다.
6.4.3. 대기열 관리 작업
관리 API를 사용하여 대기열을 관리할 수 있습니다.
코어 관리 API는 큐를 처리합니다. QueueControl 클래스는 큐 관리 작업( ObjectName,org.apache.activemq.artemis:broker=" <broker-name> ",component=addresses,address=",subcomponent=address>, routing-type> ",queue=" <queue-name> " 또는 리소스 이름 큐를 사용하여)를 정의합니다.
대기열의 대부분의 관리 작업에서는 단일 메시지 ID(예: 단일 메시지를 제거하기 위해) 또는 필터(예: 지정된 속성을 사용하여 모든 메시지를 만료)를 사용합니다.
- 만료, 배달 못 한 편지 주소로 전송 및 이동 메시지
expireMessages()메서드를 사용하여 큐에서 메시지를 만료합니다. 만료 주소가 정의되면 메시지가 이 주소로 전송되고, 그렇지 않으면 해당 주소가 삭제됩니다.broker.xml구성 파일의address-settings요소에서 주소 또는 주소 집합 (및 해당 주소에 바인딩된 대기열)의 만료 주소를 정의할 수 있습니다. 예를 들어 기본 브로커 구성 이해의 "기본 메시지 주소 설정" 섹션을 참조하십시오.sendMessagesToDeadLetterAddress()메서드를 사용하여 dead letter 주소로 메시지를 보냅니다. 이 메서드는 dead letter 주소로 전송된 메시지의 수를 반환합니다. 배달 못 한 문자 주소가 정의되면 메시지가 이 주소로 전송되고, 그렇지 않으면 큐에서 제거되고 삭제됩니다.broker.xml구성 파일의address-settings요소에서 주소 또는 주소 집합 (및 해당 주소에 바인딩된 대기열)에 대한 dead letter 주소를 정의할 수 있습니다. 예를 들어 기본 브로커 구성 이해의 "기본 메시지 주소 설정" 섹션을 참조하십시오.moveMessages()메서드를 사용하여 한 대기열에서 다른 큐로 메시지를 이동합니다.- 메시지 나열 및 제거
listMessages()메서드를 사용하여 대기열의 메시지를 나열합니다. 각 메시지에 대해맵단일 메시지 ID 변형에 대한
부울또는 필터 변형에 대해 제거된 메시지 수를 반환하는removeMessages()메서드를 사용하여 큐에서 메시지를 제거합니다. 이 방법은필터인수를 사용하여 필터링된 메시지만 제거합니다. 필터를 빈 문자열로 설정하면 모든 메시지가 제거됩니다.- 메시지 수
-
getMessageCount()메서드에서 큐의 메시지 수를 반환합니다. 또는countMessages()는 지정된 필터와 일치하는 대기열의 메시지 수를 반환합니다. - 메시지 우선 순위 변경
-
단일 메시지 ID 변형에 대한
부울또는 필터 변형에 대한 업데이트된 메시지 수를 반환하는changeMessagesPriority()메서드를 사용하여 메시지 우선 순위를 변경할 수 있습니다. - 메시지 카운터
-
listMessageCounter()및listMessageCounterHistory()메서드를 사용하여 큐에 대한 메시지 카운터를 나열할 수 있습니다( 6.6절. “메시지 카운터 사용”참조). 메시지 카운터는resetMessageCounter()메서드를 사용하여 단일 큐에 대해 재설정할 수도 있습니다. - 큐 속성 검색
-
QueueControl은 해당 속성을 통해 대기열 설정을 노출합니다(예:getFilter()를 사용하여 큐가 생성된 경우 큐의 필터를 검색하는 경우isDurable()to know whether the queue is corrupted, and so on). - 대기열 일시 정지 및 재시작
-
QueueControl은 기본 큐를 일시 중지하고 다시 시작할 수 있습니다. 대기열이 일시 중지되면 메시지가 수신되지만 전달되지 않습니다. 다시 시작되면 대기 중인 메시지 전달이 시작됩니다.
6.4.4. 원격 리소스 관리 작업
관리 API를 사용하여 브로커의 원격 리소스(수용자, 회전자, 브리지 등)를 시작하고 중지하여 브로커를 완전히 중지하지 않고 일정 기간 동안 오프라인으로 전환할 수 있습니다.
- 수락자
-
start()또는 를 사용하여 어셉터를 시작하거나 중지합니다.AcceptorControl클래스의stop()메서드 (ObjectNameorg.apache.activemq.artemis:broker=" <broker-name> ",component=acceptors,name=" <acceptor-name> "또는 리소스 이름acceptor. <address-name> ). acceptor 매개변수는AcceptorControl특성을 사용하여 검색할 수 있습니다. 수락자에 대한 자세한 내용은 네트워크 연결: 수락자 및 커넥터 를 참조하십시오. - diverts
-
divert
Control클래스에서start()또는stop()메서드를 사용하거나 (ObjectNameorg.apache.activemq.artemis:broker=" <broker-name> ",component=diverts,name=" <divert-name> "또는 리소스 이름이divert. <divert-name> ). divert 매개 변수는 divertControl 특성을 사용하여 검색할수 있습니다. - 브리지
-
start()(resp)를 사용하여 브리지를 시작하거나 중지합니다.BridgeControl클래스에서stop()메서드 (ObjectNameorg.apache.activemq.artemis:broker=" <broker-name> ",component=bridge,name=" <bridge-name> "또는 리소스 이름bridge. <bridge-name> ). Bridge 매개변수는BridgeControl특성을 사용하여 검색할 수 있습니다. - 브로드캐스트 그룹
-
BroadcastGroupControl클래스에서start()또는stop()메서드를 사용하여 브로드캐스트 그룹을 시작하거나 중지합니다. (ObjectNameorg.apache.activemq.artemis:broker=" <broker-name> ",component=broadcast-group> " 또는 리소스이름 broadcastgroup. <broadcast-group-name> ). broadcast group 매개변수는BroadcastGroupControl특성을 사용하여 검색할 수 있습니다. 자세한 내용은 Broker 검색 방법을 참조하십시오. - 검색 그룹
-
DiscoveryGroupControl클래스에서start()또는stop()메서드를 사용하여 검색 그룹을 시작하거나 중지합니다. (ObjectNameorg.apache.activemq.artemis:broker=" <broker-name> ",component=discovery-group,name=" <discovery-group-name> "또는 리소스 이름검색. <discovery-group-name> ). Discovery groups 매개변수는DiscoveryGroupControl특성을 사용하여 검색할 수 있습니다. 자세한 내용은 Broker 검색 방법을 참조하십시오. - 클러스터 연결
-
ClusterConnectionControl클래스에서start()또는stop()메서드를 사용하여 클러스터 연결을 시작하거나 중지합니다. (ObjectNameorg.apache.activemq.artemis:broker=" <broker-name> ",component=cluster-connection,name=" <cluster-connection-name> "또는 리소스 이름clusterconnection. <cluster-connection-name> ).ClusterConnectionControl특성을 사용하여 클러스터 연결 매개변수를 검색할 수 있습니다. 자세한 내용은 브로커 클러스터 생성을 참조하십시오.
