Monitor your instance with Jira diagnostics plugin

システム管理

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

When investigating a performance problem or outage, it's useful to know as much as possible about what was happening in your site in the lead-up to the problem. This is when diagnostics information can help.  That is why we a produce daily summary on all alerts fired with Atlassian diagnostics framework.

While often not individually actionable, diagnostic alerts can help you build up a detailed picture of your application’s behaviour, and identify symptoms that may be contributing to the problem. 

The plugin is available in Jira version 7.13 and later.

診断アラートについて

The purpose of the diagnostics tool is to continuously check for symptoms or behaviours that we know may contribute to problems in your application. An alert is triggered when a set threshold is exceeded.

プロパティ

既定値

説明

jira.diagnostics.thresholds.slow-query-millis

400ms

Alert for slow JQL query

jira.diagnostics.thresholds.number-of-results

1000

Number of returned issues from a single JQL query

jira.diagnostics.thresholds.query-complexity

1000

Lucene query complexity - number of clauses the query is constructed of

For example, if a query takes more than 0.4 s falls an alert is triggered. This is useful because if users run a lot of queries at the same time, it might overload the system.

しきい値は、アラートがトリガーされるポイントとしてのみ機能する点にご注意ください。タイムアウトや、その他のハード制限とは異なります。例えば、長時間実行されるタスクでは、5 分後にアラートがトリガーされても、8 分後に正常に完了する可能性があります。 

When an alert is triggered a message is written to the atlassian-jira.log file (your application log), and further details provided in the jira-diagnostics.log file.  It's also included in support zips.

Sample alerts

Log entry説明
2020-06-04 03:27:15,009+0000 pool-23-thread-1 INFO ServiceRunner [atlassian-
diagnostics-data-logger] 1591241235004 ; INFO ; DB ; DB-3002 ; High database con
nection pool utilization detected. ; <app-key> ; ; ; {"activeConnections":2
1,"idleConnections":4,"maxConnections":25}

The database connection pool was been highly utilized in the last sampling period.

INFO ServiceRunner [atlassian-
diagnostics-data-logger] 1591241235004 ; INFO ; DB ; DB-3002 ; Slow scheduled job ;
A scheduled job took longer than its configured interval to complete.
INFO ServiceRunner [atlassian-
diagnostics-data-logger] 1591241235004 ; INFO ; DB ; DB-2001 ; Slow event listener detected  ;
An event was successfully dispatched to an event listener, but the event or listener took a long time to process it. For synchronous events, the user request that triggered the event had to wait a long time for the request to complete. For asynchronous events, one of the event processing threads was unavailable to dispatch other events during this time.
INFO ServiceRunner [atlassian-
diagnostics-data-logger] 1591241235004 ; INFO ; DB ; DB-3001 ; Slow HTTP request detected ;
An HTTP request took longer than 60 seconds to complete.

3-rd party apps can also generate custom alerts that are visible in the logs.


Retention and defaults

一部の動作は 1 つのアラートのみをトリガーしますが、複数のアラートをトリガーできるものもあります。診断情報はデータベースに保存され、30 日間保持されます。古いアラートは自動的に削除されます。

Change the property default values

Upping the values will result in fewer alerts to be triggered.

  • The values can be modified either from the $JIRA_HOME/jira-config.properties. For example,

    jira.diagnostics.thresholds.slow-query-millis=5000 
    jira.diagnostics.thresholds.number-of-results=10000 
    
  • They can also be modified using the following JVM parameters:

    -Djira.diagnostics.thresholds.slow-query-millis=5000 
    -Djira.diagnostics.thresholds.number-of-results=10000  
    

Make sure there are no spaces between the equal sign in both methods.

Change the default retention

To change the default retention of 30 days, do the following:

  1. Open jira-config.properties.

  2. Edit the following metric changing the number of retention days:com.atlassian.jira.health.diagnostics.alerts.retention-period-days: <number of days to retain Diagnostics Alerts>

最終更新日 2020 年 6 月 26 日

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

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