クロスクラスター複製統計APIの取得

クロスクラスター複製の統計を取得します。

リクエスト

Python

  1. resp = client.ccr.stats()
  2. print(resp)

Js

  1. const response = await client.ccr.stats();
  2. console.log(response);

コンソール

  1. GET /_ccr/stats

前提条件

  • Elasticsearchのセキュリティ機能が有効になっている場合、フォロワーインデックスを含むクラスターに対してmonitorクラスター権限を持っている必要があります。詳細については、セキュリティ権限を参照してください。

説明

このAPIはクロスクラスター複製の統計を取得します。このAPIは、クロスクラスター複製に関連するすべての統計を返します。特に、このAPIは自動フォローに関する統計を返し、フォロワー統計取得APIと同じシャードレベルの統計を返します。

クエリパラメータ

  • timeout
  • （オプション、時間）結果を待つ時間の量を制御します。デフォルトは無制限です。
  • master_timeout
  • （オプション、時間単位）マスターノードを待つ期間。タイムアウトが切れる前にマスターノードが利用できない場合、リクエストは失敗し、エラーが返されます。デフォルトは30sです。リクエストがタイムアウトしないことを示すために-1に設定することもできます。

レスポンスボディ

  • auto_follow_stats
  • （オブジェクト）自動フォローコーディネーターの統計を表すオブジェクト。 
    1. -   `````number_of_failed_follow_indices
    • （長整数）自動フォローコーディネーターが自動的にフォローできなかったインデックスの数。最近の失敗の原因は、選出されたマスターノードのログとauto_follow_stats.recent_auto_follow_errorsフィールドに記録されています。
    • number_of_failed_remote_cluster_state_requests
    • （長整数）自動フォローコーディネーターが自動フォローパターンのコレクションに登録されたリモートクラスターからクラスター状態を取得できなかった回数。
    • number_of_successful_follow_indices
    • （長整数）自動フォローコーディネーターが正常にフォローしたインデックスの数。
    • recent_auto_follow_errors
    • （配列）自動フォローコーディネーターによる失敗を表すオブジェクトの配列。
  • follow_stats
  • （オブジェクト）フォロワーインデックスのシャードレベルの統計を表すオブジェクト；フォロワー統計取得APIのレスポンスの詳細を参照してください。

例

この例はクロスクラスター複製の統計を取得します：

Python

  1. resp = client.ccr.stats()
  2. print(resp)

Js

  1. const response = await client.ccr.stats();
  2. console.log(response);

コンソール

  1. GET /_ccr/stats

APIは次の結果を返します：

コンソール-結果

  1. {
  2.   "auto_follow_stats" : {
  3.    "number_of_failed_follow_indices" : 0,
  4.    "number_of_failed_remote_cluster_state_requests" : 0,
  5.    "number_of_successful_follow_indices" : 1,
  6.    "recent_auto_follow_errors" : [],
  7.    "auto_followed_clusters" : []
  8.   },
  9.   "follow_stats" : {
  10.    "indices" : [
  11.    {
  12.    "index" : "follower_index",
  13.    "total_global_checkpoint_lag" : 256,
  14.    "shards" : [
  15.    {
  16.    "remote_cluster" : "remote_cluster",
  17.    "leader_index" : "leader_index",
  18.    "follower_index" : "follower_index",
  19.    "shard_id" : 0,
  20.    "leader_global_checkpoint" : 1024,
  21.    "leader_max_seq_no" : 1536,
  22.    "follower_global_checkpoint" : 768,
  23.    "follower_max_seq_no" : 896,
  24.    "last_requested_seq_no" : 897,
  25.    "outstanding_read_requests" : 8,
  26.    "outstanding_write_requests" : 2,
  27.    "write_buffer_operation_count" : 64,
  28.    "follower_mapping_version" : 4,
  29.    "follower_settings_version" : 2,
  30.    "follower_aliases_version" : 8,
  31.    "total_read_time_millis" : 32768,
  32.    "total_read_remote_exec_time_millis" : 16384,
  33.    "successful_read_requests" : 32,
  34.    "failed_read_requests" : 0,
  35.    "operations_read" : 896,
  36.    "bytes_read" : 32768,
  37.    "total_write_time_millis" : 16384,
  38.    "write_buffer_size_in_bytes" : 1536,
  39.    "successful_write_requests" : 16,
  40.    "failed_write_requests" : 0,
  41.    "operations_written" : 832,
  42.    "read_exceptions" : [ ],
  43.    "time_since_last_read_millis" : 8
  44.    }
  45.    ]
  46.    }
  47.    ]
  48.   }
  49. }