すべてのプロダクト
Search
ドキュメントセンター

Elasticsearch:シナリオベースの設定

最終更新日:Jun 17, 2026

シナリオベースの設定テンプレートは、汎用、データ分析、データベースアクセラレーション、検索などの一般的なワークロードに対応するベストプラクティスのクラスター設定とインデックス設定をパッケージ化したものです。一致するテンプレートを選択すると、推奨設定が自動的に適用され、不適切な設定によるクラスターやパフォーマンスの問題を削減します。

シナリオベースの設定テンプレートには、次の 3 種類の設定が含まれます。

  • 動的クラスター設定:クラスターレベルの設定を動的に変更します。これは、PUT /_cluster/settings コマンドの実行に相当します。詳細については、「Cluster update settings」をご参照ください。

  • インデックステンプレート設定:新しいインデックスを作成する際に自動的に適用されるテンプレートを定義します。既存のインデックスには影響しません。これは、PUT _template/aliyun_default_index_template コマンドの実行に相当します。詳細については、「Index templates」をご参照ください。

  • インデックスライフサイクル設定:インデックスのホット、ウォーム、コールド、デリートフェーズ間の移行を自動化します。これは、PUT _ilm/policy/aliyun_default_ilm_policy コマンドの実行に相当します。この機能は、コールドデータノードを持つバージョン 6.7.0 以降のインスタンスでのみ利用可能です。詳細については、「Setting up a new policy」をご参照ください。

適用範囲

この機能は、v2 アーキテクチャのクラスターでのみ利用可能です。クラスターのアーキテクチャを確認するには、次の手順に従ってください。

Alibaba Cloud Elasticsearch コンソールにログインします。インスタンスの 基本情報 ページで、デプロイコントロールモード を確認します。クラウドネイティブの新しいコントロール (v3) または 基本コントロール (v2) と表示されます。

使用上の注意

  • 利用可能なテンプレートは、インスタンスのバージョンとタイプによって異なります。最新のオプションについては、コンソールでご確認ください。Indexing Service が有効になっているインスタンスは、ログシナリオのみをサポートします。

  • シナリオベースのテンプレートの変更は、PUT _template/aliyun_default_index_template コマンドの実行に相当します。この操作は、インスタンスを再起動したり、既存のインデックスやクラスターの状態に影響を与えたりすることはありません。

  • 推奨インデックステンプレートは aliyun_default_index_template という名前で、順序は Integer.MIN_VALUE+1 とカスタムテンプレートよりも低く設定されています。カスタムテンプレートが常に優先されるように、この順序は変更しないでください。

  • 推奨インデックスライフサイクルポリシーは aliyun_default_ilm_policy という名前で、デフォルトで aliyun_default_index_template テンプレートに適用されます。

  • インデックスライフサイクル設定を有効にしても、クラスター上で他のインデックスライフサイクルポリシーを作成できます。インデックスライフサイクルポリシーでは、クローズアクションはサポートされていません。

  • 新しいインスタンスを購入する際、購入ページでシナリオを選択できます。Commercial Edition インスタンスでは汎用シナリオが、Enhanced Edition インスタンスではログシナリオがデフォルトで選択されます。購入後、対応するテンプレートが自動的に適用されます。シナリオなし に設定されている場合は、このトピックの手順に従って有効化してください。その後、手動で設定を送信してテンプレートを適用する必要があります。

  • コンソールで利用可能なオプションは、Elasticsearch インスタンスの管理バージョンによって異なる場合があります。シナリオベースの設定がコンソールで利用できない場合は、Elasticsearch API (PUT _template/aliyun_default_index_template) を使用して設定を構成してください。

  • クラスターにコールドデータノードがない場合や、バージョン 6.7.0 より前のバージョンを実行している場合、インデックスライフサイクル設定オプションはデフォルトで無効になっています。この機能を使用するには、「Elasticsearch ILM」を参照して手動で設定してください。

シナリオベースの設定テンプレートの変更

  1. Alibaba Cloud Elasticsearch コンソールにログインします。

  2. 左側のナビゲーションペインで、Elasticsearch クラスター をクリックします。

  3. 対象のインスタンスに移動します。

    1. 上部メニューで、リソースグループとリージョンを選択します。

    2. Elasticsearch クラスター ページで、対象インスタンスの ID をクリックします。

  4. 左側のナビゲーションペインで、ES クラスターの設定 をクリックします。

  5. シナリオベースの設定 エリアで、変更 の横にある シナリオ をクリックします。

  6. シナリオの選択 ダイアログボックスで、シナリオ を選択し、OK をクリックします。この操作は動的に行われるため、クラスターの再起動は不要です。

  7. シナリオ設定テンプレートを変更します。

    シナリオベースの設定テンプレートには、次の 3 種類の設定が含まれます。

    • 動的クラスター設定:クラスター設定を動的に変更します。これは、PUT /_cluster/settings コマンドの実行に相当します。詳細については、「Cluster update settings」をご参照ください。

    • インデックステンプレート設定:新しいインデックスを作成する際に自動的に適用されるテンプレートを定義します。テンプレートへの変更は、既存のインデックスには影響しません。これは、PUT _template/aliyun_default_index_template コマンドの実行に相当します。詳細については、「Index templates」をご参照ください。

    • インデックスライフサイクル設定:バージョン 6.7.0 以降のインスタンスでは、インデックスライフサイクルテンプレートを有効にできます。これは、PUT _ilm/policy/aliyun_default_ilm_policy コマンドの実行に相当します。詳細については、「Setting up a new policy」をご参照ください。

    以下の手順では、インデックステンプレート設定 の変更方法を示します。他の設定タイプについても手順は同様です。

    1. インデックステンプレート設定 をクリックします。

    2. インデックステンプレート設定 ページで、適用 をクリックします。

      各機能の説明は次のとおりです。

      • 適用:右側のパネルの推奨テンプレートを、左側のパネルの現在の設定に適用します。その後、現在の設定を変更できます。

      • 比較:現在の設定と推奨テンプレートとの差分を表示します。このボタンは、現在の設定を変更した後にのみ利用可能になります。比較モードでは編集は無効になります。

      • リセット:現在の設定を、クラスターで現在有効な設定にリセットします。

    3. 左側の 現在の設定 セクションで、現在のテンプレートの設定を変更します。

    4. 変更後、比較 をクリックして、変更した設定と推奨テンプレートとの差分を表示します。

      比較ページでは、左側のペインに現在の設定、右側のペインに汎用シナリオの推奨設定が表示されます。差分のある行はハイライト表示されます。たとえば、index.search.slowlog.threshold.fetch.* のすべてのレベルにおける現在のしきい値は 0 ms ですが、推奨値は warn レベルで 200 ms、trace レベルで 50 ms、debug レベルで 80 ms、info レベルで 100 ms です。比較ページから、[適用] をクリックして推奨設定を適用するか、[キャンセル] をクリックして編集ページに戻るか、[リセット] をクリックしてデフォルト値を復元できます。

    5. キャンセル をクリックします。

  8. 送信 をクリックします。

    送信後、変更された設定がクラスターに適用されます。

動的クラスターパラメーター

シナリオベースのテンプレートを有効にすると、クラスター設定を動的に変更できます。次の表に、動的クラスター設定のパラメーターについて説明します。

パラメーター

説明

cluster.routing.allocation.balance.index

ノード間での各インデックスのシャード分散を調整するための重み係数です。デフォルト値は 0.55f です。値を大きくすると、クラスター内のすべてのノードに各インデックスのシャードがより均等に分散されます。検索シナリオでは、この値を 0.8f に増やすことで、シャードの分散がより均一になり、クエリのパフォーマンスが向上します。

cluster.routing.allocation.balance.shard

ノードに割り当てられたシャードの総数に対する重み係数です。デフォルト値は 0.45f です。値を大きくすると、クラスター内のすべてのノードでシャードの総数を均等化する傾向が強まります。

search.max_buckets

1 つのレスポンスで許可されるバケットの最大数です。Elasticsearch 6.2 以降でサポートされています。デフォルト値は -1 (制限なし) ですが、結果が 10,000 バケットを超えると、廃止予定の警告がログに記録されます。Elasticsearch 7.x では、デフォルト値は 10,000 です。

インデックステンプレートパラメーター

シナリオベースのテンプレートを有効にすると、クラスターのインデックステンプレートを動的に変更できます。次の表に、インデックステンプレートのパラメーターについて説明します。

重要

推奨インデックステンプレートは aliyun_default_index_template という名前で、その順序は Integer.MIN_VALUE+1 です。カスタムテンプレートとの競合を避けるため、この順序は変更しないでください。このテンプレートは、カスタム設定に影響を与えることなく、ユースケースに合わせた推奨インデックス設定を提供します。

シャーディングとパフォーマンスのパラメーター

パラメーター

説明

index_patterns

テンプレートのマッチングに使用するインデックスパターンです。このパターンはワイルドカードをサポートし、デフォルトは * です。この設定の変更は推奨しません。

index.number_of_shards

インデックスのプライマリシャードの数です。バージョン 7.x より前はデフォルトで 5 でした。バージョン 7.0 以降では、デフォルトは 1 です。この値を 1 に設定することで、クラスター内のシャード数を効果的に制御し、シャードの過剰な増加に起因するパフォーマンスの問題を防ぎます。

index.refresh_interval

リフレッシュ操作の頻度です。デフォルトは 1 s です。リアルタイムの可視性が重要でない場合は、この値を大きくする (たとえば 10 s にする) ことで、リフレッシュのオーバーヘッドを削減し、クラスターのパフォーマンスを向上させることができます。

index.unassigned.node_left.delayed_timeout

ノードがクラスターから離脱した後のレプリカシャードの割り当てを遅延させるタイムアウト時間です。デフォルト値は 1 min です。この値を大きくする (たとえば 5 min にする) ことで、クラスターの回復を高速化できます。

セグメントマージパラメーター

パラメーター

説明

index.merge.policy.segments_per_tier

ティアごとのセグメント数です。値を小さくするとセグメント数は減りますが、マージ操作が増えるため、インデックス作成のパフォーマンスが低下する可能性があります。デフォルト値は 10 です。この値は index.merge.policy.max_merge_at_once より小さくしないでください。

index.merge.policy.max_merged_segment

インデックス作成時における単一セグメントのおおよその最大サイズです。デフォルト値は 5 GB です。

translog パラメーター

パラメーター

説明

index.translog.durability

データ更新ごとに translog をディスクに同期的に永続化するかどうかを設定します。有効な値は次のとおりです。

  • request:リクエストごとに translog をディスクに同期的に永続化し、ノード障害時のデータ損失を防ぎます。

  • async:translog を定期的に非同期でディスクに永続化します。これにより書き込みパフォーマンスは向上しますが、永続化が完了する前にノード障害が発生した場合、データ損失のリスクがあります。

スローログパラメーター

パラメーター

説明

index.search.slowlog.level

低速クエリのログレベルです。

index.search.slowlog.threshold.query.warn

warn レベルの低速クエリログのしきい値です。

index.search.slowlog.threshold.query.info

info レベルの低速クエリログのしきい値です。

index.search.slowlog.threshold.query.debug

debug レベルの低速クエリログのしきい値です。

index.search.slowlog.threshold.query.trace

trace レベルの低速クエリログのしきい値です。

index.search.slowlog.threshold.fetch.warn

warn レベルの低速フェッチログのしきい値です。

index.search.slowlog.threshold.fetch.info

info レベルの低速フェッチログのしきい値です。

index.search.slowlog.threshold.fetch.debug

debug レベルの低速フェッチログのしきい値です。

index.search.slowlog.threshold.fetch.trace

trace レベルの低速フェッチログのしきい値です。

index.indexing.slowlog.level

低速インデックス作成操作のログレベルです。

index.indexing.slowlog.source

ログに記録する _source の文字数です。

index.indexing.slowlog.threshold.index.warn

warn レベルの低速インデックス作成ログのしきい値です。

index.indexing.slowlog.threshold.index.info

info レベルの低速インデックス作成ログのしきい値です。

index.indexing.slowlog.threshold.index.debug

debug レベルの低速インデックス作成ログのしきい値です。

index.indexing.slowlog.threshold.index.trace

trace レベルの低速インデックス作成ログのしきい値です。

その他のパラメーター

パラメーター

説明

index.lifecycle.name

インデックスライフサイクルポリシーの名前です。

mappings._default_._all.enabled

_all フィールドを有効にするかどうかを制御します。バージョン 5.x では、デフォルト値は true です (false に設定することを推奨します)。バージョン 6.x では、デフォルト値は false です。このパラメーターはバージョン 7.x で削除されました。

インデックスライフサイクルパラメーター

インデックスライフサイクルポリシーは、インデックスが異なるフェーズをどのように移行するかを定義します。有効にすると、ポリシーは aliyun_default_ilm_policy という名前になり、デフォルトで aliyun_default_index_template テンプレートに適用されます。このポリシーは、Elasticsearch API のテンプレートの取得ライフサイクルポリシーの取得 API を使用して表示できます。

重要
  • シナリオベースのインデックスライフサイクル設定を有効にしても、クラスター上で他のインデックスライフサイクルポリシーを作成できます。

  • このオプションは、コールドデータノードがないクラスターや、バージョン 6.7.0 より前のバージョンを実行しているクラスターでは、デフォルトで無効になっています。この機能を使用するには、「Elasticsearch ILM」を参照して手動で設定してください。

  • インデックスライフサイクルポリシーでは、クローズアクションはサポートされていません。

パラメーター

説明

phases.hot.min_age

インデックスがホットフェーズに入るまでの最小期間です。

phases.hot.actions.set_priority.priority

ホットフェーズにあるインデックスの優先度です。

phases.warm.min_age

インデックスがウォームフェーズに入るまでの最小期間です。

phases.warm.actions.allocate.number_of_replicas

ウォームフェーズにあるインデックスのレプリカシャードの数です。

phases.warm.actions.allocate.require.box_type

ウォームフェーズでのシャード割り当てに必要なノード属性です。たとえば、シャードを warm ノードにのみ割り当てるように要求できます。

phases.warm.actions.set_priority.priority

ウォームフェーズにあるインデックスの優先度です。

phases.cold.min_age

インデックスがコールドフェーズに入るまでの最小期間です。

phases.cold.actions.set_priority.priority

コールドフェーズにあるインデックスの優先度です。

phases.delete.min_age

インデックスがデリートフェーズに入るまでの最小期間です。