Understand and learn to configure general settings for Insight in Jira for both server and data center versions. |
Server Configuration
The subsequent sections describe all Insight properties that will work globally for your installation.
一般設定
Click on the cog wheel at the far right corner of your Jira instance and choose Manage apps option.
Click on Insight Configuration on the left panel. You will now get to the General Insight Configuration screen as shown below.
The following table describes all the configuration properties on this page in detail.
名前 | 説明 | Change requires a Jira restart |
|---|---|---|
属性の既定ラベル | The text type attribute to be used as default label for every object type. You can change this on the specific object type configuration too. この設定はこの設定の変更後に作成されるオブジェクト タイプにのみ影響することにご注意ください。 | いいえ |
属性の既定の説明 | The description for the default label attribute. You can change this on the specific object type configuration too. | いいえ |
[オブジェクトを開く] ダイアログ イベント | Determines if the object dialog should open when a user clicks on an object link or when the user hovers with the mouse over an object link. これは、Jira 課題を表示している際に Insight オブジェクト フィールドを表示する場合にも適用されます。 | いいえ |
カスタム フィールドで取得されるオブジェクトの既定数 | これは、Insight がリクエストごとにカスタム フィールドで取得するオブジェクトの数を示します。既定値は 25 に設定されています。 ユーザーがカスタム フィールドのオブジェクトの検索を開始すると、検索条件に一致するオブジェクトがサーバーから非同期でフェッチされます。したがって、既定の制限である 25 で十分なはずであり、この値が推奨されます。 この数を増やすとリクエストごとにより多くのオブジェクトをフェッチする必要があるため、パフォーマンスに影響します。 | いいえ |
Insight の監査ログが有効 | このチェックボックスをオンにすると、すべての Insight オブジェクト イベントが監査ログファイルに記録されます。 | いいえ |
属性値を監査ログに含める | このチェックボックスは、上記の [Insight の監査ログが有効] がオンになっている場合にのみ有効になります。 オンにすると、監査ログにあるオブジェクトのすべての属性値が含まれます。 | いいえ |
Insight インデックスをファイルから復元 | これによって、起動時に Insight インデックスがファイルから確実に復元されます。起動時間が長くなります。 Insight は起動時にファイルの整合性チェックをデータベースに対して実行して、一致しない場合はインデックスを再作成します。 If you uncheck this, you may experience a slower start up time. However, it could remove the risk of a potential corrupted index file which may cause data inconsistency. By default, this is checked. The file is located at {$JIRA_HOME/caches/insight_indexes} E.g, path of the file on MacOS will be {/var/atlassian/application-data/jira/caches/insight_indexes} | いいえ |
キャッシュをシャットダウン時に保存 | This indicates that the Insight index should be persisted to a file on Insight shutdown (e.g, in cases of a plugin upgrade, Jira restart, Insight disable etc). [Insight インデックスをファイルから復元] がオンになっている場合は、このプロパティもオンにすることをお勧めします。 | いいえ |
Insight のキャッシュを制限 | This helps to limit the amount of objects allowed to be stored in Insight. This will subsequently limit the memory footprint by allowing only a limited number of objects to reside in the cache. Insight を使用する既定かつ推奨される方法は、キャッシュ内のオブジェクトを制限しないことです。制限するとパフォーマンスに悪影響を及ぼします。 | はい |
キャッシュに許されるオブジェクトの数 | [Insight のキャッシュを制限] がオンになっている場合にのみ有効になります。 このプロパティは、キャッシュに保存される Insight オブジェクトの数を示します。 推奨される方法は、キャッシュのオブジェクトを制限しないことです。 | はい |
ファイル アップロードの最大サイズ | ファイル、画像、添付ファイルを Insight にアップロードする際の最大サイズ (バイト単位)。 | いいえ |
Insight の並列処理 | This is number of threads that Insight will spawn to perform parallel tasks, e.g, importing data, re-indexing etc. この数値が低い値に設定されている場合は Insight が Jira にかける負担が軽減しますが、パフォーマンス速度は低下します。 | いいえ |
インポート中にデータ ソースを一時ファイル経由で処理 | インポート中のメモリ フットプリントを減らす目的でインポート モジュールを使用する際に、データをディスク上で一時的に保存します。 (This is available from version 5.5.7) | いいえ |
| カスタム ロケールを Insight に使用 | This is used to indicate if the data stored in Insight should be sorted by a locale other than Jira's default one. Fetching of objects may be slower if this option is switched on. Hence, by default, this is disabled to avoid performance issues. | いいえ |
| Insight のロケール | [カスタム ロケールを Insight に使用] がオンになっている場合にのみ有効になります。 この設定で、Insight がデータを並べ替える際に使用する言語が決まります。 | いいえ |
Jira Service Desk - Following properties only apply if you have installed Jira Service Desk on your Jira instance.
名前 | 説明 | |
|---|---|---|
Service Desk ポータルの検索テキスト (単一) | Jira Service Desk ポータル上にある Insight フィールドのプレースホルダー (単一フィールド) | |
Service Desk ポータルの検索テキスト (複数) | Jira Service Desk ポータル上にある Insight フィールドのプレースホルダー (複数フィールド) |
Locate log files
Insight Server logs are located at: JIRA_HOME/log/
Index Insight
Click on Indexing Insight on the left panel. You will be able to configure the indexing options for Insight as shown below.
On startup, Insight will re-index itself.
Insight will first try to read any persisted index from disk. In cases where the index is not found or the index is corrupted, Insight will perform a re-index.
Insight offers the following options for indexing:
Clean re-index
A clean re-index means that all objects will be evicted from the index and objects will be indexed again. This is recommended if you want to have a fresh state of the index. Remember that objects cannot be filtered or found during this time.
再インデックス化
A normal re-index means that all objects will continue to stay in index and Insight will re-index every object until all objects are reindexed. You can filter objects normally during this time.
Persist Insight index to file
You can manually persist the Insight index on your disk. In cases where you have a big Insight environment with a huge number of objects, you can persist the Insight index, before any uninstall / re-install. This ensures that the Insight index is persisted before Jira can perform a kill operation on the Insight app during shutdown.
Test your groovy scripts
Click on Insight Script Console on the left panel and you should see a console as shown below.
Insight provides a quick utility for you to test out your groovy scripts that you want to use in Automation or post functions in Insight.
Synchronize your reports
Click on Insight reports on the left panel. You will see an option to synchronize your reports as shown below.
You can set up a cron schedule which then runs a job to synchronise the data in your reports.
Enable/Disable analytics
Click on Mindville Analytics on the left panel. You can enable/disable data analytics that Mindville creates on your data usage.
Configure data retention period for clustermessage table
This configuration is required for any Insight Data center version starting 8.5.1 and onwards and explicitly for version 6.4.11. |
As suggested by Atlassian - a way to avoid this is to add a service that flushes the table every 12 hours, retaining the data for only 2880 minutes (or exactly 48 hours). This should prevent performance issues resulting from overloading of the clustermessage table.If you import large datasets in Insight for Data Center in a short period of time, the clustermessage table will be filled up with information and can cause performance issues.
To configure the data retention period, execute the following steps. Screenshot is shown below for reference.
- Click the cogwheel at far right to view the Jira Administration options and select System.
- Scroll down to the Advanced section and select Services.
- [サービスを追加] の [クラス] で [Build-in services (組み込みサービス)] を選択します。
- Click on Cluster messaging flush service.
- 以下の情報を入力します：
- 名前 - クラスター メッセージ フラッシュ サービス
- クラス - com.atlassian.jira.service.services.cluster.ClusterMessageCleaningService
- スケジュール - 0 0 4/12 * * ?
- Click Add Service.
- Enter the following for Retention Period - 2880m
- [更新] をクリックします。
You need Jira administrator permissions to complete this task. |