Jira 9.5 への準備

This documentation is intended for Jira developers who want to ensure that their existing apps are compatible with Jira 9.5 

Summary of the changes

In this section we'll provide an overview of the changes we intend to make, so you can start thinking how it might impact your apps. Once they're ready, we'll indicate when a change has been implemented, and in which milestone.

Jira が Log4j2.x に移行 

In order to take the extra step to ensure continued compliance, we’ve upgraded Log4j to version 2.17.2.

これは大幅な変更であるため、既存のカスタムの Log4j 1.x 環境とこの Jira リリースとの互換性を確認するために追加の作業が必要になる可能性があります。

• If you’re an app vendor and your app uses a custom Log4j 1.x configuration, you’ll need to update your code. For more information on what this means for you, see Log4j upgrade details for third-party app vendors.
• If you’re an admin using a custom Log4j 1.x configuration with your Jira instance, you’ll need to adjust the new log4j2.xml file to include those customizations. For more information about configuring Log4j 2, see Migrating from Log4j 1.x to 2.x and Configuring Log4j 2 in the official documentation.

If you want to test your app with the latest Jira EAP release, check out the download links at the top of this page.

監査ログの改善 

We’ve updated the Audit log feature for a faster loading experience.

The issue was that the Audit log page in Jira loaded slowly for a site and project admin if the database contained more than a few million events. This mostly affected the PostgresSQL and MySQL (including MariaDB) database types.

小型化した新たなデータベース テーブルにカテゴリと要約の増分をキャッシュすることで、パフォーマンスに関する既知の問題点を修正しました。これらのテーブルは、カテゴリや要約フィルターのオプションを提供するために利用されます。これらのテーブルは、設定内の除外イベント セレクタでも利用されます。

機能の仕組み

A background task to create the new tables starts when you upgrade your Jira instance. The tables are also kept up-to-date as new audit events come in. The upgrade will be successful even if the tables build fails so you have zero or minimal downtime

If something goes wrong during the upgrade (for example, the database goes offline when creating or updating the tables), the new tables may be out of sync with the actual audit events stored in the database. To sync the tables with the actual audit events, trigger a manual rebuild of these tables by sending the following REST request:

POST <BASE_URL>/rest/auditing/1.0/cache/rebuild

headers:
  Content-Type: 'application/json' # prevents an XSRF check
  Authorization: Basic <system admin user> <system admin password>

This request should schedule a rebuild of these tables that should take no longer than 15 minutes.

その他の改善

Here’s what else the Audit log update provides:

• 要約フィルターの幅が広がり、読みやすくなりました。
• The inconsistent translation of controls on the Audit log page has been fixed. Audit events, affected objects, categories, and summaries continue to be based on the system locale at the time.
• The issue with the Audit log page loading has been fixed. The page couldn’t load if a CDN that forced JavaScript deferring was used.

Jira の監査の詳細を確認

製品内診断の更新: 新しいユーザー インターフェイス、REST API、およびパフォーマンス メトリック

We’ve made a bunch of updates and improvements to the In-product diagnostics (IPD) tool to help you monitor and maintain your instance performance. Check out more details about:

• a user interface update
• a REST API update
• new HTTP connection and mail queue metrics

User interface update

You can now manage the IPD monitoring manually in the user interface. By default, the feature is enabled.

To manage the IPD monitoring, go to Administration > System > System Support > Monitoring. You’ll see the new In-product diagnostics monitoring toggle.

When switching between the related monitoring enablement toggles, you’ll also see new confirmation dialogs, notifying you about your action and the consequent system behavior.

New REST API endpoint /rest/api/2/monitoring/ipd

We’ve added a new REST API endpoint for managing the IPD monitoring, specifically the In-product diagnostics monitoring toggle in the user interface: /rest/api/2/monitoring/ipd.

{
  "enabled": true
}

{
  "enabled": false
}

New IPD metrics for HTTP connection and mail queue

We’ve added new metrics for instance diagnostics to the In-product diagnostics tool: HTTP connection metrics and mail queue metrics. The metrics are available through JMX and the log file atlassian-jira-ipd-monitoring.log.

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.

Java 17 のサポートを追加

Jira のパフォーマンスを向上してインスタンスの安定性を強化する、Java 17 のサポートを追加しました。

Make sure your Jira apps are updated to work on Java 17 and feel free to set up a new environment for Jira deployment.

Because of the added support for Java 17, you might get errors when installing Jira 9.5. Here's how to prevent this

The H2 database upgraded from 1.4.200 to 2.1.214

組み込みのデータベース H2 を、バージョン 1.4.200 からバージョン 2.1.214 にアップグレードしました。アップグレードでは、多数の脆弱性の問題が修正されています。

Make sure you’ve migrated your data to version 2.1.214 manually.

スムーズなアップグレードのためにデータを移行する方法を確認

Jira Temporary Directory Cleaner の追加

We’re introducing Jira Temporary Directory Cleaner to solve the issue of instances running out of space. With the help of the feature, during startup, Jira will automatically clean its temporary directory defined by the java.io.tmpdir property.

クリーナーはデフォルトで無効化されています。有効化するには tmpdir.clean.on.startup プロパティを true に設定します。これは、setenv.sh スクリプトに次の新しい引数を追加することで行なえます。
-Dtmpdir.clean.on.startup=true

安全上の理由のため、Jira は、一時ディレクトリが次のいずれかのサブディレクトリである場合にのみ、対象のディレクトリからのファイルの削除を試みます。

• Jira ホーム
• Catalina Base (catalina.base プロパティで定義)
• Catalina Home (catalina.home プロパティで定義)

Improved email filtering DATA CENTER ONLY

Jira admins now have more control over how email requests that your customers send are filtered by Jira Service Management.

最初の変更として、管理者は要件に応じ、自動生成メールや一括メールのフィルターを有効化または無効化できるようになりました。新しい設定は、[管理] > [アプリケーション] > [メール リクエスト] で利用できます。

We’ve also added a global allowlist and blocklist for all of your service projects. The lists let you decide which requests should always be processed and help you get rid of spam.

Use the allowlist to make sure that all emails sent from a specific domain are always processed by Jira Service Management, regardless of your filter settings. When you add a domain to your allowlist, any messages that originate from that domain will always reach your queue—either as new requests or as comments in existing ones. To manage your allowlist, go to Administration > Applications > Email requests > Allowlist.

If you get emails that are unwanted and end up cluttering your queue, the blocklist is the answer to your woes. Add email addresses or domains to your blocklist and stop worrying about spam in your queue. To manage your blocklist, go to Administration > Applications > Email requests > Blocklist.

Last but not least, you can now view all email channels that are used in your service projects in one convenient location. Go to Administration > Applications > Email requests > Email channels.

メールでのリクエスト受信の詳細を確認

Auditing improvements for the customer portal and Assets DATA CENTER ONLY

As part of our ongoing efforts to increase audit log coverage across Jira Service Management, we’ve added new logs for several events in Assets and in the customer portal. You’ll now be able to track when Assets object types, objects, and attributes were created, edited or deleted, as well as see logs related to custom field updates. Audit logs will also include information on changes to the customer portal permissions and the customer portal itself (including name, logo and announcement updates). See the full list of new audit logs in the following table.

User experience improvements in the customer portal

We’re continuously enhancing the user experience of Jira Service Management to make it easier and faster to use for you and your customers. In 5.5 we tackled the Description field in the customer portal. In some cases, this field took a few seconds to load which meant that customers had to wait before they could start typing their request. We’ve made a few changes under the hood, and customers are now able to start entering text right after they select the request type.

Supported platforms and end-of-support announcements

• Removed support for the mobile browser Android 4.0
• Added support for the embedded database H2 version 2
• Java 17 サポートの追加

詳細