クロスクラスター複製の管理

クロスクラスター複製タスクを管理するための情報を使用します。これには、複製の進行状況の確認、複製の一時停止と再開、フォロワーインデックスの再作成、複製の終了が含まれます。

クロスクラスター複製を使用するには、Kibanaにアクセスし、管理 “> スタック管理に移動します。サイドナビゲーションで、クロスクラスター複製を選択します。

複製統計の確認

フォロワーインデックスの複製の進行状況を確認し、詳細なシャード統計を表示するには、クロスクラスター複製にアクセスし、フォロワーインデックスタブを選択します。

複製の詳細を表示したいフォロワーインデックスの名前を選択します。スライドアウトパネルには、フォロワーシャードによって管理される読み取りおよび書き込み操作を含む、フォロワーインデックスの設定と複製統計が表示されます。

より詳細な統計を表示するには、インデックス管理で表示をクリックし、インデックス管理でフォロワーインデックスの名前を選択します。フォロワーインデックスに関する詳細な統計のタブを開きます。

APIの例

フォロワースタッツAPIを使用して、シャードレベルでの複製の進行状況を確認します。このAPIは、フォロワーシャードによって管理される読み取りおよび書き込みに関する洞察を提供します。また、再試行可能な読み取り例外と、ユーザーの介入が必要な致命的な例外を報告します。

複製の一時停止と再開

リーダーインデックスの複製を一時停止および再開するには、クロスクラスター複製にアクセスし、フォロワーインデックスタブを選択します。

一時停止したいフォロワーインデックスを選択し、管理 “> 複製を一時停止を選択します。フォロワーインデックスのステータスが「一時停止」に変更されます。

複製を再開するには、フォロワーインデックスを選択し、複製を再開を選択します。

APIの例

一時停止フォロワーAPIを使用して複製を一時停止し、その後再開フォロワーAPIを使用して複製を再開できます。これらのAPIを併用することで、初期設定がユースケースに適していない場合に、フォロワーシャードタスクの読み取りおよび書き込みパラメータを調整できます。

フォロワーインデックスの再作成

ドキュメントが更新または削除されると、基盤となる操作は、index.soft_deletes.retention_lease.periodパラメータで定義された期間、Luceneインデックスに保持されます。この設定はリーダーインデックスで構成します。

フォロワーインデックスが開始されると、リーダーインデックスから保持リースを取得します。このリースは、フォロワーが操作を受信したことを示すか、リースが期限切れになるまで、ソフト削除が削除されないようにリーダーに通知します。

フォロワーインデックスがリーダーに対して十分に遅れ、操作を複製できない場合、Elasticsearchはindices[].fatal_exceptionエラーを報告します。この問題を解決するには、フォロワーインデックスを再作成します。新しいフォロワーインデックスが開始されると、リモート回復プロセスがリーダーからLuceneセグメントファイルを再コピーします。

フォロワーインデックスの再作成は破壊的な操作です。フォロワーインデックスを含むクラスター上のすべての既存のLuceneセグメントファイルが削除されます。

フォロワーインデックスを再作成するには、クロスクラスター複製にアクセスし、フォロワーインデックスタブを選択します。

フォロワーインデックスを選択し、複製を一時停止します。フォロワーインデックスのステータスが「一時停止」に変更されたら、再度フォロワーインデックスを選択し、リーダーインデックスのフォローを解除します。

フォロワーインデックスは標準インデックスに変換され、クロスクラスター複製ページには表示されなくなります。

サイドナビゲーションで、インデックス管理を選択します。前の手順からフォロワーインデックスを選択し、フォロワーインデックスを閉じます。

その後、フォロワーインデックスを再作成して、複製プロセスを再起動できます。

APIを使用

一時停止フォローAPIを使用して複製プロセスを一時停止します。その後、フォロワーインデックスを閉じて再作成します。例えば:

Python

  1. resp = client.ccr.pause_follow(
  2.    index="follower_index",
  3. )
  4. print(resp)
  6. resp1 = client.indices.close(
  7.    index="follower_index",
  8. )
  9. print(resp1)
  11. resp2 = client.ccr.follow(
  12.    index="follower_index",
  13.    wait_for_active_shards="1",
  14.    remote_cluster="remote_cluster",
  15.    leader_index="leader_index",
  16. )
  17. print(resp2)

Ruby

  1. response = client.ccr.pause_follow(
  2.   index: 'follower_index'
  3. )
  4. puts response
  6. response = client.indices.close(
  7.   index: 'follower_index'
  8. )
  9. puts response
  11. response = client.ccr.follow(
  12.   index: 'follower_index',
  13.   wait_for_active_shards: 1,
  14.   body: {
  15.    remote_cluster: 'remote_cluster',
  16.    leader_index: 'leader_index'
  17.   }
  18. )
  19. puts response

Js

  1. const response = await client.ccr.pauseFollow({
  2.   index: "follower_index",
  3. });
  4. console.log(response);
  6. const response1 = await client.indices.close({
  7.   index: "follower_index",
  8. });
  9. console.log(response1);
  11. const response2 = await client.ccr.follow({
  12.   index: "follower_index",
  13.   wait_for_active_shards: 1,
  14.   remote_cluster: "remote_cluster",
  15.   leader_index: "leader_index",
  16. });
  17. console.log(response2);

Console

  1. POST /follower_index/_ccr/pause_follow
  3. POST /follower_index/_close
  5. PUT /follower_index/_ccr/follow?wait_for_active_shards=1
  6. {
  7.   "remote_cluster" : "remote_cluster",
  8.   "leader_index" : "leader_index"
  9. }

複製の終了

リーダーインデックスのフォローを解除して、複製を終了し、フォロワーインデックスを標準インデックスに変換できます。

クロスクラスター複製にアクセスし、フォロワーインデックスタブを選択します。

フォロワーインデックスを選択し、複製を一時停止します。フォロワーインデックスのステータスが「一時停止」に変更されたら、再度フォロワーインデックスを選択し、リーダーインデックスのフォローを解除します。

フォロワーインデックスは標準インデックスに変換され、クロスクラスター複製ページには表示されなくなります。

その後、インデックス管理を選択し、前の手順からフォロワーインデックスを選択し、フォロワーインデックスを閉じます。

APIを使用

フォロー解除APIを使用して複製を終了できます。このAPIは、フォロワーインデックスを標準（非フォロワー）インデックスに変換します。