This documentation is about a version that is out of support, here is the latest documentation version.

How about downloading a newer, supported version?

troubleshooting-icon Performance troubleshooting

Learn how to monitor your Bonita Platform and troubleshoot performance issues.

We recommend that you monitor your system regularly, so that if you suspect a performance degradation, you can repeat these checks and identify the potential problem areas by comparing the performance to the normal level.

When troubleshooting a performance problem, we recommend that you first check your system and network, and then check your Bonita platform and configuration. Follow the order of the topics in this page. This will help you identify problems that occur because the actual load on the system exceeds the expected load so the provisioning is not sufficient. They will also help you identify transient problems.


These are the key indicators to check:

  • CPU: monitor CPU usage for each hardware platform, and check that it does not exceed 80%

  • CPU: check that all available CPUs are used on each hardware platform

  • Memory: monitor memory swap, and check that it is not used

  • Memory: monitor the amount of memory used

  • Disk: monitor disk I/O

Many tools exist in every operating system for system monitoring. For example:

  • For Linux: ps, top, iotop, vmstat, iostat, sysstat

  • For Windows : tasklist, process monitor, process explorer

These tools can be used in conjunction with monitoring systems such as like Nagios or Zabbix.

Bonita also provides a PlatformMonitoringAPI that you can use to obtain some of this information.


Network performance has a direct impact on the duration of an instance. We recommend that you measure network performance at the following points:

  • Between the server hosting the Bonita Engine and the database server. Check that the servers ping time duration is less than 1ms. There are many connections between Engine and the database, so network performance between these two servers has huge impact on performance.

  • Between the server hosting the Bonita Engine and any other servers used (typically those called by connectors). As connectors are often used to enable Bonita to communicate with outside world, network performance has impact on performance.


These are the key indicators to check:

  • Memory: heap, memory used by objects

  • Threads: Number of threads, number of deadlocks

A large number of deadlocks, or memory heap starvation may indicate a performance issue. Follow the JVM performance tuning recommendations and increase provisioning to get the optimum performance.

Many OpenSource and proprietary tools exist for JVM monitoring. These parameters can be obtained through monitoring system like Nagios or Zabbix. You can also retrieve them using the PlatformMonitoringAPI.


All databases provide information to monitor the following:

  • Connections: monitor the number of connections in parallel

  • Transaction: monitor the number of transactions that are committed, and the number that are rolled back

  • Memory : Size used by database,

  • Disk space used by database

If actual usage reaches the limit of available capacity, this can indicate a performance issue.

These values can be monitored through a monitoring system like Nagios or Zabbix. You can also get the number of active transaction using the MonitoringAPI.

Bonita Engine connections

Bonita Engine performance is strongly linked by the number of connections. The number of connections from the Bonita Runtime directly influences the number of connections to the database through the number of workers, and the number of connector threads.

To avoid overloading the Engine, check that the following connection numbers are coherent:

  • Bonita client

  • Bonita Engine

  • Database

Predict and then monitor the following:

  • Users: the total number of users and the maximum number of parallel users

  • Processes: the total number of instances of all processes and the maximum number of parallel tasks

All connection numbers must be defined according to the performance tuning recommendations:

Monitor SQL request duration time

From Bonita 7.10.6, by default, all queries taking more than one second to respond will be logged at the INFO level in the bonita log file, using the org.hibernate.SQL_SLOW logger.

An increasing number of those logs can mean :

  • The connection between database server and Bonita server is becoming slow.

  • Database server is overloaded.

  • Big Database volume can slow queries down. In this case, you might consider to purge unnecessary archive data.

The execution threshold value can be configured in


Purge archive tables

If you can afford to get rid of data of old finished process instances, use the purge tool to clean up unnecessary data that take volume in the database and that slows some queries down.


If a connector execution duration exceeds the configured timeout (300 seconds by default), an exception will be raised in the log:

Caused by: org.bonitasoft.engine.connector.exception.SConnectorException: The connector timed out

The connector execution with timeout is a Subscription feature for Subscription editions only.

This timeout can be increased in the Connector service configuration in (See platform setup) by increasing the value of the property bonita.tenant.connector.timeout.

Additionally, any connectors longer than 10 seconds will produce a warning log. See connector service for more information.

In addition, performance of connectors can be measured using the connector time tracker.

Cron jobs

The Bonita Engine uses the Scheduler service to trigger jobs in a recurrent manner. It might be possible to improve performance by optimizing the cron settings.

Performance tuning