Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Tuning a requestor pool configuration

Updated on April 5, 2022

By using the Requestor Pools landing page, you can tune requestor pool configuration to ensure the most effective use of system resources. For example, you can resize a requestor pool to adapt to incoming demand on requestors.

To tune a requestor pool for a service package, analyze the pool metrics and modify threshold values for the requestor pool. By analyzing the metric, you can evaluate the requestor pool performance and identify possible bottlenecks.

For example, if the requestor pool is fully in use and no idle requestors are available, then a new incoming request waits for a requestor to become idle. After the maximum waiting time passes, the new request times out. In this situation, you might want to increase values of idle requestors and maximum wait according to the expected load.

To access the Requestor Pools landing page, view the list of requestor pools, view details about a requestor pool, and open a service package form, you must have the PegaRULES:SysOpsObserver role. To perform all available actions on requestor pools, for example, to clear a requestor pool, you must also have the PegaRULES:SysOpsAdministrator role.

  1. In the navigation pane of Admin Studio, click ResourcesRequestor pools.
  2. Analyze the metrics for a requestor pool for which you want to tune the configuration.
    The Requestor Pools landing page displays the following metrics:
    Idle
    The number of requestors that are currently in the pool, available for use, and waiting for a service request.
    Active
    The number of requestors that are currently out of the pool, in use, and managing service requests.
    Longest wait time
    The longest time a service waited for a requestor to become available.
    Timeouts
    The number of times the system timed out while waiting for a requestor to become available.

    Values that are shown in red indicate potential issues and need to be reviewed:

    • If the value for most active requestors exceeds the maximum active threshold that is configured for the requestor pool, the value for active requestors is displayed in red to indicate that a pool size needs to be increased.
    • If the value for the longest wait time is above zero, the value is displayed in red to show that peak capacity has been reached.
  3. To analyze extended metrics and threshold values, click View details for service package for which you want to tune a requestor pool.
    The Requestor pool details dialog box displays additionally:
    Most idle
    The greatest number of requestors that were idle at the same time.
    Most active
    The greatest number of requestors that were active at the same time.
    Maximum idle
    The threshold value configured for a requestor pool on the Pooling tab in the Service Package form. The threshold is the maximum number of idle requestors that are allowed in the requestor pool.
    Maximum active
    The threshold value configured for a requestor pool on the Pooling tab in the Service Package form. The threshold is the maximum number of active requestors that can be in use at the same time.
    Maximum wait
    The threshold value configured for a requestor pool on the Pooling tab in the Service Package form. The threshold is the maximum time that the system can wait for a requestor to become available (return to the pool) when the service is waiting but the maximum number of active requestors was reached.
  4. Modify the threshold values for a requestor pool that you want to tune.
    1. In the Service package column, click the service package name for which you want to tune a requestor pool.
    2. On the Pooling tab on the Service Package form, modify one or more of the threshold values: Maximum idle, Maximum active, Maximum wait.
  5. Optional: Clear a requestor pool.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us