Querying Retry Messages
Last updated:2026-01-23 17:34:04
To ensure message lifecycle integrity in scenarios where business processing or message consumption fails, TDMQ for RocketMQ supports a retry mechanism after consumption failures.
For TDMQ for RocketMQ 4.x clusters, the number of message retries set on the client prevails.
For TDMQ for RocketMQ 5.x clusters, you can set the number of message retries when a group is created. If you use a 5.x client, the number of retries set on the server prevails. If you use a 4.x client, the number of retries set on the client prevails.
Scenarios
To check whether retry messages exist under a specific topic, you can query messages on the Retry Message Query page. You can expand the details to view information such as the time of each retry and the producer's IP address. In addition, you can export messages and view message details.
Operation Steps
1. Log in to the TDMQ for RocketMQ console, and click Retry 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 topic to be queried is located.
Topic: Select the topic to be queried.
Group: To query retry messages under a 5.x cluster, select the specific group subscribed to under this topic. This field is not required for 4.x clusters.
Time Range: Select the time range within which you want to query messages. The options include the last 30 minutes, last 1 hour, last 6 hours, last 24 hours, last 3 days, and a custom time range.
Query Methods: The message query feature supports the following query methods:
Query all: applies when the information about retry messages is unclear, and is used to query all retry messages under the current topic.
By message ID: This is a precise query method, with quick speed and accurate matching.
By message key: This is a fuzzy query method suitable for scenarios where you have not recorded the message ID but have set a message key.
Note:
To ensure the query speed, the server queries the most recent messages in chronological order when you select Query all. However, due to query time and display limitations, messages that need to be troubleshooted may not be located quickly. It is recommended that you use more specific query conditions, such as the message ID and message key.
3. Click Query. The list at the bottom of the page displays all query results with pagination.
4. After the query is completed, you can click a single message to view its retry status, such as the number of retries and the producer's IP address. You may also click Other Operations in the operation column to view message details and trace information.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No
Feedback