Jira インスタンスが増えるにつれて、推奨制限を超過することで、パフォーマンスが低下したり、予期しないエラーが発生したり、不安定になったりする可能性があります。セーフガードは、以下の制限を設けることで、システムの安定性と良好なパフォーマンスを維持するのに役立ちます。

• 課題ごとのコメント

• 課題

• 課題タイプ

• プロジェクト

• カスタム フィールド

On this page:

• セーフガード
• セーフガード通知のスケジュール
• セーフガードの制限

セーフガードが有効になっている場合、Jira では、設定されたしきい値に達すると、そのカテゴリでの新しいアイテムの作成が防がれます。各セーフガードには、防止が適用されるタイミングに関して特定の条件があり、インスタンスに影響が及ぶ前に問題を回避するのに役立ちます。

セーフガード

課題ごとのコメント

[課題ごとのコメント] では、1 つの課題に含まれるすべてのコメントがカウントされ、指定された制限を超えるコメントがある課題が識別されてカウントされます。データベースで最もコメントが多い課題を調べる方法については、こちらをご確認ください。

既定では、インスタンス最適化アプリによって、各課題のコメントは 1,000 件に制限されます。課題に 1,000 件を超えるコメントがあると、課題ビューの読み込みが遅くなり、メモリ不足エラーが発生し、インデックスの再作成に時間がかかることがあります。極端なケースでは、Jira がクラッシュする可能性があります。

セーフガードを有効化すると、制限に達した後のユーザーによるコメントの追加を防ぐことができます。ただし、課題をインポートまたは復元する場合はこの限りではありません。コメントの作成をブロックするには、[詳細設定] で jira.safeguards.config.restricted.groups を設定する必要もあります。それ以外の場合、制限に近づいたり超えたりした場合にのみ、Jira によってメール通知が送信されます。

以下を推奨します。

• REST API または ScriptRunner によって古いコメントを削除します。ScriptRunner について詳しくは、こちらをご確認ください。

• 自動化をチェックして、不要なコメントを追加していないことを確認します。頻度を減らすか、更新のバッチ処理をご検討ください。

• レート制限を実装して、誤設定された統合により短時間に数千件ものコメントが追加されるのを防止します。レート制限について詳しくは、こちらをご確認ください。

課題ごとのコメントの更新頻度

既定では、課題ごとのコメント セーフガードの統計は 30 分ごとに更新されます。つまり、コメント制限を超える課題の数は、最大で 30 分前の情報である可能性があります。

更新頻度を調整するには、次のアプリ プロパティ (分単位) を設定してから Jira を再起動します: jira.optimizer.plugin.statistics.update.interval.mins この設定は cron 式ではなく決まった分数を使用するため、ランダムまたは不規則に実行するように設定できません。

間隔は既定の 30 分以上にすることをお勧めします。間隔を短くすることもできますが、システム パフォーマンスに影響する可能性があります。

課題合計

[課題合計] では、インスタンス内のすべての課題がカウントされます。既定では、インスタンス最適化アプリによって、インスタンスの課題は 18,000,000 個に制限されます。セーフガードを有効化すると、制限に達した後のユーザーによる課題の追加を防ぐことができます。ただし、バックアップから Jira を復元する場合はこの限りではありません。

 

Jira のビューに多数の課題が表示されて乱雑になり、不要になった古い課題をインスタンスからアーカイブしたい場合があります。課題のアーカイブについて詳しくは、こちらをご確認ください。

アーカイブの対象となる課題を特定する実用的な方法は、長期間更新されていない課題に注目することです。例えば、2 年間何のアクティビティも実行されていない課題は、アーカイブの対象となることが強く示唆されます。また、完了済みの課題や解決した課題、または解決期限が過ぎた課題をアーカイブすることもお勧めします。

また、課題のアーカイブを自動化することもおすすめします。最初のステップは、課題の最適な保持期間を特定することです。それを決定したら、自動化に役立つ以下のリソースを活用してください。

• 大量の課題を簡単にアーカイブする方法

• REST API を使用して課題をアーカイブする

課題タイプの総数

[課題タイプの総数] では、インスタンス内のすべての課題タイプがカウントされます。既定では、インスタンス最適化アプリによって、インスタンスの課題タイプは 250 個に制限されます。セーフガードを有効化すると、制限に達した後のユーザーによる課題タイプの追加を防ぐことができます。ただし、課題タイプをインポートまたはを復元する場合はこの限りではありません。

 

使用しなくなった課題タイプは削除することをおすすめします。Jira 課題タイプの削除は、そのタイプの既存の課題をすべて別のアクティブな課題タイプに移行した後にのみ行ってください。このステップが必要なのは、特にまだアクティブなプロジェクト内で、その課題タイプを使用している課題がまだ残っている場合に、Jira がその課題タイプを削除できないようにするためです。課題タイプを削除する方法を見る

REST API を使用して、すべての課題タイプのリストを取得したり、指定した課題タイプを削除して関連する課題を移行したりすることもできます。課題タイプの REST API の詳細を見る

プロジェクトの総数

[プロジェクトの総数] では、インスタンス内のすべてのプロジェクトがカウントされます。既定では、インスタンス最適化アプリによって、インスタンスのプロジェクトは 7,000 個に制限されます。セーフガードを有効化すると、制限に達した後のユーザーによる新しいプロジェクトの作成を防ぐことができます。ただし、バックアップから Jira を復元する場合はこの限りではありません。

 

アクティブに使用されなくなったプロジェクトはアーカイブすることをおすすめします。たとえば、課題の最終更新が 2 年以上前のプロジェクトが見つかった場合、そのプロジェクトは今後も非アクティブなままである可能性があります。プロジェクトのアーカイブ方法を確認する

プロジェクトをアーカイブすると、そのプロジェクトは制限され、プロジェクトとその課題の両方がピッカーや検索に表示されなくなります。すべての課題が読み取り専用になり、直接リンクがないとアクセスできなくなります。

また、プロジェクトのアーカイブを自動化することもおすすめします。

• プロジェクトを自動的にアーカイブまたは削除するスクリプトを作成する。プロジェクトのアーカイブの REST API の詳細を見る

• ScriptRunner アプリを使用してアーカイブ タスクを自動化する。ScriptRunner の詳細を見る

カスタム フィールドの総数

カスタム フィールドの総数では、インスタンス内のすべてのカスタム フィールドがカウントされます。既定では、インスタンス最適化アプリによって、インスタンスのカスタム フィールドは 1,200 個に制限されます。セーフガードを有効化すると、制限に達した後のユーザーによる新しいカスタム フィールドの作成を防ぐことができます。ただし、バックアップから Jira を復元する場合はこの限りではありません。

カスタム フィールドの設定を見直すことで Jira を高速化できます。カスタム フィールドの最適化機能を使用して、カスタム フィールドを自動的に識別して最適化することをおすすめします。カスタム フィールドを最適化する

 

セーフガード通知のスケジュール

Jira パフォーマンスの要約メール

パフォーマンスの要約メールは、いずれかのセーフガードがセーフガードの制限に近づいている場合に (10% 以内)、指定されたスケジュールで送信されます。

アプリケーション プロパティ ファイルに cron 式を設定することで、Jira がこのようなメールを送信する頻度を制御できます。スケジュールは cron 式 minute hour day_of_month month day_of_week を使用しており、各値はスペースで区切られています。

cron 式を使用すると、セーフガード メールの要約をいつ送信するかを正確に指定できます。たとえば、既定値 0 0 8 ? * MON では、毎週月曜日の午前 8:00 にメールを送信するようにスケジュールされます。

スケジュールをアップデートするには、Jira ホーム ディレクトリのアプリケーション プロパティ ファイルにプロパティ jira.optimizer.plugin.safeguards.email.notification.cron を設定し、Jira を再起動します。すべてのシステム管理者は、同じ間隔でセーフガードのメール通知を受け取ります。

cron 式の作成についての詳細

課題ごとのコメント メール

特定の課題について、[課題ごとのコメント] のセーフガードの制限に近づいた場合、到達した場合、または超過した場合、Jira はイベント駆動型のメール通知を送信します。この通知は Jira パフォーマンス要約メールとは別のものです。

アプリ内メールと個人用メール

[Disable all safeguard system notifications and email summaries (すべてのセーフガードのシステム通知とメール要約を無効にする)] を選択すると、セーフガードのアプリ内通知とメール通知を個別にオプトアウトできます。この設定は Jira パフォーマンス要約メールのスケジュールには影響しません。

メール通知に加えて、セーフガードのアプリ内通知は、いずれかのセーフガードがセーフガード制限の 90% のしきい値に近づいたり、超過したりすると、システム管理者に警告します。

セーフガードの制限

Jira の詳細設定のアプリケーション プロパティを使用して、セーフガードの制限と適用を構成できます。詳細設定の詳細を見る