Elasticsearchインストールのトラブルシューティング
LiferayとElasticsearchは、多くの設定を伴う複雑なシステムです。 それらを接続すると、途中で困難に遭遇する可能性があります。 以下に、トラブルシューティングのテクニックを紹介します。
よくある問題とその解決方法については、以下をご覧ください。
Liferay にバンドルされているサイドカー Elasticsearch サーバーのトラブルシューティングについては、 サイドカー/組み込み Elasticsearch のトラブルシューティング を参照してください。
検索バーのElasticsearchクエリを検査する
Liferayの検索インフラストラクチャーは、ユーザーが検索バーウィジェットから検索するたびに、大きなElasticsearchのリクエストを生成します。 Elasticsearchに送信されたクエリを検査するには、検索インサイトウィジェットを使用します。 詳細については、 検索インサイトを参照してください。
Liferayが生成したElasticsearchクエリを検査する
Liferay によって生成された Elasticsearch クエリを検査するには、 SearchSearchRequestExecutor および ElasticsearchIndexSearcher のログレベルを設定します。
-
SearchSearchRequestExecutorのログレベルを DEBUG に設定します。 パッケージのパスはバージョンによって異なります。-
Liferay DXP 7.3 から DXP 2025.Q4 まで:
com.liferay.portal.search.elasticsearch7.internal.search.engine.adapter.search.SearchSearchRequestExecutor. -
Liferay 2026.Q1+:
com.liferay.portal.search.elasticsearch8.internal.search.engine.adapter.search.SearchSearchRequestExecutor.
-
-
ElasticsearchIndexSearcherのログレベルを INFO に設定します。 パッケージのパスはバージョンによって異なります。-
Liferay DXP 7.3 から DXP 2025.Q4 まで:
com.liferay.portal.search.elasticsearch7.internal.ElasticsearchIndexSearcher -
Liferay DXP 2026.Q1+:
com.liferay.portal.search.elasticsearch8.internal.ElasticsearchIndexSearcher
-
サーバー管理ログレベルUI を使用してログレベルを設定できます。
Liferay 7.1-7.2 を使用していて、デフォルトでバンドルされている Connector to Elasticsearch 6 を使用している場合は、パッケージ名のバージョン番号を 7 から 6 に変更してください。
冗長SSLロギングを有効にする
暗号化関連の問題をトラブルシューティングするには、冗長SSLロギングを有効にします。
Liferayの場合、アプリケーションサーバーのJVMで -Djavax.net.debug=ssl:handshake:verbose を設定します。 Tomcat では、setenv.shのCATALINA_OPTS にオプションが追加されています。
CATALINA_OPTS="$CATALINA_OPTS -Djavax.net.debug=ssl:handshake:verbose"
Elasticsearch の場合は、 -Djavax.net.debug=ssl:handshake:verbose を [Elasticsearch Home]/config/jvm.options の末尾に追加します。