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.