Artemis Getting Started
Queue Cluster Overview
The Artemis Queue Explorer uses the following concepts to more easily look at messages across multiple Artemis Queue Clusters.
Cluster - A title you can use to manage a grouping of Artemis Clusters
Cluster Member - Define one or more Artemis servers that belong to the same environment, for instance Production. Each Cluster Member provides connectivity to an Artemis server.
Creating a Cluster
To create a new Queue Cluster:
Click the Add Cluster button
Enter the alias for your Queue Cluster, for our example we will use Correspondence as the alias for the queue cluster.
Click OK and the Cluster Member editor will be displayed.
Now fill in the following fields and press OK. For this step you may need information from your Artemis administrator to fill in the fields below.
Member Alias - A descriptive name or could be the server name
Broker Name - The broker name
Jolokia - Andi uses Jolokia management functions to contact the Artemis server for much of the basic queue statistics.
JMS - The Java Message Port (JMS) for the Artemis server
Connecting
Now that we have a correspondence Cluster, we can connect by selecting either A Cluster or Cluster members and clicking one of the the Connect buttons. Selecting the cluster and pressing OK will connecting to all cluster members defined. Expanding the cluster allows you to select one or more cluster members. Choosing all of the members is the same as selecting the Queue Cluster.
- Connect to the cluster or the member(s) if selected.
- Uses Queue Name Filters button to limit the number of queues returned by providing one or more patterns.
If the connection is successful, you will be presented with a list of 0-n queues from 1-n Cluster Members depending on your selection.
Queue Results
After connecting with the Returns Queue Name Filter, the matching queues are returned with the first column being the Cluster Member Alias to indicate which physical server the message is located on. This allows you to work with a specific queue, or all of the queues in a cluster at the same time.
If your connect returned many queues, you can use the Filter entry at the bottom to quickly filter the queues displayed. For example you can enter *Returns.
The statistics are static which means if you want to see the current stats, you can press the Refresh Stats button to update statistics for all of the queues or select one or more rows and press the button to update only those rows.
Refresh Every - To continually refresh:
Enter the number of seconds between refreshes
Select the Refresh Every checkbox
Press the Refresh Status button which will remain depressed
Press the Refresh Stats button again to turn off the automatic refresh
Operations
To perform an operation on one or more queues, select the queue(s) and press the right mouse button. A pop-up menu will be displayed that will allow access to different operations depending on which queue(s) is selected.