How to requeue a broken item in prod in a queue processor

General
1

How to requeue a broken item in prod in a queue processor?Is there any way we can automate this process?like it requeue’s on its own despite crossing the threshold limits of retry configured in Queue Processor

2

To requeue a broken item in a queue processor in production, you need to follow these manual steps in Admin Studio:

  1. Access Agent Queues: Navigate to Admin Studio and click Resources > Agent queues.
  2. View Broken Items: Click on the “Broken” tab to see items that have failed processing.
  3. Select the Queue: In the Queue(s) grid, click on the queue containing the items you want to requeue.
  4. Requeue Items: You can requeue items individually by selecting them in the Item(s) grid and clicking “Re-queue”.

Important Note: You must have the PegaRULES:SysOpsObserver role to view queues and the PegaRULES:SysOpsAdministrator role to take actions on queue items.

When you requeue a work item, it moves from the Broken queue back to the Scheduled queue for processing.

Regarding Automation: Based on the available information, queue processors do have a built-in retry mechanism that automatically retries operations according to your defined retry policy before moving items to the broken queue. You can configure:

  • Initial delay: The period of time before the first retry attempt
  • Maximum retries: The maximum number of times the system attempts to process an item
  • Delay factor: The factor by which the initial delay is multiplied for successive retry attempts

However, once an item reaches the Broken queue (after exhausting all configured retry attempts), there is no automatic requeuing mechanism that bypasses the threshold limits. Items in the Broken queue require manual administrative intervention to requeue. This is by design to ensure that administrators can investigate and resolve the root cause of failures before reprocessing, preventing potential data integrity issues or repeated failures.

The manual requeue process ensures that administrators assess whether requeuing is appropriate and won’t negatively affect the case or create additional problems.
*
Pegasystems Documentation
Understanding agent queues
Asynchronous integration | Pega Academy
Creating a Queue Processor rule | Pega Academy

3

Hi @Shahadat_Ansari I am aware of the admin studio logic but can we do all this in prod thats my main question?

4

It’s not recommended but we can achieve using custom activity which iterates over broken items which we can get from pr_sys_delayed_queue table and run pxRequeueQueueItem activity