Querying Scheduled and Delayed Messages (5.x)
Last updated:2026-01-23 17:34:04
Scenarios
Scheduled/delayed messages are important in TDMQ for RocketMQ.
Scheduled messages: After a message is sent to the server, the business may want the consumer to receive it at a later time point rather than immediately. Messages of this type are called scheduled messages.
Delayed messages: After a message is sent to the server, the business may want the consumer to receive it after a period of time rather than immediately. Messages of this type are called delayed messages.
In fact, delayed messages can be seen as a special usage of scheduled messages, and their ultimate implementation effects are the same.
Query Limits
The message retention time is set for messages in TDMQ for RocketMQ clusters. That is, consumed messages are retained for a period of time on the server (3 days for the Trial and Basic editions and 7 days or longer at the topic level for the Pro and Platinum editions). Within the message retention time, delayed and scheduled messages can be queried.
For example, a delayed message (delayed for 10 days) is sent at 1:00 on January 1 in a cluster, and the message is retained for 3 days in the cluster. When the message is sent to the consumer at 1:00 on January 11, and the message is consumed successfully, the message can be queried on this page before 1:00 on January 14.
Note:
Only 5.x clusters support querying scheduled and delayed messages.
Operation Steps
1. Log in to the TDMQ for RocketMQ console and click Delayed Message Query in the left sidebar.
2. On the message query page, select a region and enter the query conditions as prompted.
Cluster: Select the cluster where the delayed messages to be queried reside.
Message ID: Enter a message ID to precisely locate the specific message.
3. Click Query. The list at the bottom of the page displays all query results with pagination.
4. After the query is complete, you can view the message creation and production time. Similar to other message query results, you can view the message trace and export messages.
5. Click View Message Trace in the operation column or select the Message Trace tab on the details page to view the message trace. (For detailed explanations, see Message Trace Query Result Description.) In the Message Consumption section, you can see the scheduled delivery time and consumption status of the message.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No
Feedback