MENU

ElasticsearchからOpenSearchへ本番ログ基盤を移行する|インデックス互換と段階切り替え設計

目次

なぜ本番ログ基盤の移行が必要になるのか

2021年1月、Elastic社はElasticsearchおよびKibanaのライセンスをApache 2.0からSSPL(Server Side Public License)とElastic Licenseのデュアルライセンスへ変更しました。SSPLはOSIが承認するオープンソースライセンスではなく、商用クラウドサービスへの組み込みに制約が生じます。これを受けてAWSはElasticsearch 7.10のフォークとしてOpenSearchプロジェクトを2021年4月に立ち上げ、Apache 2.0ライセンスでの開発を継続しています。

2026年時点では、OpenSearch 2.x系が安定版としてリリースされており、Amazon OpenSearch ServiceをはじめとするマネージドサービスもOpenSearch 2系への移行を推奨しています。一方で、既存のElasticsearch 7.x系インフラをそのまま継続利用している組織も多く、ライセンスコストの増大・EOL対応・セキュリティパッチの適用可能性という3点が移行を検討する主な動機になっています。本番ログ基盤は停止が難しく、移行の影響範囲が広いため、計画的な段階移行が不可欠です。

インデックス互換性の実態と限界を把握する

OpenSearchはElasticsearch 7.10のAPIと高い互換性を持ちますが、「完全互換」ではありません。移行前にこの差異を把握することが失敗を防ぐ最初のステップです。

互換性がある領域としては、インデックスのマッピング定義(mappings)・設定(settings)・ドキュメントの保存形式が挙げられます。Luceneのセグメントファイル形式はElasticsearch 7.10相当のものをOpenSearch 1.x系がそのまま継承しているため、同一メジャーバージョン帯であればスナップショットのリストアが原則として成立します。

一方で注意が必要な差異も存在します。

  • クライアントライブラリ: elasticsearch-py(公式Pythonクライアント)はv8以降でOpenSearch非対応になりました。OpenSearch用には opensearch-py を使う必要があります。Logstash・Fluentd・Beats系プラグインも同様に「OpenSearch対応版」の有無を確認してください。
  • セキュリティプラグイン: OpenSearchのセキュリティ機能はElastic Stackの X-Pack Security と設定ファイルの書式が異なります。認証・認可の設定は移行時に再構築が必要です。
  • _type フィールド: Elasticsearch 7.xで非推奨になった _type は、OpenSearch 2.x では完全に削除されています。旧来の複数タイプインデックスを使っている場合はインデックス設計の見直しが先行作業になります。
  • Elasticsearch 8.x 以降のインデックス: Elasticsearch 8.x で作成されたインデックスのスナップショットはOpenSearchに直接リストアできません。Elasticsearch 7.10相当のバージョンまで一度ダウングレードするか、reindex-from-remote を利用する必要があります。

段階切り替え設計の考え方

本番ログ基盤を無停止(もしくは最小停止)で移行するには、いくつかの段階に分割することが基本になります。大きく3つのフェーズで設計するのが一般的です。

フェーズ1:並行稼働(デュアルライト)

FluentdやLogstashなどのログ収集レイヤーで、ElasticsearchとOpenSearchの両方に書き込みを行う構成にします。読み取り(Kibana/OpenSearch Dashboards等)はElasticsearchのままにしつつ、OpenSearch側にデータが正しく溜まるか確認します。この段階では過去ログはOpenSearch側にはなく、新着ログのみ二重書き込みされます。

フェーズ2:過去インデックスの移送

スナップショットまたは reindex-from-remote を使い、過去のインデックスをOpenSearchへ転送します。運用中のインデックスは書き込みが続くため、移送後にデュアルライトで差分を埋めてから読み取りをOpenSearchへ切り替えます。

フェーズ3:Elasticsearch停止

読み取り・書き込みの両方がOpenSearchへ移行できたことを確認してから、Elasticsearchへの書き込みを止め、一定期間のデータ保持を経てElasticsearchクラスターを停止します。フェーズ3に移行するまでの期間は、切り戻し猶予として最低でも1~2週間を確保することが推奨されます。

スナップショットとReindex APIを用いた移行手順

実際の移行オペレーションは大きく「スナップショット方式」と「reindex-from-remote 方式」に分かれます。スナップショット方式はバージョン互換がある場合(Elasticsearch 7.10 → OpenSearch 1.x/2.x)に使えるより高速な手段です。

スナップショット方式の流れ

まずElasticsearch側でスナップショットリポジトリ(S3・NFS等)を設定し、対象インデックスのスナップショットを取得します。次にOpenSearch側で同一のリポジトリを読み取り可能な状態でマウントし、POST _snapshot/<repo>/<snapshot>/_restore でリストアを実行します。リストア対象が大量インデックスの場合は indices パラメータで絞り込みながら順次実施します。

リストア後はインデックスの doc count とプライマリシャードのサイズをElasticsearchと突き合わせて確認します。GET <index>/_count と GET _cat/indices/<index>?v で数値を比較し、差異がなければリストア完了とみなします。

reindex-from-remote 方式の流れ

バージョン差異が大きい場合や、Elasticsearch 8.x からの移行では reindex-from-remote を使います。OpenSearch側の reindex.remote.whitelist(OpenSearch 2.x では reindex.remote.allowlist)にElasticsearchのホスト・ポートを追加してから、以下の形式でリクエストを送ります。

POST _reindex
{
  "source": {
    "remote": {
      "host": "https://es-host:9200",
      "username": "user",
      "password": "pass"
    },
    "index": "logs-2025.11",
    "size": 1000
  },
  "dest": {
    "index": "logs-2025.11"
  }
}

size はバッチサイズです。ログ基盤では1インデックスあたり数億件に及ぶことがあるため、slice(並列スライス)パラメータを併用してスループットを上げます。なお reindex-from-remote はソースクラスターにも読み取り負荷をかけるため、本番ピーク時間帯を避けてスロットリング設定(requests_per_second)を入れることが一般的です。

移行後の動作検証とモニタリング

読み取りをOpenSearchへ切り替えた直後は、以下の観点で動作確認を行います。

  • クエリ整合性: よく使うダッシュボードのクエリ結果がElasticsearch時代と一致するか確認します。集計系クエリ(terms aggregation・date histogram等)は特に差異が出やすい箇所です。
  • 書き込みレート: Fluentd/LogstashのOpenSearchプラグインが正常に書き込んでいるか、ログ収集側の metrics(バッファキュー長・エラー数)を確認します。
  • クラスターヘルス: GET _cluster/health でステータスが green であること、シャードのアサインが完了していることを確認します。
  • JVMヒープ使用率: OpenSearch 2.x ではデフォルトの JVM ヒープサイズ設定が変更されています。移行直後はメモリ使用率の推移を24~48時間モニタリングします。

切り戻し計画と2026年現行環境での注意点

本番移行で最も重要なのは、問題が発生したときに速やかに切り戻せる準備です。デュアルライト期間中であれば、ログ収集レイヤーの向き先をElasticsearchに戻すだけで切り戻しは完了します。読み取り(ダッシュボード)の切り戻しも、エンドポイントURLを変更するだけで対応できる構成にしておくことが重要です。

一方、デュアルライトを終了してElasticsearchへの書き込みを止めた後は、切り戻しに「OpenSearchからの差分データをElasticsearchへ逆同期する」工程が加わります。これは実装コストが高いため、フェーズ3(Elasticsearch停止)への移行は十分な検証期間を設けた上で慎重に判断してください。

2026年時点の現行環境における主な注意点をまとめます。

  • OpenSearch 2.x のブレイキングチェンジ: OpenSearch 2.0以降では _source の扱いや、いくつかのAPIエンドポイントがElasticsearch 7.x と非互換になっています。特に GET _nodes/stats のレスポンス形式は一部変更されており、監視ツールがこれを参照している場合は設定修正が必要です。
  • Fluent Bit 3.x: 2025年以降リリースのFluent Bit 3.x では opensearch output プラグインが標準バンドルされており、Elasticsearch出力プラグインとは別のコンフィグになります。移行時はプラグイン名の変更と設定ファイルの書き換えが必要です。
  • ISM(Index State Management): OpenSearchのISMポリシーはElasticsearchのILM(Index Lifecycle Management)と概念は近似しますが、API・設定ファイルの書式が異なります。ログのローテーション・削除ポリシーはOpenSearch移行時に再定義が必要です。
  • Amazon OpenSearch Serviceのバージョンサポート: Amazon OpenSearch ServiceではOpenSearch 1.xのEOLが段階的に進んでいます。マネージドサービスを利用している場合はサポートポリシーを確認し、2.x以降への移行計画を並行して進めることが推奨されます。

ElasticsearchからOpenSearchへの移行はライセンス対応だけでなく、長期的な技術スタックの整合性を高める機会でもあります。段階移行の設計を丁寧に行い、切り戻し手順を事前に確認してから本番投入に臨むことで、リスクを最小限に抑えられます。

「コマンドは打てる。次は”現場で通用する型”を最短で身につけたい」——そんなあなたへ。

ネットの断片的なTipsをコピペするだけでは、体系的な運用スキルはなかなか積み上がりません。リナックスマスター.JPの無料メルマガ「リナマガ」では、現場で実際に使うLinuxサーバー運用の考え方を、順を追って実務目線でお届けしています。いま登録された方には、安全なサーバー構築の「型」をまとめた『Linuxサーバー構築入門マニュアル(図解60P)』を完全無料でプレゼント中です。

>> 図解60P『Linux入門マニュアル』を無料で受け取る
(メルマガ登録は10秒・いつでも解除OK)

※ 「独学の時間がもったいない」「プロから現場の技術を最短で学びたい」という本気の方には、2日で実務レベルが身につく初心者向けハンズオンセミナーもご用意しています。

PR・広告

新しいLinuxの教科書 第2版(Amazon)

コマンド操作から基本運用までを手を動かして学べる定番書。記事で触れた技術の土台固めに。

Amazonで見る

※ Amazonのアソシエイトとして、当サイトは適格販売により収入を得ています。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

目次