データベース接続のチューニング
接続プールアーキテクチャー
JIRA がデータベースにアクセスする (即ち、読み出しまたは書き込みを行う) 場合、必ずデータベース接続が必要になります。
データベース接続とは、JIRA とデータベース間のすべての通信を処理する、複雑でサイズも大きなオブジェクトを意味します。従ってデータベース接続の確立は時間のかかる処理であり、ま たクライアント (JIRA アプリケーション) とデータベースサーバーの双方で大量のメモリーを消費します。
JIRA からのデータベースアクセス要求に対して毎回新しいデータベース接続を確立するという重い処理を回避するために、既に確立されたテータベース接続のプール を維持管理する方法がとられています。JIRA からの新たなデータベースアクセス要求のたびに、既に確立されたテータベース接続プールから要求に応じて選ばれた接続が利用されます。従って :
- JIRA の起動時にはプール内において JIRA とデータベース間の最小限のデータベース接続が確立されます。
- JIRA からデータベースにアクセスする必要が生じたときには、JIRA は :
- プールに対してデータベース接続を要求します
- そのデータベース接続を使用してデータベースの読み出しまたは書き込みを行います
- 処理が終了するとデータベース接続をプールに戻します。
JIRA のデータベースアクセス要求の頻度がプールにおける利用可能な接続数を超え始めたときは、その負荷を処理するために接続が自動的に追加されます。
逆に、JIRA のデータベースアクセス要求頻度がプールにおける利用可能なデータベース接続数を下回り始めると、接続を自動的にクローズしてリソースをシステムに返すようにすることができます。
最近のデータベースは多数の接続を比較的簡単に処理することが可能で、メモリーさえ十分にあれば同時接続可能数は数百にもなります。ただし、クライ アント側では接続は大量のメモリーを消費します。従って、最大接続数をそれよりずっと小さい数に制限して、接続する必要が生じたアプリケーションがほぼ待 つことなく接続を利用できるようにするのが一般的です。
JIRA データベース接続のチューニング
- JIRA を終了します。
- 次のいずれかを行います。
- JIRA 設定ツール を使用して、JIRA のデータベース接続を調整します。
- JIRA 設定ツールを起動します。
- Windows: Open a command prompt and run
config.batin thebinsub-directory of the JIRA installation directory. - Linux/Unix: Open a console and execute
config.shin thebinsub-directory of the JIRA installation directory.
This may fail with the error as described in our Unable to Start JIRA applications Config Tool due to No X11 DISPLAY variable was set error KB article. Please refer to it for the workaround.
Please Note: You may need to set the JAVA_HOMEenvironment variable to run the JIRA configuration tool. See Installing Java for details. - Windows: Open a command prompt and run
- Once the JIRA configuration tool is running, click its Advanced tab.
- このタブで指定可能なオプションの詳細については、下の 接続プールの設定 を参照してください。これらのオプションの値を指定するには、先に一番左のチェックボックスにチェックを入れる必要があります。 上図のオプションのいくつかは、単なるチェックボックスです（たとえば、JIRA 設定ツールの中央付近にあるチェックボックス)。これらのチェックボックスにチェックを入れると、それに関連するオプションの値が「true」に設定されます。逆に、チェックをはずすと、それに関連するオプションの値が「false」に設定されます。
- [Save] ボタンをクリックして変更を保存すると、
dbconfig.xmlファイルの要素として格納されます。
- JIRA 設定ツールを起動します。
- Alternatively, edit the
dbconfig.xmlfile at the root of your JIRA home directory.- Refer to Connection pool settings below for more information about the elements you can add to your
dbconfig.xmlfile to fine tune JIRA's database connection. - 編集済みの
dbconfig.xmlファイルを保存します。
- Refer to Connection pool settings below for more information about the elements you can add to your
- JIRA 設定ツール を使用して、JIRA のデータベース接続を調整します。
- JIRA を再起動します。
接続プールの設定
| JIRA 設定ツール 「詳細」タブ オプション | | 説明 | 推奨事項/注意事項 | デフォルト値* |
| 最大サイズ |
| 同時にオープン可能なデータベース接続の最大数。 | この値は、JIRA がデータベース接続要求を出したときにほぼ待つことなくそれを利用できるように、十分大きくなければなりません。 このパラメーターの設定方法に関連するヒントは、下の「監視」の項目をご覧ください。 | 20 |
| 最大アイドル状態 |
| プール内でアイドル状態のまま保持可能なデータベース接続の最大数。 | この値を負に設定すると、プール内でアイドル状態のまま存在可能なデータベース接続の最大数は無制限になります。 下で説明する Minimum Idle/Size の値が上で説明した Maximum Size の値と同一の場合 (デフォルトではこれが成立します) は、この設定は無意味になります。 | Maximum Size の値 |
| 最小アイドル状態/サイズ |
( | 同時にオープンしているアイドル状態のデータベース接続の最小数。 | この値を上で説明した Maximum Size と同一にすると (デフォルトではこれが成立します)、プールにおける接続数は一定でアイドル接続がクローズされることはありません。 非常に大きな JIRA システムでは、これを Maximum Size より小さな値とすることでリソースが節約できるというメリットが生ずる場合があります。 | Maximum Size の値 |
| 初期サイズ |
| プール内でオープンされるデータベース接続の初期値。 | JIRA が起動されると多数のデータベース接続が迅速に作成されるため、通常この値を (0 以外の値に) 設定する必要はありません。 | 0 |
| 最大待機時間 |
| プールに空き接続がない場合に、データベース接続が利用可能となるまでに JIRA がエラーとならずに待機する最大時間 (単位はミリ秒)。 | '-1' を指定すると Tomcat の待ち時間は無期限となります。 この値は、競合が発生してもそれに対応できる程度に十分長い時間としなければならないと同時に、無応答やブラウザータイムアウトとなる前にユーザーに対して適切なエラー情報を提供できる程度に短い時間でなければなりません。 | 30000 |
高度な設定通常は以下の設定を変更する必要はありません。必要ならば、Apache DBCP ドキュメントをご覧ください。 | ||||
| プールステートメント |
| データベース接続プールにおいてプリペアドステートメントのプーリングを有効にします。 | false の既定値を変更しないでください。詳細は、JRA-44908 - 課題詳細の取得... ステータス を参照してください。 | false |
| 最大オープンステートメント |
| ステートメントプールから同時に割り当て可能な空きステートメントの最大数。 | 例外の原因となるため、デフォルト値を修正しないでください。 | 0 |
| バリデーションクエリ |
| 接続プールから取り出された接続の検証を行う SQL クエリです。指定する場合、クエリは少なくとも1つの行を返す SQL SELECT 文でなければなりません。 | 詳細については、 コネクション切断の問題を乗り越える方法 を参照してください。 | select 1 (または、 |
| バリデーションクエリのタイムアウト |
| 検証クエリがデータベース接続の破損を検出するまでのシステム待ち時間 (単位は秒)。 | 検証クエリは処理量の小さいものを使用するためこの時間は非常に短い時間で構いません。 上で Validation Query を指定した場合は Validation Query Timeout の値も指定しなければなりません。指定しない場合は '-1' が設定され、データベースの破損が起こっていない場合でも、システムは破損を無期限に待ち続けます。
| 3 (または、 |
| 借りるときにテスト |
| JIRA がデータベース接続プールからデータベース接続を「借りた」ときにそれが正しく機能するか否かをテストします。 そのデータベース接続が破損している場合はプールから削除されます。 | JIRA はデータベース処理のたびに接続を借りるので、この値は常に 'false' にします。
| True ( |
| 返却時にテスト |
| JIRA がデータベース接続プールにデータベース接続を「返した」ときにそれが正しく機能するか否かをテストします。 そのデータベース接続が破損している場合はプールから削除されます。 | JIRA はデータベース処理のたびに借りた接続を返しますので、この値は常に 'false' とします。 | false |
| アイドル状態にテスト |
| データベース接続がアイドル状態のときに正しく機能しているか否かを定期的にテストします。 そのデータベース接続が破損している場合はプールから削除されます。 | MySQL の場合はこれを 'true' にします。 デフォルトでは、MySQL データベースサーバーは、データベース処理終了後にデータベース接続が使用されていなければその接続をクローズします。JIRA はアクティブに動作しない時間が長時間 (例えば一晩) に及ぶことが多いため、MySQL を利用している場合はこのことが問題となります。このバラメーターを 'true' にすることでこの問題を回避することができます。 なお、Test While Idle の指定が必要となるのは、上で説明した Validation Query を指定したときのみです。 | true false |
| 追い出し実行間の時間 |
| アイドルオブジェクトのエビクションスレッド実行間隔 (単位はミリ秒)。ゼロまたは負の値を指定するとアイドルオブジェクトのエビクションスレッドは実行されません。 エビクションスレッドは、アイドル状態にあるデータベース接続数が上で説明した Minimum Idle/Size を超えたときにアイドル状態にあるデータベース接続を削除します。 | MySQL の場合、接続のエビクションとテストを正常に行うためにはこのパラメーターを大きめの正の値に設定します。一般的に妥当な値は300000 (5 分) です。
| 300000 5000 (または、 |
| 追い出し可能な最小限のアイドル時間 |
| アイドルオブジェクトのエビクションを実行する場合に、データベース接続プール内のオブジェクトがアイドルオブジェクトエビクションの対象となるまでのアイドル状態最小時間。 | 60000 4000 (または、 | |
| クローズ漏れの削除 |
| データベース接続のクローズ漏れ状態が次の Removed Abandoned Timeout で指定した時間を超えたときにそれを削除するか否かのフラグ。 システム内でエラーが発生すると JIRA が借りた接続を返さないということが起こる可能性があります。これが頻繁に起こると、プール内のデータベース接続が不足し、結果として JIRA のパフォーマンスの低下や場合によっては完全な動作停止を引き起こす恐れがあります。 | この値は 'true' にします。 これによってクローズ漏れ状態の接続を整理してプール内の接続数を回復し、システムパフォーマンスの低下を防止します。 | true |
| クローズ漏れの削除のタイムアウト |
| データベース接続がクローズ漏れと判定されるまでのアイドル状態継続時間 (単位は秒)。 | 300 | |
これは、MySQL においてのみ行います。MySQL 以外のデータベースで バリデーション クエリ タイムアウト を使用すると、JIRA インスタンスに重大な問題が生じます。
テータベース接続のクローズがうまくいかないという問題が定常的に発生する場合はこのオプションを 'true' にしてみてください。ただし、この方法は、Time Between Eviction Runs の値を小さくしてもデータベース接続のクローズ時の問題発生を防ぐことも軽減することもできない場合の最終手段とするべきです。* 注意:
- JIRA writes elements with their default values (in the right-hand column of the table above) to the
dbconfig.xmlfile after:- JIRA セットアップウィザード を最後まで実行したとき
- データベース接続の設定やチューニングを行うために JIRA 設定ツールの 詳細 タブを使用したとき。なお、この場合は、各エレメントに対応するオプションの一番左のチェックボックスがチェックされていなくても、デフォルト値の書き込みが行われます。
- ただし、値の下に '(
dbconfig.xmlで指定されていない場合)' と表示されている要素は例外です。これらの要素は次のようになります。- Not written to the
dbconfig.xmlfile after running through the JIRA setup wizard. - 次の場合にのみ
dbconfig.xmlファイルへの書き込みが行われます:- このファイルを手作業で書き換えたとき
- JIRA 設定ツールの詳細タブを使用し、エレメントに対応するオプションの一番左のチェックボックスにチェックを入れて、オプションの値を指定したとき
- Not written to the
- 上述の表の一番右の列で、既定値の下に "(
dbconfig.xmlで指定されていない場合)" と表示されている要素では、dbconfig.xmlファイルに要素が存在しない場合でも既定値が適用されます。
接続プールの監視
JIRA では、「データベース監視」ページでデータベース接続の使用状況を確認できます。詳細については、データベース接続の使用状況の監視 をご覧ください。