RSS フィードなどの検索ビューから返される課題の数を制限する - アトラシアン製品ドキュメント

お困りですか?

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

コミュニティに質問

JIRA では、Word、Excel、RSS または XML 等のフォーマットで検索結果を表示することができます。

多数の課題を返却する検索ビューは JIRA が処理を完了するまで長い時間と膨大なメモリを使用します。これは JIRA における OutOfMemoryErrors の要因となります。

特に問題があるのは、 RSS フィードで検査結果を表示する場合です。理由は以下に示します。

  • ユーザーの RSS フィードが定期的 (1時間ごとなど) にリクエストを飛ばし続けている
  • RSS リーダーが、ユーザーに直接向けていないリクエストを作成しているため、ユーザーはリクエストに時間がかかる、または失敗していることに気づいていない

You can use the following three properties in jira-config.properties to limit the number of issues returned by a search view.

See Making changes to jira-config.properties for the details of how to make and apply changes to your jira-config.properties file.

jira.search.views.default.max

The jira.search.views.default.max property sets a 'soft' limit on the number of issues returned. It has a default value of 1000. You can set it to 100 (for example), by specifying the following in your jira-config.properties file:

jira.search.views.default.max = 100

For an RSS or XML view, JIRA applies the limit by appending the tempMax parameter to the URL of the search view. For example:

上記の例では、JIRA が返却される課題の数を 200 に制限しています。

However users can override this 'soft' default by removing the tempMax parameter from the URL or by increasing the value of tempMax.

jira.search.views.max.limit

The jira.search.views.max.limit property sets a 'hard' limit on the number of issues returned. It has a default value of 1000. You can set this property's value to 200 (for example), by specifying the following in your jira-config.properties file:

jira.search.views.max.limit = 200

例えば、ユーザーが課題ビューを200件以上返すようにリクエストすると、JIRA は課題を返却せず、代わりに403 (Forbidden) エラーを返却します。ユーザーにとっては不便かもしれませんが、大量のリソース消費やおそらくメモリ不足も防ぐことができます。

Make sure you set the value of jira.search.views.max.limit to greater than or equal to the 'soft' limit set by jira.search.views.default.max. Otherwise all search views that would return issues limited by the default 'soft' limit will instead return a 403 (Forbidden) error.

jira.search.views.max.unlimited.group

You may have a requirement for most users to have the limit imposed on them, but a few users to be exempt from the limit. One example of this is if your JIRA instance is Internet facing. You may want external (Internet) users to have the limit imposed on them, but for internal users to be able to produce unlimited search views. You can use the jira.search.views.max.unlimited.group property to achieve this.

The jira.search.views.max.unlimited.group property is disabled by default, by being either absent from your jira-config.properties file or present but disabled with a preceding '#'. If you enable this property in your jira-config.properties file, you must specify a valid group for its value or leave it empty. For example:

jira.search.views.max.unlimited.group = jira-administrators

Users exempted from the limit via this technique will still have to add the tempMax parameter to the URL for an RSS or XML view, as described above, in order to exceed the jira.search.views.default.max soft limit.

最終更新日 2017 年 9 月 4 日

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

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