Rate limits can be used to control how hard agents are allowed to hit a target website. For example, a rate limit can be added for a certain website and be configured to allow a maximum number of page loads over a given time period. The rate limit is then assigned to all agents targeting this website, and the agents will stop once the maximum number of allowed page loads is reached.
Agents stopped by a rate limit will get the status Stopped and must be restarted or continued manually. A directory privilege Email on Rate Limit can be added to a user, and the user will then receive an email when an agent reaches a rate limit.
Rate limits can be viewed by users with the Admin role, but only added or edited by users with the Super Admin or Server Admin roles.
Rate limits allow you to control the maximum number of page loads or web requests, but also the maximum number of concurrent agent sessions.
The option Ticket on limit will create a failure ticket if the load limit or the session limit is reached. The ticket will be sent to users via an email with the Email on Rate Limit privilege. A user can enable or disable the ticket generation due to rate limit.
However, if the agent is stopped after collecting some data due to the rate limit applied to that agent then a user have flexibility to access its Partial data from its Job history and Run history.
Partial data on Run history Partial data on Job history
The option Prevent start on limit will prevent agents from starting if the load limit or session limit is reached. If this option is not set, the agents will start, but an email will be sent to users with the Email on Rate Limit privilege.
A rate limit can be added to one or more organizations, or it can have a global scope where it's shared by all organizations. Set the option All organizations to give the rate limit a global scope.
A rate limit can be added to one or more agents, or it can be added to all the agents for an organization. Set the option All agents to add the rate limit in all agents for an organization. This option can also give a global scope where the rate limit is shared with All organizations.
The option Per agent gives a scope to add the rate limit privately to an agent. This also allows user to add same rate limit to multiple agents.
The option Success on limit can be used to set the run status as Succeeded however the agents will get stopped when the load limit is reached. The ticket will be sent to users via an email with the Email on Rate Limit privilege.
To add a rate limit to an organization, first select the organization from the Organization drop down, and then select the rate limit from the Rate Limit drop down. The Rate Limit drop down will only show rate limits that don't have a global scope. Click the + button to add the rate limit to the organization.
To do modification in rate limit, click on the context menu of selected rate limit.
Edit- A user can edit the rate limit and the changes will get applied automatically to all associated agents and organizations.
Reset load counter- Load counter displays in 'Current' column. This will show the count of current page load/requests used by the agents. With reset load counter option, a user can again initiate a page loads limit from start i.e. the counter will again start from zero.
Delete- A user can delete the rate limit and it will get removed automatically to all associated agents and organizations.
Audit Logs - A user can check what changes has been done, who did that and when with audit logs option. Audit logs contain details about user activities. For more details please read Audit Trail article.
An organization can be configured to require rate limits for all agents. You can still check-in agents to an organization that requires rate limits for all agents, but the agents will not start without an assigned rate limit.
A rate limit is assigned to an agent by clicking on the check or cross icon in the Rate Limit column in the Agent Repository.
A popup will appear when you click on the check or cross icon allowing you to select a rate limit or remove an existing rate limit. The Rate Limit drop down will contain all rate limits with a global scope and all rate limits assigned to your organization.
Only users with the Admin role can assign rate limits to agents.