Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Throttle throttle mechanism is used to control access to the services at different levels. The WSO2 Web service Application Server (WSAS) WSO2 ESB provides an effective and efficient way to apply the throttle mechanism to your Web services.

Levels of Throttling

Throttling You can be enabled atenable throttling at the following levels in WSO2 ESB:

  • Global level - If it is enabled globally, restrictions are applied globally (for every message coming into the server).
  • Service level - If it is enabled for a particular service, restrictions are applied to all the messages coming into that service.Operation level - If it is enabled only for an operation in a given service, restrictions are applied only for the messages accessing that particular operation.

...

titleTip

...

  • service

...

  • .

Adding Throttling to a Service

...

1. Sign in. Enter your user name and password to log on to the ESB Management Console.

Image Removed

2. Click on "Main" in the left menu to access the "Manage" menu.

...

  • Range - The IP address range or the domain is restricted from accessing the service. Requests from such clients will be restricted based on the specified values.
  • Type - This indicates the type of Range. It can be IP or DOMAIN. It should be IP if the range is given as a single IP address or a range of IP addresses (for example, 10.100.1.30-10.100.1.60). It should be DOMAIN if the range is given as as a domain (for example, *.wso2.com). If you specify

    configurations types of

    both IP and DOMAIN, first priority will be given to DOMAIN level configurations.

    Info
    titleNote

    It is recommended to use IP based throttling instead of domain based throttling since the performance overhead is minimal when IP based throttling is used.

    Since the use of domain based throttling results in a high performance overhead, it is not provided by default with the ESB distribution. However, it can be provided as a patch if you need to use domain based throttling.

  • Maximum Request Count (MRC) - If  Access is set to Control, it will be the maximum number of requests that are served within the time interval specified by the Unit Time parameter.
  • Unit Time (UT) - The time period in milliseconds during which the maximum requests served. This is the number specified by the Maximum Request Count. The throttle starts counting the number of units from the moment it is enabled and the number of requests served within that period.
  • Prohibit Time Period (PTP) - If the maximum request count is achieved before the unit time, this is the period during which no more requests are allowed to go in. By setting this value, the unit time slot is altered.
  • Access
    • Allow - Means that no restriction is applied for that range and all requests are allowed to go in as they come in.
    • Deny - Means that access is completely denied for that range.
    • Control

      Info
      titleTip

      When the Access is set to Allow or Deny, MRC, UT and PTP parameters are not necessary and the said fields are deactivated. If it is Control, then the specified constraints are applied for that particular range.

...

  • Finish - Click "Finish" to submit the current data. When finished, your throttle configuration will be applied and the page will be redirected to the previous page.
  • Reset - Click "Reset" to load the last submitted configuration.
  • Default - Click "Default" to load the default throttle configuration. If you want to submit those data, you have to click Finish.
  • Clear - Click "Clear" to clear all the text boxes in the user interface.
  • Cancel - Click "Cancel" to go to the "Service Dashboard" page.

Excerpt

hiddentrue
Instructions on how to manage throttling foe services in WSO2 ESB.