🎄 Happy Holidays! 🥳
Most of Solace is closed December 24–January 1 so our employees can spend time with their families. We will re-open Thursday, January 2, 2024. Please expect slower response times during this period and open a support ticket for anything needing immediate assistance.
Happy Holidays!
Please note: most of Solace is closed December 25–January 2, and will re-open Tuesday, January 3, 2023.
How to see information on each message in a queue
Problem
You want to check the messages you are sending for error checking or validation but don’t know how to do that.
Prerequisite
Download Solace Java or .NET APIs
Download SDKPerf
Solution
You can do that in two ways:
- Option 1: Use a queue browser with either the Solace Java or .NET API or SDKPerf
- Option 2: Use Solace Command Line Interface (CLI)
For both options, make sure that at the end you log in to PubSub+ Manager to see that the messages are still spooled on the queue.
Option 1: A -- Use a queue browse with the Solace Java or .NET API
To see information on each message in a queue using the Solace Java or .NET API, follow these steps.
Option 1: B – Use a queue browser with SDKPerf
With SDKPperf, you can add a -md flag to dump the message to the screen to see the message as your queue browser.
To see information on each message in a queue using SDKPerf for testing, follow these steps:
Type the command
_sdkperf_java -cip tcp://<ip address>:5555 -cu <client_username>@<vpn> -pql=<queue> -mt=persistent -mn=<number of messages to send>_
to write messages to a queue with no consumers.Here is an example:
sdkperf_java_d34 -cip tcp://192.168.133.47:55555 -cu wade_cu@wade_vpn -pql=wade_q -mt=persistent -mn=10 -msa=100
Type the command
_sdkperf_java -cip tcp://<ip address>:5555 -cu <client_username>@<vpn> -sql=<queue> -md -qb_
to browse the messages with a queue browser.Here is an example:
sdkperf_java_d34 -cip tcp://192.168.133.47:55555 -cu wade_cu@wade_vpn -sql=wade_q –qb -md
Option 2
To see information on each message in a queue without consuming them using Solace CLI, follow these steps:
- Log in to the CLI through either the management console or Secure Shell (SSH) connections.
- Type the command
_show queue <queueName> message-vpn <vpnName> message detail_
.
The output shows you the information on each message in the queue, such as the date spooled, the message size, and the sequence number.
Result
You should be able to see the information on each message in your queue now.
Learn more
*Documentation: Browsing Guaranteed Messages
Comments
-
Learn more
*Documentation: Browsing Guaranteed MessagesSeems the link is dead. I would be interested to get one message instance in the message browser (Java) without looping over the whole set of messages.
0 -
Thanks @pruffieux, link fixed!
0 -
Hi @pruffieux, welcome back to your old thread..!
I've written a tool to do exactly this. Download a copy here: https://github.com/SolaceLabs/pretty-dump/releases/latest/download/PrettyDump.zip
Then, run it with
-h
to see command-line help. But essentially you'll do:$ bin/PrettyDump url vpn user pw b:queueName Browse all messages -> press [ENTER], or enter specific Message ID, or range of IDs (e.g. "25909-26183" or "9517-"):
Then you just type in the specific Message ID. Doesn't work with
replicationGroupMessageId
. Yet. That's maybe a good idea.NOTE: this is a Java tool, so you'll need a JRE. The next version will also be available as a Docker image.
1 -
Thanks for sharing your solution. As I am interested by doing this in Java, I notice in your code you're looping over the whole queue and exit when you find the given messageID (for a single search).
I knew I can do that but I was thinking there is perhaps a more efficient way to do it. I am note sure about the performance if a queue contains thousands (or millions) of messages.
0 -
Yeah, if there's millions or billions of messages, this approach could/would be quite inefficient. Another option is to use the more recent broker feature of copying a message from one queue to another. If you happen to know the message's Replication Group Message Id, you can use that to copy the message. This is different than the Message ID above (which is the message spool ID in the broker).
For example, let's say I have a billion messages on my queue, but I just want to browse the most recent one. I can use the CLI command
show queue q1 message-vpn default messages newest detail
Name: q1 Message VPN: default Message Id: 4187008 Priority: n/a Date spooled: Apr 12 2024 09:25:33 UTC Replication Group Message Id: rmid1:2cf0b-4a19b6301d4-00000000-003fe380 <--- Sequence Number: n/a Expiry Time: never Delivery Eligible Time: now Dead Message Queue Eligible: yes Content: 0.0000 MB Attachment: 0.0003 MB Replicated: no Replicated Mate Message Id: n/a Sent: no Redeliveries: 0 PartitionKey: PartitionKeyHash: 0
I could make a temporary queue
tempQ
. And then run the CLI commands:enable admin message-spool message-vpn default copy-message source queue q1 destination queue tempQ message rmid1:2cf0b-4a19b6301d4-00000000-003fe380 show tempQ Queue Name Messages Spool Bind Status Message VPN Spooled Usage(MB) HWM (MB) Count I E A S D P tempQ default 1 0.00 0.00 0 U U E N D N
Then browse/consume that.
If you know how to do SEMPv1, the equivalent copy command would be:
<rpc> <admin> <message-spool> <vpn-name>default</vpn-name> <copy-message> <source/> <queue-name>q1</queue-name> <destination/> <queue-name>tempQ</queue-name> <message/> <replication-group-msg-id>rmid1:2cf0b-4a19b6301d4-00000000-003fe380</replication-group-msg-id> </copy-message> </message-spool> </admin> </rpc>
1