This documentation is for WSO2 Enterprise Service Bus version 5.0.0. For the latest ESB, view the latest WSO2 Enterprise Integrator documentation.

All docs This doc
||
Skip to end of metadata
Go to start of metadata

This section explains how to tune parameters that control the performance of ESB Analytics when it is affected by high loads, network traffic etc. These parameters should be tuned based on the deployment environment.

Tuning carbon.xml parameters

When a batch of data is processed and published to the Analytics dashboard, the ESB idles for a defined time interval before processing another batch of data. This is to ensure that too much data will not be stored in Analytics at a given time. By default, the ESB idles for 5000 milliseconds (5 seconds)

If you want to change the default idle time, add the following configuration to the <ESB_HOME>/repository/conf/carbon.xml file (as an element under <Server>) and specify the required idle time interval.

<MediationFlowStatisticConfig> 
    <StatWorkerIdleInterval></StatWorkerIdleInterval> 
</MediationFlowStatisticConfig>

The parameter used in the above configuration is explained below.

ParameterDescriptionTuning Recommendation
StatWorkerIdleInterval
The number of milliseconds that should elapse after a batch of statistical data is processed (to be published in the Analytics Dashboard) before sending another batch.

The general recommendation is 5000 milliseconds (i.e. 5 seconds). Therefore, your ESB is tuned to this value by default.

When WSO2 ESB is handling a high load of requests, this value can be reduced to increase the frequency with which the resulting statistics are published in the Analytics Dashboard. This helps to avoid storing too much data in the ESB server causing an overconsumption of memory.

When the load of requests handled by the ESB is comparatively low, this time interval can be increased to reduce the system overhead incurred by frequent processing.

Tuning data-agent parameters

The parameters in the <ESB-HOME>/repository/conf/data-bridge/data-agent-config.xml file can be tuned as follows.

ParameterDescriptionDefault ValueTuning Recommendation
QueueSizeThe number of messages that can be stored in the ESB server at a given time before they are sent to be published in the Analytics Dashboard.32768

This value should be increased when the ESB Analytics server is busy due to a request overload or if there is high network traffic. This prevents the generation of the queue full, dropping message error.

When the ESB Analytics server is not very busy and when the network traffic is relatively low, the queue size can be reduced to avoid an overconsumption of memory.

The number specified for this parameter should be a power of 2.


BatchSizeThe ESB statistical data sent to the ESB Analytics server to be published in the Analytics Dashboard are grouped into batches. This parameter specifies the number of requests to be included in a batch.200This value should be tuned in proportion to the volume of requests sent from the ESB server to the ESB Analytics server. This value should be reduced if you want to reduce the system overhead of the ESB Analytics server. This value should be increased if the ESB server is generating a high amount of statistics and the QueueSize cannot be further increased without causing an overconsumption of memory.
CorePoolSizeThe number of threads allocated to publish ESB statistical data to the Analytics Dashboard via Thrift at the time the ESB server is started. This value increases when the throughput of statistics generated increases. However, the number of threads will not exceed the number specified for the MaxPoolSize parameter.1The number of available CPU cores should be taken into account when specifying this value. Increasing the core pool size may improve the throughput of statistical data published in the Analytics Dashboard, but latency will also be increased due to context switching.
MaxPoolSizeThe maximum number of threads that should be allocated at any given time to publish ESB statistical data in the Analytics Dashboard.1The number of available CPU cores should be taken into account when specifying this value. Increasing the maximum core pool size may improve the throughput of statistical data published in the Analytics Dashboard, since more threads can be spawned to handle an increased number of events. However, latency will also increase since a higher number of threads would cause context switching to take place more frequently.
 Click here to view a list of errors that can be avoided by tuning the above parameters
  • TID: [-1234] [] [2016-05-05 19:12:02,393]  WARN {org.wso2.carbon.databridge.agent.DataPublisher} -  Event queue is full, unable to process the event for endpoint group [ ( Receiver URL : tcp://127.0.0.1:7611, Authentication URL : ssl://127.0.0.1:7711) ], dropping the event. {org.wso2.carbon.databridge.agent.DataPublisher}
  • TID: [-1] [] [2016-05-05 19:11:18,642] ERROR {org.wso2.carbon.databridge.agent.endpoint.DataEndpoint} -  Unable to send events to the endpoint.  {org.wso2.carbon.databridge.agent.endpoint.DataEndpoint}
    org.wso2.carbon.databridge.agent.exception.DataEndpointException: Cannot send Events
  • TID: [-1] [] [2016-05-05 19:11:18,642] ERROR {org.wso2.carbon.databridge.agent.endpoint.DataEndpoint} -  Unable to send events to the endpoint.  {org.wso2.carbon.databridge.agent.endpoint.DataEndpoint}
    org.wso2.carbon.databridge.agent.exception.DataEndpointException: Cannot send Events
  • No labels