製品内診断のための新しいデータベース接続メトリクス

In-product diagnostics (IPD) provides greater insights for Atlassian customers and Support into how running instances are operating.

IPD provides additional metrics handling Jira’s interactions with its database. Using database connectivity metrics, you’ll efficiently identify what in your environment or infrastructure might cause the performance issues. Early discovery of a problem guarantees that it can be fixed before its consequences have a bigger impact on instance operation.

The feature is enabled by default. Live metrics are available to customers in the following formats:

• 新しい JMX MBeans として
• 新しい IPD ログ ファイル（atlassian-jira-ipd-monitoring.log）内の JMX 値のスナップショットの履歴

The log file is available in the {jira_home}\log folder where you can find all the existing log files. The log file is also included in the Support Zip file, created in the ATST plugin. If needed, you can generate the Support Zip file in the Atlassian troubleshooting & support tools plugin and send the file to Atlassian Support, where we have internal tools to interpret it. Learn more about the plugin

コミュニケーション

この機能では通信に次の方法が使用されます。

• JMX: JMX MBean は内部スケジュールに基づいて定期的に更新されます。
• The log file atlassian-jira-ipd-monitoring.log: JMX values are snapshotted and recorded to the log file on a configurable schedule. By default, the JMX values are polled and written to the log file every 60 seconds. (This parameter is up to date since the EAP 02.) This polling interval can be changed by using the system property jira.diagnostics.ipdlog.poll.seconds.

データベース接続メトリック

IPD によって提供されるメトリックとその説明については、次の表を参照してください。

IPD を無効にする

The IPD is enabled by default since the EAP 02. To disable it:

1. <JIRA_URL>/secure/admin/SiteDarkFeatures!default.jspa に移動します。ここで <JIRA_URL> は Jira インスタンスのベース URL です。
2. In the Enable dark feature text area, enter com.atlassian.jira.in.product.diagnostics.disabled. Select Add. Learn how to manage dark features
   1. To re-enable the IPD, in the Site Wide Dark Features panel, find com.atlassian.jira.in.product.diagnostics.disabled and select Disable.

ログ形式

Writing to atlassian-jira-ipd-monitoring.log is done via log4j. Its configuration is managed in log4j.properties.

#####################################################
# In-product diagnostics monitoring logging
#####################################################

log4j.appender.ipd=com.atlassian.jira.logging.JiraHomeAppender
log4j.appender.ipd.File=atlassian-jira-ipd-monitoring.log
log4j.appender.ipd.MaxFileSize=20480KB
log4j.appender.ipd.MaxBackupIndex=5
log4j.appender.ipd.layout=com.atlassian.logging.log4j.NewLineIndentingFilteringPatternLayout
log4j.appender.ipd.layout.ConversionPattern=%d %m%n

log4j.logger.ipd-monitoring = INFO, filelog
log4j.additivity.ipd-monitoring = false
log4j.logger.ipd-monitoring-data-logger = INFO, ipd
log4j.additivity.ipd-monitoring-data-logger = false

By default, a concise set of data is included in each log entry. An extended set of data can be logged by enabling the com.atlassian.jira.in.product.diagnostics.extended.logging feature flag.

拡張データを有効にするには、次の手順に従います。

1. Go to <JIRA_URL>/secure/admin/SiteDarkFeatures!default.jspa, where <JIRA_URL> is the base URL of your Jira instance.
2. In the Enable dark feature text area, enter com.atlassian.jira.in.product.diagnostics.extended.logging.enabled. Select Add. Learn how to manage dark features
   1. To disable the extended data, in the Site Wide Dark Features panel, find com.atlassian.jira.in.product.diagnostics.extended.logging.enabled and select Disable.