要約

Insight をアップグレードすると、Insight スキーマにオブジェクトが表示されなくなり、Insight カスタム フィールドで選択するオプションとして表示されなくなり、カーディナリティなどの属性オプションを変更できなくなりました。

InvalidCacheLoadException

Insight のインデックス再作成をトリガーすると、atlassian-jira.log に次のエラーが表示されます。

2021-05-06 14:27:55,871 insight-InsightThreadGroup-worker-thread-6 ERROR admin 863x2041x1 1gmljw3 127.0.0.1 /rest/insight/1.0/index/reindex/start [i.r.i.index.model.ObjectIndexImpl] Index not completed successfully. objectIds: ([1, 2, 3, 4, 5])
com.google.common.cache.CacheLoader$InvalidCacheLoadException: loadAll failed to return a value for 3
    at com.google.common.cache.LocalCache.getAll(LocalCache.java:4025)
    at com.google.common.cache.LocalCache$LocalLoadingCache.getAll(LocalCache.java:4972)
    at io.riada.insight.index.model.InsightIndexBase.loadAll(InsightIndexBase.java:81)
    at io.riada.insight.index.model.ObjectIndexImpl.reindexObjects(ObjectIndexImpl.java:318)
    at com.riadalabs.jira.plugins.insight.services.core.index.ReindexServiceImpl$ReindexObjectsJob.executeTask(ReindexServiceImpl.java:543)
    at com.riadalabs.jira.plugins.insight.services.core.index.ReindexServiceImpl$ReindexObjectsJob.executeTask(ReindexServiceImpl.java:520)
    at com.riadalabs.jira.plugins.insight.services.core.multithreadservice.InsightServiceJob.call(InsightServiceJob.java:42)
    at com.atlassian.sal.core.executor.ThreadLocalDelegateCallable.call(ThreadLocalDelegateCallable.java:38)
    at java.base/java.util.concurrent.FutureTask.run(FutureTask.java:264)
    at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1128)
    at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:628)
    at java.base/java.lang.Thread.run(Thread.java:834)

• 「objectIds」リストには、Insight がその特定の操作でインデックス再作成を試みたすべてのオブジェクト ID が表示されます (顧客の状況ではリストは長くなる可能性があります)。
• 「return a value for」とは、Insight で上記の問題が最初に発生したオブジェクト ID の値のことです。

該当する属性に対してインデックスを作成する必要がある

オブジェクト参照属性の設定を編集しようとすると、次のように表示されます。

環境

この問題は Insight のメジャー バージョン 8.6.x および 8.7.x で検出されました。

原因

ここで説明するどちらのエラーも「ラベル」や「オブジェクト参照」属性など、インデックスを作成する必要があるものの Insight によるインデックス作成の対象としてマークされていない属性に起因しています。

これは UI から実行可能な操作ではないため、この誤設定は、Insight によるアップグレード タスクが不完全であったり、データベースが直接改ざんされたりすることが原因で発生している可能性があります。

診断

この問題を診断するには、Jira ログで上記のエラーを探すか、Jira データベースで次のクエリを実行します。

SELECT "ID", "NAME", "REMOVABLE", "TYPE", "LABEL", "INDEXED" FROM "AO_8542F1_IFJ_OBJ_TYPE_ATTR" WHERE ("REMOVABLE" = 'false' OR "TYPE" = 1) AND ("INDEXED" != 'true' OR "INDEXED" is NULL);

SELECT ID, NAME, REMOVABLE, TYPE, LABEL, INDEXED FROM AO_8542F1_IFJ_OBJ_TYPE_ATTR WHERE (REMOVABLE = false OR TYPE = 1) AND INDEXED != true;

REMOVABLE 列はオブジェクト タイプの 4 つの既定のフィールドを示し、TYPE 1 はオブジェクトを参照する属性に割り当てられたタイプを示します。

行が返された場合は、後述の「解決方法」の手順に進んでください。

行が返されなかった場合は、別の解決方法を参照してください。

• Insight スキーマを削除したり、オブジェクトを検索したりすると、Insight で「問題が発生しました。管理者にご連絡ください」というエラーが表示される

ソリューション

影響を受ける環境でこの問題を解決するためには、Insight UI によって [ラベル] フィールド (または [診断] セクションに記載されている他のフィールド) に対するインデックス作成を有効/無効にできないため、まだインデックスが作成されていないすべての必須フィールドに対して、データベースに直接変更を適用する必要があります。

詳細な手順:

1. Jira データベースにアクセスします。
2. 次のクエリの 1 つを実行して、目的のパスとデータベース タイプに応じて Insight 属性に対するインデックス作成フラグを調整します。
   

   1. 必要な属性に対してのみインデックスを作成するように設定します。

      Postgres の場合:

      UPDATE "AO_8542F1_IFJ_OBJ_TYPE_ATTR" SET "INDEXED" = 'true' WHERE ("REMOVABLE" = 'false' OR "TYPE" = 1) AND ("INDEXED" != 'true' OR "INDEXED" is NULL);

      MySQL

      UPDATE AO_8542F1_IFJ_OBJ_TYPE_ATTR SET INDEXED = true WHERE (REMOVABLE = false OR TYPE = 1) AND INDEXED != true;

   2. "textarea" タイプを除くすべての属性に対してインデックスを作成するように設定します。

      Postgres の場合:

      UPDATE "AO_8542F1_IFJ_OBJ_TYPE_ATTR" SET "INDEXED" = 'true' WHERE "DEFAULT_TYPE_ID" != 9 AND ("INDEXED" != 'true' OR "INDEXED" is NULL);

      MySQL

      UPDATE AO_8542F1_IFJ_OBJ_TYPE_ATTR SET INDEXED = true WHERE DEFAULT_TYPE_ID != 9 AND INDEXED != true;

3. 必要に応じて変更をコミットします。
4. Jira UI で、[Jira 管理] (歯車アイコン) > [アプリの管理] > [Insight のインデックス作成] に移動します。
5. Insight のクリーン インデックス再作成を実行します。
6. DC 環境の場合は、各ノードで Insight インデックス再作成を繰り返します。

ここではダウンタイムは不要です。