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 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.
Alert for slow JQL query
Number of returned issues from a single JQL query
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.
The database connection pool was been highly utilized in the last sampling period.
|A scheduled job took longer than its configured interval to complete.|
|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.|
|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,
They can also be modified using the following JVM parameters:
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:
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>