Monitoring database connection usage

Jira provides a view of its database connection usage. This provides information on the activity of the connection pool, as well as the frequency of reads/writes to the database. You can use this information to tune your database connections for better performance.

The instructions on this page describe how to navigate to the database connection usage information in the Jira administration console, and how to interpret the information. If you want to make changes to your database connection pool settings using this information, see this related topic: Tuning database connections.

Note: For all of the following procedures, you must be logged in as a user with the Jira Administrators global permission.

Data Center monitoring

If you're running Jira Data Center, see the latest available monitors.

Accessing the Database Monitoring page

  1. Choose Administration () > System.
  2. Select Database Monitoring, which can be found under System support to display the Database Monitoring page.
    Database monitoring page.

Interpreting the database monitoring graphs

Connection Pool graph

The 'Connection Pool' graph shows the activity in the connection pool for the last 6 hours.

  • This graph shows the number of active and idle connections, as well as the maximum and minimum for the period. 
  • The scale of the vertical axis is equal to the maximum number of connections.
  • The readings are averages over a period of 5 minutes.

This information can help you to optimize database connection usage. For example, if the number of active connections is consistently or frequently near to the maximum available, then you may need to raise the maximum connections available in the pool. Conversely, if the number of active connections is consistently low compared to the maximum available, then you may want to lower the maximum connections available in the pool. For more information on how to tune database connections, see Tuning database connections.

Reads / Writes graph

The 'Reads / Writes' graph shows the frequency of reads and writes to the database over a period of time. It can be helpful to correlate database usage with connection pool usage. Whenever Jira needs to access (i.e. read from or write to) the database, a database connection is required. If there are regular spikes in the reads / writes, you may need to consider raising the maximum connections available in the pool.

Last modified on Jun 23, 2020

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.