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 自動化モニタリング

以下は Jira 自動化リクエストのアラートです。

Jira 自動化モニタリングは Jira 10.2 以降で使用できます。

アラートの種類

説明

既定のしきい値

設定オプション

アラート タイプ

取得されるデータ

AutomationQueue のエントリが多すぎるしきい値を超える多数のエントリが AutomationQueue に含まれている場合に発生します。エントリ 10 000 個
jira.diagnostics.thresholds.max-automation-queue-size
  • AutomationQueue のエントリ数のしきい値

  • 既定: 10 000

警告
  • タイムスタンプ

  • AutomationQueue のサイズ

構成

特定の構成

表に記載されている場合をのぞき、上記のアラートはそれぞれ <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
AutomationQueuecom.atlassian.diagnostics.automationqueue.monitor

最終更新日 2019 年 8 月 26 日

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

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