すべてのプロダクト
Search

このプロダクト

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

    ドキュメントセンター

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

    最終更新日:Aug 11, 2026

    シナリオベースの設定テンプレートは、一般的なワークロード (汎用、データ分析、データベースの高速化、検索) のベストプラクティスとなるクラスターおよびインデックス設定をパッケージ化したものです。対応するテンプレートを選択すると、推奨設定が自動的に適用され、不適切な設定によるクラスターの問題を回避できます。

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

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

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

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

    適用性

    この機能は、v2 アーキテクチャのクラスターでのみ利用可能です。クラスターのアーキテクチャを確認するには、次の手順を実行します。

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

    使用上の注意

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

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

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

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

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

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

    • コンソールのオプションは、管理バージョンによって異なる場合があります。コンソールでシナリオベースの設定が利用できない場合は、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 コマンドの実行と同じです。詳細については、「クラスター更新設定」をご参照ください。

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

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

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

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

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

        各機能は次のとおりです：

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

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

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

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

      4. 変更を加えた後、比較 をクリックして、変更した設定と推奨テンプレートの違いを確認します。

        比較ページでは、左ペインに現在の設定が表示され、右ペインに汎用シナリオの推奨設定が表示されます。違いのある行はハイライトされます。たとえば、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

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

    index.unassigned.node_left.delayed_timeout

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

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

    パラメーター

    説明

    index.merge.policy.segments_per_tier

    ティアごとのセグメント数。値が小さいとセグメント数は少なくなりますが、マージ操作が多くなり、インデクシングのパフォーマンスが低下する可能性があります。デフォルト値は 10 です。インデクシングサービスシナリオでは、デフォルト値は 30 です。この値は index.merge.policy.max_merge_at_once 未満にしないでください。

    index.merge.policy.max_merged_segment

    インデクシング中の単一セグメントのおおよその最大サイズ。デフォルト値は 5 GB です。インデクシングサービスシナリオでは、デフォルト値は 1024 MB です。

    Translog パラメーター

    パラメーター

    説明

    index.translog.durability

    データ更新のたびに translog をディスクに同期的に永続化するかどうかを制御します。有効な値：

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

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

    index.translog.flush_threshold_size

    フラッシュ操作をトリガーする translog のサイズしきい値。デフォルト値は 512 MB です。インデクシングサービスシナリオでは、デフォルト値は 2 GB です。この値を大きくすると、フラッシュの頻度が減り、書き込みパフォーマンスが向上します。

    index.translog.sync_interval

    translog が非同期でディスクに永続化される間隔。デフォルト値は 5 s です。インデクシングサービスシナリオでは、デフォルト値は 100 s です。このパラメーターは、index.translog.durability が async に設定されている場合にのみ有効です。

    スローログパラメーター

    パラメーター

    説明

    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」を参照して手動で設定する方法を確認してください。

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

    パラメーター

    説明

    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

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