Jira Data Center の監視

Jira Data Center インスタンスのパフォーマンスを監視できるよう、多数のモニターを導入しました。これらを使用してボトルネックを分析し、確認が必要なイベントが発生した場合にアラートを受け取ることができます。 

アラートは、<JIRA_URL>/plugins/servlet/diagnostics/overview. に移動して、App Diagnostics フレームワークで入手できます。

JQL モニター

Jira は低速または複雑な JQL クエリのアラートをすでに提供していますが、Jira 8.4 では大量のカスタム フィールドを持つクエリのアラートを追加しました。以下のアラートのしきい値は、JQL クエリが実行されるたびにチェックされます。低速な JQL クエリが検出されると、以下のいずれかのアラートがトリガーされます。

Jira Data Center バージョン 8.4 以降では次のモニターを使用できます。

アラートの種類

説明

設定オプション

アラート タイプ

取得されるデータ

Slow JQL queryJQL クエリの実行が低速な場合に発生するデフォルトのアラート
jira.diagnostics.thresholds.slow-query-millis
  • 低速 JQL クエリ アラートに定義されたしきい値 (ミリ秒単位)

  • 既定 5000

情報
  • スレッド ダンプ

  • フィールドあたりの句の数

  • クエリ内の句の数

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

  • 結果の数 (numberOfResults=-1  は数を特定できなかったことを意味します)

  • 実行時間 (ミリ秒)

Complex JQL query複雑な JQL クエリが実行されたときに発生
jira.diagnostics.thresholds.query-complexity
  • Lucene クエリ句の数で定義された、クエリ複雑度アラートのしきい値。

  • 既定 10000

情報
  • スレッド ダンプ

  • フィールドあたりの句の数

  • クエリ内の句の数

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

  • 結果の数 (numberOfResults=-1  は数を特定できなかったことを意味します)

  • 実行時間 (ミリ秒)

Large number of requestJQL クエリが多数の結果を生成する場合に発生
jira.diagnostics.thresholds.number-of-results
  • JQL クエリから返される課題数の JQL アラートのしきい値

  • 既定 1000


情報
  • スレッド ダンプ

  • フィールドあたりの句の数

  • クエリ内の句の数

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

  • 結果の数 (numberOfResults=-1  は数を特定できなかったことを意味します)

  • 実行時間 (ミリ秒)

Large number of custom fieldsJQL クエリに多数のカスタム フィールドが含まれている場合に発生
jira.diagnostics.thresholds.query-custom-fields
  • JQL クエリで使用されるカスタム フィールド数のしきい値

  • 既定 1000

情報
  • スレッド ダンプ

  • フィールドあたりの句の数

  • クエリ内の句の数

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

  • 結果の数 (numberOfResults=-1  は数を特定できなかったことを意味します)

  • 実行時間 (ミリ秒)

Data Center 固有のモニター: データベース、スケジューラ、REST リソース、サーブレット 

Jira 8.4 では以下のモニターが導入され、Jira Data Center 8.4 以降で利用可能です。


データベースの監視

低速なデータベース クエリ、高いプール使用率、およびクローズ漏れ接続のアラートを次に示します。

アラートの種類

説明

既定のしきい値

設定オプション

アラート タイプ

取得されるデータ

Connection leakプールでデータベース コネクションがリークした場合に発生します。300秒tomcat pool-remove-abandoned-timeout オプションで設定できます。警告
  • アクティブ コネクション数

  • アイドル コネクション数

  • 最大プール サイズ

High connection pool utilization alert

データベース コネクション プールが指定された時間内に制限値まで使用された場合に発生します。


デフォルトのポーリング間隔は 5 秒です
15 分間の使用率 90 %
jira.diagnostics.threshold.database-pool-utilization
  • データベース プールの使用率についてのアラートを発生させるしきい値 (パーセンテージ)。

  • 既定 80

jira.diagnostics.threshold.database-pool-utilization-time-window
  • データベース プールの使用率を追跡するための期間 (分単位)

  • 既定 15 分

jira.diagnostics.settings.database-pool-poller-interval
  • データベース プールのポーラー間隔 (秒)

  • 既定 5

情報
  • アクティブ コネクション数

  • アイドル コネクション数

  • 最大プール サイズ

Slow operation alertSQL オペレーションの実行速度が低速な場合に発生します。オプションとして実行中の SQL ステートメントもキャプチャできますが、これは構成可能で、デフォルトでは無効になっています。SQL がアラートに含まれていない場合、5 秒
jira.diagnostics.settings.include-sql-in-alerts
  • 公開されている可能性がある SQL クエリを診断アラートに含める設定

  • 既定 false

jira.diagnostics.thresholds.slow-query-millis
  • 低速 JQL クエリ アラートに定義されたしきい値 (ミリ秒単位)

  • 既定 5000

情報
  • SQL ステートメント (オプション)

  • 実行時間 (ミリ秒)

  • 関連するプラグイン

  • スレッド名

注: 現在、URL やユーザー名などのデータはキャプチャされません。

スケジューラの監視

高いプール使用率や、ジョブが遅い場合のアラートを次に示します。

アラートの種類

説明

既定のしきい値

設定オプション

アラート タイプ

取得されるデータ

High utilization alert

スケジューラの ワーカー スレッドの使用率が一定期間 100% になると発生します。

デフォルトのポーリング間隔は 5 秒です。

15 分間の使用率 100 % 以上
jira.diagnostics.threshold.scheduler-utilization-time-window
  • スケジューラの高使用率を追跡する期間 (分単位)

  • 既定 15

jira.diagnostics.settings.scheduler-poller-interval
  • スケジューラ診断のポーラー間隔 (秒)

  • 既定 5

情報
  • ワーカー スレッドの数

  • 次を含む、実行中のすべてのジョブの詳細:

    • ジョブ ランナー キー

    • ジョブ ID

    • 実行時間

    • ジョブ ランナー クラス (利用可能な場合)

    • 元のプラグイン名 (利用可能な場合)

Slow job alert

スケジュールされたジョブの実行時間が、設定された実行間隔より長くかかる場合に発生します。

デフォルトのポーリング間隔は 5 秒です。


jira.diagnostics.settings.scheduler-poller-interval
  • スケジューラ診断のポーラー間隔 (秒)

  • 既定 5

情報
  • ジョブ ランナー キー

  • ジョブ ID

  • 実行時間

  • ジョブ ランナー クラス (利用可能な場合)

  • 元のプラグイン名 (利用可能な場合)


REST リソースとサーブレットの監視

実行速度が遅い http リクエストのアラートを次に示します。

アラートの種類

説明

既定のしきい値

設定オプション

アラート タイプ

取得されるデータ

Slow requestHTTP リクエストの応答が遅い場合に発生します。60秒
jira.diagnostics.settings.http-request-max-elapsed-time
  • 長時間実行される HTTP リクエストのしきい値 (秒単位)

  • 既定 60

情報
  • リクエスト パス

  • ユーザ名

  • 実行時間 (ミリ秒)

  • スレッド ID

  • スレッド ステータス

構成

特定の構成

表に記載されている場合をのぞき、上記のアラートはそれぞれ <jira-home> ディレクトリにある jira-config.properties ファイルを通じて構成できます。ファイルの編集の詳細については、「‪jira-config.properties‬ ファイル」を参照してください。 

すべてのアラート

使用可能なアラートごとに説明されている特定の構成とは別に、全般的なアラート構成を変更できます。これにより、変更内容がすべてのアラートに適用されます。これを行うには、jira-config.properties を開き、次のメトリックを編集します。


 - com.atlassian.jira.health.diagnostics.alerts.retention-period-days: 診断アラートを保持する日数 (既定では 30 日)
 - com.atlassian.jira.health.diagnostics.alerts.truncation-interval-days: 切り捨てジョブを実行する日数 (既定では 1 日)

ファイルの編集の詳細については、「‪jira-config.properties‬ ファイル」を参照してください。

デフォルトのしきい値の変更

既定のしきい値を変更するには、jira-config.properties file で次のプロパティを編集する必要があります。

  • jira.diagnostics
  • com.atlassian.jira.health.diagnostics

アラートの有効化と無効化

モニターは既定で有効になっていますが、FeatureFlags で無効または有効にできます。仕組みの詳細については、「ダーク機能」を参照してください。

機能タイプ機能名
すべてのモニターcom.atlassian.diagnostics.monitors
JQLcom.atlassian.diagnostics.jql.monitor
データベースcom.atlassian.diagnostics.database.monitor
スケジューラcom.atlassian.diagnostics.scheduler.monitor
REST リソースとサーブレットcom.atlassian.diagnostics.http.monitor

最終更新日 2019 年 8 月 26 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.