Alibaba Cloud Elasticsearch クラスターのエラー、原因、および解決策 - Elasticsearch

このページでは、Alibaba Cloud Elasticsearch の使用時にクラスターログ、クライアントログ、またはコマンド出力で発生する可能性のある一般的なエラーについて説明します。

ジャンプ先： 413 Request Entity Too Large · forbids automatic creation of the index · all shards failed · SSL/TLS エラー · No keyword/multi-field defined · path is not accessible on master node · kibana did not load properly · unsupported_operation_exception · NoNodeAvailableException · Unclosed object / ArrayIndexOutOfBoundsException · No field found for metaData · API keys not enabled

413 Request Entity Too Large

1 回の一括書き込みリクエストが http.max_content_length の制限を超えています。この制限のデフォルト値は 100 MB です。この制限は変更しないでください。

リクエストごとに書き込まれるデータ量は、ドキュメント数に平均ドキュメントサイズを乗じたものに相当します。ドキュメントサイズは変動するため、リクエストあたり 5 MB からチューニングを開始し、最大 15 MB まで調整してください。詳細については、「Using and Sizing Bulk Requests」および「HTTP settings」をご参照ください。

"forbids automatic creation of the index"

クラスターで自動インデックス作成が無効になっています。Elasticsearch コンソールで有効にしてください：

静的メソッド (推奨): [YML ファイル設定] パネルで自動インデックス作成を有効にします。手順については、「YML ファイルを設定する」をご参照ください。
動的メソッド： 対応する API コマンドを実行して、クラスターを再起動せずに自動インデックス作成を有効にします。

"all shards failed"

このエラーは、クラスターが 1 つ以上のシャードからのクエリを処理できない場合に表示されます。一般的な原因には、ノードの切断、再起動後にシャードが回復中であること、またはディスクの破損が含まれます。

ステップ 1：診断

クラスターの監視データとログを確認して、根本原因を特定します。たとえば、ディスク容量の不足や、シャードの割り当てを妨げるインデックスまたはクラスター設定の誤りなどが考えられます。

ステップ 2：未割り当てシャードの修正

ノードの切断または未割り当てシャードが原因である場合は、以下の手順に従います：

Kibana コンソールにログインします。
シャードの割り当て状況を確認します：

すべてのシャードがすでに割り当てられている場合、このコマンドはエラーを返しますが、これは想定される動作です。
```
GET /_cluster/allocation/explain
```
失敗したシャードの割り当てを再試行します：
```
POST /_cluster/reroute?retry_failed=true
```

クラスターログ内の SSL/TLS エラー

SSL 接続を介して平文のトラフィックが送信されると、クラスターログに以下のような SSL/TLS エラーが表示されます。これは通常、暗号化通信を使用しないノードが、暗号化が有効になっているノードに接続しようとした場合に発生します。

content :
[o.e.t.TcpTransport ] [XBJo5pR] exception caught on transport layer [Netty4TcpChannel{localAddress=0.0.0.0/0.0.0.0:9300, remoteAddress=/89.248.xxx}], closing connection
io.netty.handler.codec.DecoderException: io.netty.handler.ssl.NotSslRecordException: not an SSL/TLS record: 0300002f2axxxx8
61736xxx a0100080003000000

以下を確認してください：

HTTP と HTTPS の不一致： クラスターで HTTPS が有効になっていない場合、アクセスは HTTP 経由でのみ可能です。HTTPS 経由でクラスターにアクセスすると、このエラーが発生します。HTTPS を有効にするには、「HTTPS の有効化」をご参照ください。
IP アドレスがホワイトリストに未登録： クラスターログに表示される IP アドレスがパブリック IP アドレスホワイトリストに含まれていることを確認してください。必要な特定の IP アドレスまたは CIDR ブロックのみを追加し、0.0.0.0/0 は追加しないでください。

その他の SSL/TLS エラーパターンについては、「一般的な SSL/TLS 例外」をご参照ください。

"No keyword/multi-field defined exact matches for [KeywordField]"

このエラーは、X-Pack SQL プラグインのクエリで、text 型のフィールドに対して LIKE 演算子を使用した場合に発生します。LIKE 演算子は keyword 型のフィールドでの完全一致フィルタリングのみをサポートします。クエリを変更して、代わりに keyword フィールドを使用してください。

背景情報については、「Unable to run SQL query on multi fields using Elastic Search v. 7.3」および「SQL and multi-fields」をご参照ください。

"path is not accessible on master node"

このエラーは、ターゲットの Object Storage Service (OSS) バケットがアーカイブストレージクラスを使用している場合に PUT _snapshot/my_backup を実行すると発生します。アーカイブバケットでは、データを読み取る前にオブジェクトを復元する必要があり、これは Elasticsearch のスナップショット操作と互換性がありません。

Elasticsearch クラスターと同じリージョンにある標準ストレージクラスの OSS バケットを使用してください。手順については、「手動スナップショットの作成と手動スナップショットからのデータ復元」をご参照ください。

"kibana did not load properly"

データノードのディスク使用率が 95% を超えると、Elasticsearch は書き込み保護を作動させ、すべてのインデックスに read_only_allow_delete を設定します。書き込みはブロックされ、読み取りと削除のみが許可されます。

ステップ 1：ディスク使用率の高さの解決 (根本原因)

まず、根本原因であるディスク使用率の問題に対処します。ディスク容量の拡張、未使用インデックスの削除、インデックスライフサイクル管理の設定などのオプションについては、「ディスク使用率の高さと読み取り専用インデックス」をご参照ください。

ステップ 2：書き込みアクセスの復元

ディスク使用率の問題を解決した後、すべてのインデックスにまたがる読み取り専用フラグをリセットします：

PUT _settings
{
   "index.blocks.read_only_allow_delete": null
}

"unsupported_operation_exception" (aliyun-qos プラグイン)

apack.qos.ratelimit.enabled でスロットリングを有効にした後、リミッターを設定するとこのエラーが表示されます：

{
   "error": {
      "root_cause": [
         {
            "type": "unsupported_operation_exception",
            "reason": "unsupported_operation_exception: only define search or bulk action for limit"
         }
      ],
      "type": "unsupported_operation_exception",
      "reason": "unsupported_operation_exception: only define search or bulk action for limit"
   },
   "status": 500
}

aliyun-qos プラグインが最新バージョンではありません。GET /_cat/plugins?v を実行して現在のバージョンを確認してください。期待される最新バージョンは次のとおりです：

Elasticsearch V7.10： 7.10.0_ali1.6.0.2
その他すべてのバージョン： <ES version>-rc4

クラスターのバージョンに基づいてアップグレードします：

V7.10 クラスター： カーネルを V1.6.0 にアップグレードします。詳細については、「クラスターのバージョンアップグレード」をご参照ください。
その他のバージョン： チケットを送信して、Elasticsearch の技術エンジニアにプラグインのアップグレードを依頼してください。アップグレード後、クラスターを再起動して変更を有効にします。

重要

rc4 より前のバージョンのプラグインは、このエラーを引き起こします。
aliyun-qos プラグインは、V6.7.0 以降を実行しているクラスターでアップグレードできます。それ以前のバージョンを実行しているクラスターの場合は、まずクラスターを V6.7.0 以降にアップグレードしてください。

"NoNodeAvailableException" (Transport Client、ポート 9300)

Transport Client 5.5 または 5.6 を使用してポート 9300 経由で接続すると、次のようなエラーが表示されることがあります：

NoNodeAvailableException[None of the configured nodes are available: [{#transport#-1}{HVdK7Cff****_P0c9n****}{es-cn-v1qqweee****.elasticsearch.aliyuncs.com}{172.17.XX.XX:9300}]]

172.17.XX.XX IP アドレスはクラスター内の実際のノードではありません。これは、これらのクライアントバージョンで確認されている既知の問題です。代わりに Transport Client 5.3.3 を使用してください。詳細については、「Transport Client (5.x)」をご参照ください。

"Unclosed object or array found" / "ArrayIndexOutOfBoundsException" (V7.4)

これらのエラーは、オープンソースの Elasticsearch 7.4 のバグが原因であり、業務には影響しません。このバグは 7.4 より後のバージョンで修正されています。

Alibaba Cloud Elasticsearch V7.4 は提供を終了しました。より新しいバージョンを実行しているクラスターをご購入ください。切り替え前にデータを移行する必要がある場合は、「データ移行ソリューションの選択」を参照して、ワークロードに適したアプローチを選択してください。

"No field found for [metaData] in mapping with types" (aliyun-knn)

このエラーは、コサイン距離測定関数で設定されたインデックスで、ベクトル検索に aliyun-knn プラグインを使用した場合に表示されます。以下を確認してください：

クラスターバージョン： aliyun-knn プラグインには、カーネル V1.2 以降を搭載した Elasticsearch V6.7、またはカーネル V1.4 以降を搭載した Elasticsearch V7.10 が必要です。バージョンの要件については、「aliyun-knn プラグインの使用」をご参照ください。
スクリプトクエリメソッド： スクリプトクエリでは script_score パラメーターを使用する必要があります。
フィールドのネスト： クエリで指定されたフィールドが、インデックスマッピングのネスト構造と一致していることを確認してください。インデックスがネストされたフィールドを使用している場合、クエリもそれに応じてネストされたフィールドを参照する必要があります。

"API keys not enabled in Elasticsearch"

クラスターで API キー認証が有効になっていません。API キーを使用するには、クラスターで HTTPS が有効になっている必要があります。この問題を解決するには、HTTPS を有効にしてください。詳細については、「HTTPS の有効化」をご参照ください。