クラスタ統計API

クラスタ統計を返します。

リクエスト

GET /_cluster/stats

GET /_cluster/stats/nodes/<node_filter>

前提条件

  • Elasticsearchのセキュリティ機能が有効になっている場合、このAPIを使用するにはmonitorまたはmanage クラスタ特権を持っている必要があります。

説明

クラスタ統計APIは、クラスタ全体の視点から統計を取得することを可能にします。このAPIは、基本的なインデックスメトリクス（シャード数、ストレージサイズ、メモリ使用量）と、クラスタを形成する現在のノードに関する情報（数、役割、OS、JVMバージョン、メモリ使用量、CPU、インストールされたプラグイン）を返します。

パスパラメータ

  • <node_filter>
  • （オプション、文字列）返される情報を制限するために使用されるノードフィルタのカンマ区切りリスト。デフォルトではクラスタ内のすべてのノードが対象です。

クエリパラメータ

  • timeout
  • （オプション、時間単位）各ノードが応答するまでの待機期間。ノードがタイムアウトが切れる前に応答しない場合、その統計は応答に含まれません。ただし、タイムアウトしたノードは応答の_nodes.failedプロパティに含まれます。デフォルトではタイムアウトなしです。

Response body

  • _nodes
  • (object) リクエストの ノードフィルター によって選択されたノードの数に関する統計を含みます。 
    1. -   `````total
    • （整数）リクエストによって選択されたノードの総数。
    • successful
    • （整数）リクエストに成功して応答したノードの数。
    • failed
    • （整数）リクエストを拒否したか、応答しなかったノードの数。この値が0でない場合、拒否または失敗の理由がレスポンスに含まれます。
  • cluster_name
  • (string) クラスター名設定 に基づくクラスターの名前。
  • cluster_uuid
  • (string) クラスターのユニーク識別子。
  • timestamp
  • (integer) 最後にクラスター統計が更新された時の Unix タイムスタンプ、ミリ秒単位。
  • status

  • （文字列）プライマリシャードとレプリカシャードの状態に基づくクラスタの健康状態。ステータスは次のとおりです：

    • green：すべてのシャードが割り当てられています。
    • yellow：すべてのプライマリシャードが割り当てられていますが、1つ以上のレプリカシャードが未割り当てです。クラスタ内のノードが故障した場合、そのノードが修復されるまで一部のデータが利用できない可能性があります。
    • red：1つ以上のプライマリシャードが未割り当てであるため、一部のデータが利用できません。これは、プライマリシャードが割り当てられる際にクラスタの起動中に一時的に発生する可能性があります。
      クラスターの健康状態を参照してください。

  • indices

  • (object) 選択されたノードに割り当てられたシャードを持つインデックスに関する統計を含みます。 

    1. -   `````count
    • (integer) 選択されたノードに割り当てられたシャードを持つインデックスの総数。
    • shards
    • (object) 選択されたノードに割り当てられたシャードに関する統計を含みます。 
      1. -   `````total
      • (integer) 選択されたノードに割り当てられたシャードの総数。
      • primaries
      • (integer) 選択されたノードに割り当てられたプライマリシャードの数。
      • replication
      • (float) すべての選択されたノードにおけるレプリカシャードとプライマリシャードの比率。
      • index
      • (object) 選択されたノードに割り当てられたシャードに関する統計を含みます。
        index のプロパティ
      • shards
      • (object) 選択されたノードに割り当てられたシャードの数に関する統計を含みます。 
        1. -   `````min
        • (integer) 選択されたノードに割り当てられたシャードの最小数。
        • max
        • (integer) 選択されたノードに割り当てられたシャードの最大数。
        • avg
        • (float) 選択されたノードに割り当てられたシャードの平均数。
      • primaries
      • (object) 選択されたノードに割り当てられたプライマリシャードの数に関する統計を含みます。
        primaries のプロパティ
        • min
        • (integer) 選択されたノードに割り当てられたプライマリシャードの最小数。
        • max
        • (integer) 選択されたノードに割り当てられたプライマリシャードの最大数。
        • avg
        • (float) 選択されたノードに割り当てられたプライマリシャードの平均数。
      • replication
      • (object) 選択されたノードに割り当てられたレプリケーションシャードの数に関する統計を含みます。
        replication のプロパティ
        • min
        • (float) 選択されたノードに割り当てられたインデックスの最小レプリケーションファクター。
        • max
        • (float) 選択されたノードに割り当てられたインデックスの最大レプリケーションファクター。
        • avg
        • (float) 選択されたノードに割り当てられたインデックスの平均レプリケーションファクター。
    • docs
    • (object) 選択されたノードのドキュメント数を含みます。
      docs のプロパティ
      • count
      • (integer) 選択されたノードに割り当てられたすべてのプライマリシャードにおける削除されていないドキュメントの総数。
        この数はLuceneセグメント内のドキュメントに基づいており、ネストされたフィールドのドキュメントを含む場合があります。
      • deleted
      • (integer) 選択されたノードに割り当てられたすべてのプライマリシャードにおける削除されたドキュメントの総数。
        この数はLuceneセグメント内のドキュメントに基づいています。Elasticsearchは、セグメントがマージされるときに削除されたLuceneドキュメントのディスクスペースを回収します。
      • total_size_in_bytes
      • (integer) 選択されたノードに割り当てられたすべてのプライマリシャードにおける総サイズ（バイト単位）。
      • total_size
      • (string) 選択されたノードに割り当てられたすべてのプライマリシャードの総サイズを人間が読みやすい文字列として表示。
    • store
    • (object) 選択されたノードに割り当てられたシャードのサイズに関する統計を含みます。
      store のプロパティ
      • size
      • (バイト単位) 選択されたノードに割り当てられたすべてのシャードの総サイズ。
      • size_in_bytes
      • (integer) 選択されたノードに割り当てられたすべてのシャードの総サイズ（バイト単位）。
      • total_data_set_size
      • (バイト単位) 選択されたノードに割り当てられたすべてのシャードのデータセットサイズの総計。これには、部分的にマウントされたインデックスのキャッシュなど、ノードに完全に保存されていないシャードのサイズが含まれます。
      • total_data_set_size_in_bytes
      • (integer) 選択されたノードに割り当てられたすべてのシャードのデータセットサイズの総計（バイト単位）。これには、部分的にマウントされたインデックスのキャッシュなど、ノードに完全に保存されていないシャードのサイズが含まれます。
      • reserved
      • (バイト値) シャードストレージが、進行中のピアリカバリー、スナップショットの復元、その他の類似の活動により、最終的にどれだけ大きくなるかの予測。
      • reserved_in_bytes
      • (integer) シャードストレージが、進行中のピアリカバリー、スナップショットの復元、その他の類似の活動により、最終的にどれだけ大きくなるかの予測（バイト単位）。
    • fielddata
    • (object) 選択されたノードの フィールドデータキャッシュ に関する統計を含みます。
      fielddata のプロパティ
      • memory_size
      • (バイト単位) 選択されたノードに割り当てられたすべてのシャードにおけるフィールドデータキャッシュに使用されるメモリの総量。
      • memory_size_in_bytes
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおけるフィールドデータキャッシュに使用されるメモリの総量（バイト単位）。
      • evictions
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおけるフィールドデータキャッシュからの追放の総数。
      • global_ordinals.build_time
      • (時間単位) すべてのフィールドのグローバルオーディナルを構築するのにかかった総時間。
      • global_ordinals.build_time_in_millis
      • (integer) すべてのフィールドのグローバルオーディナルを構築するのにかかった総時間（ミリ秒単位）。
      • global_ordinals.fields.[field-name].build_time
      • (時間単位) 指定された名前のフィールドのグローバルオーディナルを構築するのにかかった総時間。
      • global_ordinals.fields.[field-name].build_time_in_millis
      • (integer) 指定された名前のフィールドのグローバルオーディナルを構築するのにかかった総時間（ミリ秒単位）。
      • global_ordinals.fields.[field-name].shard_max_value_count
      • (long) 指定された名前のフィールドのグローバルオーディナルを構築するのにかかった総時間。
    • query_cache
    • (object) 選択されたノードのクエリキャッシュに関する統計を含みます。
      query_cache のプロパティ
      • memory_size
      • (バイト単位) 選択されたノードに割り当てられたすべてのシャードにおけるクエリキャッシュに使用されるメモリの総量。
      • memory_size_in_bytes
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおけるクエリキャッシュに使用されるメモリの総量（バイト単位）。
      • total_count
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおけるクエリキャッシュのヒットとミスの総数。
      • hit_count
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおけるクエリキャッシュのヒットの総数。
      • miss_count
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおけるクエリキャッシュのミスの総数。
      • cache_size
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおけるクエリキャッシュの現在のエントリの総数。
      • cache_count
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおけるクエリキャッシュに追加されたエントリの総数。この数には、現在のエントリと追放されたエントリが含まれます。
      • evictions
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおけるクエリキャッシュの追放の総数。
    • completion
    • (object) 選択されたノードの補完に使用されるメモリに関する統計を含みます。
      completion のプロパティ
      • size
      • (バイト単位) 選択されたノードに割り当てられたすべてのシャードにおける補完に使用されるメモリの総量。
      • size_in_bytes
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおける補完に使用されるメモリの総量（バイト単位）。
    • segments
    • (object) 選択されたノードのセグメントに関する統計を含みます。
      segments のプロパティ
      • count
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおけるセグメントの総数。
      • memory
      • (バイト単位) 選択されたノードに割り当てられたすべてのシャードにおけるセグメントに使用されるメモリの総量。
      • memory_in_bytes
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおけるセグメントに使用されるメモリの総量（バイト単位）。
      • terms_memory
      • (バイト単位) 選択されたノードに割り当てられたすべてのシャードにおける用語に使用されるメモリの総量。
      • terms_memory_in_bytes
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおける用語に使用されるメモリの総量（バイト単位）。
      • stored_fields_memory
      • (バイト単位) 選択されたノードに割り当てられたすべてのシャードにおける保存されたフィールドに使用されるメモリの総量。
      • stored_fields_memory_in_bytes
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおける保存されたフィールドに使用されるメモリの総量（バイト単位）。
      • term_vectors_memory
      • (バイト単位) 選択されたノードに割り当てられたすべてのシャードにおける用語ベクターに使用されるメモリの総量。
      • term_vectors_memory_in_bytes
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおける用語ベクターに使用されるメモリの総量（バイト単位）。
      • norms_memory
      • (バイト単位) 選択されたノードに割り当てられたすべてのシャードにおける正規化係数に使用されるメモリの総量。
      • norms_memory_in_bytes
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおける正規化係数に使用されるメモリの総量（バイト単位）。
      • points_memory
      • (バイト単位) 選択されたノードに割り当てられたすべてのシャードにおけるポイントに使用されるメモリの総量。
      • points_memory_in_bytes
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおけるポイントに使用されるメモリの総量（バイト単位）。
      • doc_values_memory
      • (バイト単位) 選択されたノードに割り当てられたすべてのシャードにおけるドキュメント値に使用されるメモリの総量。
      • doc_values_memory_in_bytes
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおけるドキュメント値に使用されるメモリの総量（バイト単位）。
      • index_writer_memory
      • (バイト単位) 選択されたノードに割り当てられたすべてのシャードにおけるすべてのインデックスライターによって使用されるメモリの総量。
      • index_writer_memory_in_bytes
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおけるすべてのインデックスライターによって使用されるメモリの総量（バイト単位）。
      • version_map_memory
      • (バイト単位) 選択されたノードに割り当てられたすべてのシャードにおけるすべてのバージョンマップによって使用されるメモリの総量。
      • version_map_memory_in_bytes
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおけるすべてのバージョンマップによって使用されるメモリの総量（バイト単位）。
      • fixed_bit_set
      • (バイト単位) 選択されたノードに割り当てられたすべてのシャードにおける固定ビットセットによって使用されるメモリの総量。
        固定ビットセットは、ネストされたオブジェクトフィールドタイプや 結合 フィールドのタイプフィルターに使用されます。
      • fixed_bit_set_memory_in_bytes
      • (integer) 選択されたノードに割り当てられたすべてのシャードにおける固定ビットセットによって使用されるメモリの総量（バイト単位）。
      • max_unsafe_auto_id_timestamp
      • (integer) 最後に再試行されたインデックスリクエストの Unix タイムスタンプ、ミリ秒単位。
      • file_sizes
      • (object) このオブジェクトはクラスター統計APIによってポピュレートされません。
        セグメントファイルに関する情報を取得するには、ノード統計APIを使用してください。
    • mappings
    • (object) 選択されたノードの フィールドマッピング に関する統計を含みます。
      mappings のプロパティ
      • total_field_count
      • (integer) すべての非システムインデックスにおけるフィールドの総数。
      • total_deduplicated_field_count
      • (integer) マッピングの重複排除を考慮したすべての非システムインデックスにおけるフィールドの総数。
      • total_deduplicated_mapping_size
      • (バイト単位) 重複排除と圧縮後のすべてのマッピングの総サイズ。
      • total_deduplicated_mapping_size_in_bytes
      • (integer) 重複排除と圧縮後のすべてのマッピングの総サイズ（バイト単位）。
      • field_types
      • (array of objects) 選択されたノードで使用される フィールドデータタイプ に関する統計を含みます。
        field_types オブジェクトのプロパティ
      • name
      • (string) 選択されたノードで使用されるフィールドデータタイプ。
      • count
      • (integer) 選択されたノードでフィールドデータタイプにマッピングされたフィールドの数。
      • index_count
      • (整数) 選択されたノードにおけるフィールドデータ型のマッピングを含むインデックスの数。
      • indexed_vector_count
      • (整数) dense_vector フィールドタイプの場合、選択されたノードにおけるインデックスされたベクトルタイプの数。
      • indexed_vector_dim_min
      • (整数) dense_vector フィールドタイプの場合、選択されたノードにおけるすべてのインデックスされたベクトルタイプの最小次元。
      • indexed_vector_dim_max
      • (整数) dense_vector フィールドタイプの場合、選択されたノードにおけるすべてのインデックスされたベクトルタイプの最大次元。
      • script_count
      • (整数) スクリプトを宣言するフィールドの数。
      • lang
      • (文字列の配列) オプションのスクリプトに使用されるスクリプト言語
      • lines_max
      • (整数) 単一フィールドスクリプトの最大行数
      • lines_total
      • (整数) スクリプトの総行数
      • chars_max
      • (整数) 単一フィールドスクリプトの最大文字数
      • chars_total
      • (整数) スクリプトの総文字数
      • source_max
      • (整数) 単一フィールドスクリプトの _source への最大アクセス数
      • source_total
      • (整数) スクリプトの _source への総アクセス数
      • doc_max
      • (整数) 単一フィールドスクリプトの doc_values への最大アクセス数
      • doc_total
      • (整数) スクリプトの doc_values への総アクセス数
      • runtime_field_types
      • (オブジェクトの配列) 選択されたノードで使用される ランタイムフィールドデータ型 に関する統計を含む。
        runtime_field_types オブジェクトのプロパティ
      • name
      • (文字列) 選択されたノードで使用されるフィールドデータ型。
      • count
      • (整数) 選択されたノードにおけるフィールドデータ型にマッピングされたランタイムフィールドの数。
      • index_count
      • (整数) 選択されたノードにおけるランタイムフィールドデータ型のマッピングを含むインデックスの数。
      • scriptless_count
      • (整数) スクリプトを宣言しないランタイムフィールドの数。
      • shadowed_count
      • (整数) インデックスされたフィールドをシャドウするランタイムフィールドの数。
      • lang
      • (文字列の配列) ランタイムフィールドスクリプトに使用されるスクリプト言語
      • lines_max
      • (整数) 単一ランタイムフィールドスクリプトの最大行数
      • lines_total
      • (整数) 現在のランタイムフィールドデータ型を定義するスクリプトの総行数
      • chars_max
      • (整数) 単一ランタイムフィールドスクリプトの最大文字数
      • chars_total
      • (整数) 現在のランタイムフィールドデータ型を定義するスクリプトの総文字数
      • source_max
      • (整数) 単一ランタイムフィールドスクリプトの _source への最大アクセス数
      • source_total
      • (整数) 現在のランタイムフィールドデータ型を定義するスクリプトの _source への総アクセス数
      • doc_max
      • (整数) 単一ランタイムフィールドスクリプトの doc_values への最大アクセス数
      • doc_total
      • (整数) 現在のランタイムフィールドデータ型を定義するスクリプトの doc_values への総アクセス数
    • analysis
    • (オブジェクト) 選択されたノードで使用される アナライザーとアナライザーコンポーネント に関する統計を含む。
      analysis のプロパティ
      • char_filter_types
      • (オブジェクトの配列) 選択されたノードで使用される 文字フィルター タイプに関する統計を含む。
        char_filter_types オブジェクトのプロパティ
      • name
      • (文字列) 選択されたノードで使用される文字フィルタータイプ。
      • count
      • (整数) 選択されたノードで文字フィルタータイプを使用しているアナライザーまたはノーマライザーの数。
      • index_count
      • (整数) 選択されたノードでの文字フィルタータイプのインデックスの数。
      • tokenizer_types
      • (オブジェクトの配列) 選択されたノードで使用される トークナイザー タイプに関する統計を含む。
        tokenizer_types オブジェクトのプロパティ
      • name
      • (文字列) 選択されたノードで使用されるトークナイザータイプ。
      • count
      • (整数) 選択されたノードでトークナイザータイプを使用しているアナライザーまたはノーマライザーの数。
      • index_count
      • (整数) 選択されたノードでトークナイザータイプを使用しているインデックスの数。
      • filter_types
      • (オブジェクトの配列) 選択されたノードで使用される トークンフィルター タイプに関する統計を含む。
        filter_types オブジェクトのプロパティ
      • name
      • (文字列) 選択されたノードで使用されるトークンフィルタータイプ。
      • count
      • (整数) 選択されたノードでトークンフィルタータイプを使用しているアナライザーまたはノーマライザーの数。
      • index_count
      • (整数) 選択されたノードでトークンフィルタータイプを使用しているインデックスの数。
      • analyzer_types
      • (オブジェクトの配列) 選択されたノードで使用される アナライザー タイプに関する統計を含む。
        analyzer_types オブジェクトのプロパティ
      • name
      • (文字列) 選択されたノードで使用されるアナライザータイプ。
      • count
      • (整数) 選択されたノードでのアナライザータイプの出現回数。
      • index_count
      • (整数) 選択されたノードでアナライザータイプを使用しているインデックスの数。
      • built_in_char_filters
      • (オブジェクトの配列) 選択されたノードで使用される組み込み 文字フィルター に関する統計を含む。
        built_in_char_filters オブジェクトのプロパティ
      • name
      • (文字列) 選択されたノードで使用される組み込み文字フィルター。
      • count
      • (整数) 選択されたノードで組み込み文字フィルターを使用しているアナライザーまたはノーマライザーの数。
      • index_count
      • (整数) 選択されたノードで組み込み文字フィルターを使用しているインデックスの数。
      • built_in_tokenizers
      • (オブジェクトの配列) 選択されたノードで使用される組み込み トークナイザー に関する統計を含む。
        built_in_tokenizers オブジェクトのプロパティ
      • name
      • (文字列) 選択されたノードで使用される組み込みトークナイザー。
      • count
      • (整数) 選択されたノードで組み込みトークナイザーを使用しているアナライザーまたはノーマライザーの数。
      • index_count
      • (整数) 選択されたノードで組み込みトークナイザーを使用しているインデックスの数。
      • built_in_filters
      • (オブジェクトの配列) 選択されたノードで使用される組み込み トークンフィルター に関する統計を含む。
        built_in_filters オブジェクトのプロパティ
      • name
      • (文字列) 選択されたノードで使用される組み込みトークンフィルター。
      • count
      • (整数) 選択されたノードで組み込みトークンフィルターを使用しているアナライザーまたはノーマライザーの数。
      • index_count
      • (整数) 選択されたノードで組み込みトークンフィルターを使用しているインデックスの数。
      • built_in_analyzers
      • (オブジェクトの配列) 選択されたノードで使用される組み込み アナライザー に関する統計を含む。
        built_in_analyzers オブジェクトのプロパティ
      • name
      • (文字列) 選択されたノードで使用される組み込みアナライザー。
      • count
      • (整数) 選択されたノードでの組み込みアナライザーの出現回数。
      • index_count
      • (整数) 選択されたノードで組み込みアナライザーを使用しているインデックスの数。
      • synonyms
      • (オブジェクト) 同義語 および 同義語グラフ トークンフィルター設定で定義された同義語に関する統計を含む。
        synonyms オブジェクトのプロパティ
      • inline
      • (オブジェクト) 同義語または同義語グラフトークンフィルターでの synonyms 設定を使用して定義されたインライン同義語。
        inline オブジェクトのプロパティ
        • count
        • (整数) 選択されたノードでのインライン同義語設定の出現回数。各インライン同義語設定は、定義された同義語に関係なく別々にカウントされます。同じ同義語を持つ2つの同義語設定は、別々の出現としてカウントされます。
        • index_count
        • (整数) 同義語トークンフィルターのためにインライン同義語設定を使用しているインデックスの数。
      • paths
      • (オブジェクト) 同義語 および 同義語グラフ トークンフィルター設定で定義された同義語ファイルに関する統計を含む。
        paths オブジェクトのプロパティ
        • count
        • (整数) 選択されたノードでのユニークな同義語パスの出現回数。
        • index_count
        • (整数) 同義語トークンフィルターのために synonyms_path 設定を使用しているインデックスの数。
      • sets
      • (オブジェクト) 同義語 および 同義語グラフ トークンフィルター設定で定義された同義語セットに関する統計を含む。
        sets オブジェクトのプロパティ
        • count
        • (整数) 選択されたノードでのユニークな同義語セットの出現回数。
        • index_count
        • (整数) 同義語トークンフィルターのために synonyms_set 設定を使用しているインデックスの数。
    • search
    • (オブジェクト) 検索実行中にコーディネーターとして機能した選択されたノードに送信された検索リクエストに関する使用統計を含む。検索リクエストは、結果に関係なく、成功裏に解析されたときに追跡されます：解析後にエラーを生成するリクエストは、データにアクセスしないリクエストと同様に使用統計に寄与します。
      search オブジェクトのプロパティ
      • total
      • (整数) 受信した検索リクエストの総数。リクエストボディを指定しない検索リクエストはカウントされません。
      • queries
      • (オブジェクト) 選択されたノードで使用されるクエリタイプ。各クエリについて、その名前と query または post_filter セクション内での使用回数が報告されます。クエリは検索リクエストごとに1回カウントされ、同じ検索リクエスト内で同じクエリタイプが複数回使用される場合、そのカウンターは1回増加します。
      • sections
      • (オブジェクト) 選択されたノードで使用される検索セクション。各セクションについて、その名前と使用回数が報告されます。
    • dense_vector
    • (オブジェクト) 選択されたノードで使用されるインデックスされた密なベクトルに関する統計を含む。
      dense_vector のプロパティ
      • value_count
      • (整数) 選択されたノードでインデックスされた密なベクトルの総数。
    • sparse_vector
    • (オブジェクト) 選択されたノードで使用されるインデックスされたスパースベクトルに関する統計を含む。
      sparse_vector のプロパティ
      • value_count
      • (整数) 選択されたノードに割り当てられたすべてのプライマリシャードにわたってインデックスされたスパースベクトルの総数。

  • nodes
  • (オブジェクト) リクエストの ノードフィルター によって選択されたノードに関する統計を含む。 
    1. -   `````count
    • (オブジェクト) リクエストの ノードフィルター によって選択されたノードのカウントを含む。
      count のプロパティ
      • total
      • (整数) 選択されたノードの総数。
      • coordinating_only
      • (整数) 役割 を持たない選択されたノードの数。これらのノードは コーディネートのみ ノードと見なされます。
      • <role>
      • (整数) 役割を持つ選択されたノードの数。役割のリストについては、ノード を参照してください。
    • versions
    • (文字列の配列) 選択されたノードで使用されている Elasticsearch バージョンの配列。
    • os
    • (オブジェクト) 選択されたノードで使用されているオペレーティングシステムに関する統計を含む。
      os のプロパティ
      • available_processors
      • (整数) 選択されたノード全体で JVM に利用可能なプロセッサの数。
      • allocated_processors
      • (整数) 選択されたノード全体でスレッドプールサイズを計算するために使用されるプロセッサの数。
        この数は、ノードの processors 設定で設定でき、OS によって報告されたプロセッサの数がデフォルトとなります。いずれの場合も、この数は 32 より大きくなることはありません。
      • names
      • (オブジェクトの配列) 選択されたノードで使用されているオペレーティングシステムに関する統計を含む。
        names のプロパティ
      • name
      • (文字列) 1つ以上の選択されたノードで使用されているオペレーティングシステムの名前。
      • count
      • (文字列) オペレーティングシステムを使用している選択されたノードの数。
      • pretty_names
      • (オブジェクトの配列) 選択したノードで使用されているオペレーティングシステムに関する統計を含みます。
        pretty_names のプロパティ
      • pretty_name
      • (文字列) 1つ以上の選択したノードで使用されているオペレーティングシステムの人間が読める名前。
      • count
      • (文字列) オペレーティングシステムを使用している選択したノードの数。
      • architectures
      • (オブジェクトの配列) 選択したノードで使用されているプロセッサアーキテクチャ（例えば、x86_64 または aarch64）に関する統計を含みます。
        architectures のプロパティ
      • arch
      • (文字列) 1つ以上の選択したノードで使用されているアーキテクチャの名前。
      • count
      • (文字列) アーキテクチャを使用している選択したノードの数。
      • mem
      • (オブジェクト) 選択したノードで使用されているメモリに関する統計を含みます。
        mem のプロパティ
      • total
      • (バイト単位) 選択したすべてのノードの物理メモリの合計量。
      • total_in_bytes
      • (整数) 選択したすべてのノードの物理メモリの合計量（バイト単位）。
      • adjusted_total
      • (バイト値) 選択したすべてのノードのメモリの合計量ですが、システムプロパティ es.total_memory_bytes を使用して指定された値を使用し、システムプロパティが設定されているノードの測定された合計メモリの代わりに使用します。
      • adjusted_total_in_bytes
      • (整数) 選択したすべてのノードのメモリの合計量（バイト単位）ですが、システムプロパティ es.total_memory_bytes を使用して指定された値を使用し、システムプロパティが設定されているノードの測定された合計メモリの代わりに使用します。
      • free
      • (バイト単位) 選択したすべてのノードの空き物理メモリの量。
      • free_in_bytes
      • (整数) 選択したすべてのノードの空き物理メモリの量（バイト単位）。
      • used
      • (バイト単位) 選択したすべてのノードで使用中の物理メモリの量。
      • used_in_bytes
      • (整数) 選択したすべてのノードで使用中の物理メモリの量（バイト単位）。
      • free_percent
      • (整数) 選択したすべてのノードの空き物理メモリの割合。
      • used_percent
      • (整数) 選択したすべてのノードで使用中の物理メモリの割合。
    • process
    • (オブジェクト) 選択したノードで使用されているプロセスに関する統計を含みます。
      process のプロパティ
      • cpu
      • (オブジェクト) 選択したノードで使用されているCPUに関する統計を含みます。
        cpu のプロパティ
      • percent
      • (整数) 選択したすべてのノードで使用されているCPUの割合。 サポートされていない場合は -1 を返します。
      • open_file_descriptors
      • (オブジェクト) 選択したノードでのオープンファイルディスクリプタに関する統計を含みます。
        open_file_descriptors のプロパティ
      • min
      • (整数) 選択したすべてのノードで同時にオープンされているファイルディスクリプタの最小数。 サポートされていない場合は -1 を返します。
      • max
      • (整数) 選択したすべてのノードで許可されている同時にオープンされているファイルディスクリプタの最大数。 サポートされていない場合は -1 を返します。
      • avg
      • (整数) 同時にオープンされているファイルディスクリプタの平均数。 サポートされていない場合は -1 を返します。
    • jvm
    • (オブジェクト) 選択したノードで使用されているJava仮想マシン（JVM）に関する統計を含みます。
      jvm のプロパティ
      • max_uptime
      • (時間単位) JVMが最後に起動してからの稼働時間。
      • max_uptime_in_millis
      • (整数) JVMが最後に起動してからの稼働時間（ミリ秒単位）。
      • versions
      • (オブジェクトの配列) 選択したノードで使用されているJVMのバージョンに関する統計を含みます。
        versions のプロパティ
      • version
      • (文字列) 1つ以上の選択したノードで使用されているJVMのバージョン。
      • vm_name
      • (文字列) JVMの名前。
      • vm_version
      • (文字列) JVMの完全なバージョン番号。
        完全なバージョン番号には、ビルド番号の前にプラス記号（+）が含まれます。
      • vm_vendor
      • (文字列) JVMのベンダー。
      • bundled_jdk
      • (Boolean) 常に true。 すべてのディストリビューションには、バンドルされたJava Development Kit（JDK）が付属しています。
      • using_bundled_jdk
      • (Boolean) true の場合、JVMでバンドルされたJDKが使用されています。
      • count
      • (整数) JVMを使用している選択したノードの総数。
      • mem
      • (オブジェクト) 選択したノードで使用されているメモリに関する統計を含みます。
        mem のプロパティ
      • heap_used
      • (バイト単位) 選択したすべてのノードでヒープによって現在使用されているメモリ。
      • heap_used_in_bytes
      • (整数) 選択したすべてのノードでヒープによって現在使用されているメモリ（バイト単位）。
      • heap_max
      • (バイト単位) 選択したすべてのノードでヒープによって使用可能な最大メモリ（バイト単位）。
      • heap_max_in_bytes
      • (整数) 選択したすべてのノードでヒープによって使用可能な最大メモリ（バイト単位）。
      • threads
      • (整数) 選択したノードでJVMによって使用されているアクティブスレッドの数。
    • fs
    • (オブジェクト) 選択したノードによって使用されているファイルストアに関する統計を含みます。
      fs のプロパティ
      • total
      • (バイト単位) 選択したすべてのノードのファイルストアの合計サイズ。
      • total_in_bytes
      • (整数) 選択したすべてのノードのファイルストアの合計サイズ（バイト単位）。
      • free
      • (バイト単位) 選択したすべてのノードのファイルストアにおける未割り当てディスクスペースの量。
      • free_in_bytes
      • (整数) 選択したすべてのノードのファイルストアにおける未割り当てバイトの総数。
      • available
      • (バイト単位) 選択したすべてのノードのファイルストアにおけるJVMに利用可能なディスクスペースの合計量。
        OSまたはプロセスレベルの制限に応じて、この量は nodes.fs.free よりも少ない場合があります。 これは、選択したElasticsearchノードが使用できる実際の空きディスクスペースの量です。
      • available_in_bytes
      • (整数) 選択したすべてのノードのファイルストアにおけるJVMに利用可能なバイトの総数。
        OSまたはプロセスレベルの制限に応じて、この数は nodes.fs.free_in_byes よりも少ない場合があります。 これは、選択したElasticsearchノードが使用できる実際の空きディスクスペースの量です。
    • plugins
    • (オブジェクトの配列) 選択したノードによってインストールされたプラグインおよびモジュールに関する統計を含みます。
      プラグインまたはモジュールがインストールされていない場合、この配列は空です。
      plugins のプロパティ
      • <plugin>
      • (オブジェクト) インストールされたプラグインまたはモジュールに関する統計を含みます。
        <plugin> のプロパティ
      • name
      • (文字列) Elasticsearchプラグインの名前。
      • version
      • (文字列) プラグインが構築されたElasticsearchのバージョン。
      • elasticsearch_version
      • (文字列) プラグインが構築されたElasticsearchのバージョン。
      • java_version
      • (文字列) プラグインが構築されたJavaのバージョン。
      • description
      • (文字列) プラグインの短い説明。
      • classname
      • (文字列) プラグインのエントリポイントとして使用されるクラス名。
      • extended_plugins
      • (文字列の配列) このプラグインがJava Service Provider Interface (SPI) を通じて拡張する他のプラグインの配列。
        このプラグインが他のプラグインを拡張しない場合、この配列は空です。
      • has_native_controller
      • (Boolean) true の場合、プラグインにはネイティブコントローラプロセスがあります。
    • network_types
    • (オブジェクト) 選択したノードによって使用されているトランスポートおよびHTTPネットワークに関する統計を含みます。
      network_types のプロパティ
      • transport_types
      • (オブジェクト) 選択したノードで使用されているトランスポートネットワークタイプに関する統計を含みます。
        transport_types のプロパティ
      • <transport_type>
      • (整数) トランスポートタイプを使用している選択したノードの数。
      • http_types
      • (オブジェクト) 選択したノードで使用されているHTTPネットワークタイプに関する統計を含みます。
        http_types のプロパティ
      • <http_type>
      • (整数) HTTPタイプを使用している選択したノードの数。
    • discovery_types
    • (オブジェクト) 選択したノードによって使用されている 発見タイプ に関する統計を含みます。
      discovery_types のプロパティ
      • <discovery_type>
      • (整数) 他のノードを見つけるために 発見タイプ を使用している選択したノードの数。
    • packaging_types
    • (オブジェクトの配列) 選択したノードにインストールされているElasticsearchディストリビューションに関する統計を含みます。
      packaging_types のプロパティ
      • flavor
      • (文字列) Elasticsearchディストリビューションのタイプ。 これは常に default です。
      • type
      • (文字列) ディストリビューションパッケージに使用されるファイルタイプ（例： tar または zip）。
      • count
      • (整数) ディストリビューションフレーバーおよびファイルタイプを使用している選択したノードの数。
  • snapshots
  • (オブジェクト) クラスター内の スナップショット アクティビティに関する統計を含みます。
    snapshots のプロパティ
    • current_counts
    • (オブジェクト) クラスター内のさまざまな進行中のスナップショットアクティビティの数を報告する統計を含みます。
      current_counts のプロパティ
      • snapshots
      • (整数) クラスターによって現在作成されているスナップショットとクローンの合計数。
      • shard_snapshots
      • (整数) クラスター内の未処理のシャードスナップショットの合計数。
      • snapshot_deletions
      • (整数) クラスターが現在実行中のスナップショット削除操作の合計数。
      • concurrent_operations
      • (整数) クラスターが現在同時に実行中のスナップショット操作の合計数。 これは snapshots と snapshot_deletions のエントリの合計であり、snapshot.max_concurrent_operations 設定 によって制限されます。
      • cleanups
      • (整数) クラスターが現在実行中のリポジトリクリーンアップ操作の合計数。 これらの操作は、同時操作の総数にはカウントされません。
    • repositories
    • (オブジェクト) リポジトリごとに分解されたスナップショットアクティビティの進捗を報告する統計を含みます。このオブジェクトには、クラスターに登録された各リポジトリのエントリが1つ含まれます。
      repositories のプロパティ
      • current_counts
      • (オブジェクト) このリポジトリの進行中のさまざまなスナップショットアクティビティの数を報告する統計を含みます。
        current_counts のプロパティ
      • snapshots
      • (整数) このリポジトリで進行中のスナップショットの合計数。
      • clones
      • (整数) このリポジトリで進行中のスナップショットクローンの合計数。
      • finalizations
      • (整数) このリポジトリの進行中のスナップショットとクローン操作の合計数で、最後の「最終化」ステップを除いてほぼ完了しています。
      • deletions
      • (整数) このリポジトリで進行中のスナップショット削除操作の合計数。
      • snapshot_deletions
      • (整数) このリポジトリから現在削除されているスナップショットの合計数。
      • active_deletions
      • (整数) このリポジトリで現在アクティブな進行中のスナップショット削除操作の合計数。スナップショット削除は他のスナップショット操作と同時に実行されないため、他の操作が完了するのを待っている保留中の削除がある場合、これは 0 になる可能性があります。
      • shards
      • (オブジェクト) このリポジトリの進行中のスナップショットアクティビティのシャードレベルの進捗を報告する統計を含みます。これらの統計は進行中のスナップショットにのみ関連しています。 
        1. -   `````total
        • (整数) このリポジトリによって現在追跡されているシャードスナップショットの合計数。この統計は進行中のスナップショットのシャードのみをカウントするため、スナップショットが完了すると減少し、進行中のスナップショットがない場合は 0 になります。
        • complete
        • (整数) このリポジトリで完了した追跡シャードスナップショットの合計数。この統計は進行中のスナップショットのシャードのみをカウントするため、スナップショットが完了すると減少し、進行中のスナップショットがない場合は 0 になります。
        • incomplete
        • (整数) このリポジトリで完了していない追跡シャードスナップショットの合計数。これは total と complete の値の差です。
        • states
        • (オブジェクト) このリポジトリ内の各状態にあるシャードスナップショットの合計数。これらの状態はスナップショットプロセスの実装の詳細であり、バージョン間で変更される可能性があります。専門家ユーザーのためにここに含まれていますが、他のユーザーは無視するべきです。
      • oldest_start_time
      • (文字列) このリポジトリで最も古い実行中のスナップショットの開始時刻。
      • oldest_start_time_in_millis
      • (整数) このリポジトリで最も古い実行中のスナップショットの開始時刻（Unixエポックからのミリ秒で表現）。

例

Python

  1. resp = client.cluster.stats(
  2.    human=True,
  3.    pretty=True,
  4. )
  5. print(resp)

Ruby

  1. response = client.cluster.stats(
  2.   human: true,
  3.   pretty: true
  4. )
  5. puts response

Js

  1. const response = await client.cluster.stats({
  2.   human: "true",
  3.   pretty: "true",
  4. });
  5. console.log(response);

コンソール

  1. GET /_cluster/stats?human&pretty

APIは次の応答を返します:

Js

  1. {
  2.    "_nodes" : {
  3.    "total" : 1,
  4.    "successful" : 1,
  5.    "failed" : 0
  6.    },
  7.    "cluster_uuid": "YjAvIhsCQ9CbjWZb2qJw3Q",
  8.    "cluster_name": "elasticsearch",
  9.    "timestamp": 1459427693515,
  10.    "status": "green",
  11.    "indices": {
  12.    "count": 1,
  13.    "shards": {
  14.    "total": 5,
  15.    "primaries": 5,
  16.    "replication": 0,
  17.    "index": {
  18.    "shards": {
  19.    "min": 5,
  20.    "max": 5,
  21.    "avg": 5
  22.    },
  23.    "primaries": {
  24.    "min": 5,
  25.    "max": 5,
  26.    "avg": 5
  27.    },
  28.    "replication": {
  29.    "min": 0,
  30.    "max": 0,
  31.    "avg": 0
  32.    }
  33.    }
  34.    },
  35.    "docs": {
  36.    "count": 10,
  37.    "deleted": 0,
  38.    "total_size": "8.6kb",
  39.    "total_size_in_bytes": 8833
  40.    },
  41.    "store": {
  42.    "size": "16.2kb",
  43.    "size_in_bytes": 16684,
  44.    "total_data_set_size": "16.2kb",
  45.    "total_data_set_size_in_bytes": 16684,
  46.    "reserved": "0b",
  47.    "reserved_in_bytes": 0
  48.    },
  49.    "search": {
  50.    ...
  51.    },
  52.    "fielddata": {
  53.    "memory_size": "0b",
  54.    "memory_size_in_bytes": 0,
  55.    "evictions": 0,
  56.    "global_ordinals": {
  57.    "build_time" : "0s",
  58.    "build_time_in_millis" : 0
  59.    }
  60.    },
  61.    "query_cache": {
  62.    "memory_size": "0b",
  63.    "memory_size_in_bytes": 0,
  64.    "total_count": 0,
  65.    "hit_count": 0,
  66.    "miss_count": 0,
  67.    "cache_size": 0,
  68.    "cache_count": 0,
  69.    "evictions": 0
  70.    },
  71.    "completion": {
  72.    "size": "0b",
  73.    "size_in_bytes": 0
  74.    },
  75.    "segments": {
  76.    "count": 4,
  77.    "memory": "8.6kb",
  78.    "memory_in_bytes": 0,
  79.    "terms_memory": "0b",
  80.    "terms_memory_in_bytes": 0,
  81.    "stored_fields_memory": "0b",
  82.    "stored_fields_memory_in_bytes": 0,
  83.    "term_vectors_memory": "0b",
  84.    "term_vectors_memory_in_bytes": 0,
  85.    "norms_memory": "0b",
  86.    "norms_memory_in_bytes": 0,
  87.    "points_memory" : "0b",
  88.    "points_memory_in_bytes" : 0,
  89.    "doc_values_memory": "0b",
  90.    "doc_values_memory_in_bytes": 0,
  91.    "index_writer_memory": "0b",
  92.    "index_writer_memory_in_bytes": 0,
  93.    "version_map_memory": "0b",
  94.    "version_map_memory_in_bytes": 0,
  95.    "fixed_bit_set": "0b",
  96.    "fixed_bit_set_memory_in_bytes": 0,
  97.    "max_unsafe_auto_id_timestamp" : -9223372036854775808,
  98.    "file_sizes": {}
  99.    },
  100.    "mappings": {
  101.    "total_field_count": 0,
  102.    "total_deduplicated_field_count": 0,
  103.    "total_deduplicated_mapping_size": "0b",
  104.    "total_deduplicated_mapping_size_in_bytes": 0,
  105.    "field_types": [],
  106.    "runtime_field_types": []
  107.    },
  108.    "analysis": {
  109.    "char_filter_types": [],
  110.    "tokenizer_types": [],
  111.    "filter_types": [],
  112.    "analyzer_types": [],
  113.    "built_in_char_filters": [],
  114.    "built_in_tokenizers": [],
  115.    "built_in_filters": [],
  116.    "built_in_analyzers": [],
  117.    "synonyms": {}
  118.    },
  119.    "versions": [
  120.    {
  121.    "version": "8.0.0",
  122.    "index_count": 1,
  123.    "primary_shard_count": 1,
  124.    "total_primary_size": "7.4kb",
  125.    "total_primary_bytes": 7632
  126.    }
  127.    ],
  128.    "dense_vector": {
  129.    "value_count": 0
  130.    },
  131.    "sparse_vector": {
  132.    "value_count": 0
  133.    }
  134.    },
  135.    "nodes": {
  136.    "count": {
  137.    "total": 1,
  138.    "data": 1,
  139.    "coordinating_only": 0,
  140.    "master": 1,
  141.    "ingest": 1,
  142.    "voting_only": 0
  143.    },
  144.    "versions": [
  145.    "8.15.2"
  146.    ],
  147.    "os": {
  148.    "available_processors": 8,
  149.    "allocated_processors": 8,
  150.    "names": [
  151.    {
  152.    "name": "Mac OS X",
  153.    "count": 1
  154.    }
  155.    ],
  156.    "pretty_names": [
  157.    {
  158.    "pretty_name": "Mac OS X",
  159.    "count": 1
  160.    }
  161.    ],
  162.    "architectures": [
  163.    {
  164.    "arch": "x86_64",
  165.    "count": 1
  166.    }
  167.    ],
  168.    "mem" : {
  169.    "total" : "16gb",
  170.    "total_in_bytes" : 17179869184,
  171.    "adjusted_total" : "16gb",
  172.    "adjusted_total_in_bytes" : 17179869184,
  173.    "free" : "78.1mb",
  174.    "free_in_bytes" : 81960960,
  175.    "used" : "15.9gb",
  176.    "used_in_bytes" : 17097908224,
  177.    "free_percent" : 0,
  178.    "used_percent" : 100
  179.    }
  180.    },
  181.    "process": {
  182.    "cpu": {
  183.    "percent": 9
  184.    },
  185.    "open_file_descriptors": {
  186.    "min": 268,
  187.    "max": 268,
  188.    "avg": 268
  189.    }
  190.    },
  191.    "jvm": {
  192.    "max_uptime": "13.7s",
  193.    "max_uptime_in_millis": 13737,
  194.    "versions": [
  195.    {
  196.    "version": "12",
  197.    "vm_name": "OpenJDK 64-Bit Server VM",
  198.    "vm_version": "12+33",
  199.    "vm_vendor": "Oracle Corporation",
  200.    "bundled_jdk": true,
  201.    "using_bundled_jdk": true,
  202.    "count": 1
  203.    }
  204.    ],
  205.    "mem": {
  206.    "heap_used": "57.5mb",
  207.    "heap_used_in_bytes": 60312664,
  208.    "heap_max": "989.8mb",
  209.    "heap_max_in_bytes": 1037959168
  210.    },
  211.    "threads": 90
  212.    },
  213.    "fs": {
  214.    "total": "200.6gb",
  215.    "total_in_bytes": 215429193728,
  216.    "free": "32.6gb",
  217.    "free_in_bytes": 35064553472,
  218.    "available": "32.4gb",
  219.    "available_in_bytes": 34802409472
  220.    },
  221.    "plugins": [
  222.    {
  223.    "name": "analysis-icu",
  224.    "version": "8.15.2",
  225.    "description": "The ICU Analysis plugin integrates Lucene ICU module into elasticsearch, adding ICU relates analysis components.",
  226.    "classname": "org.elasticsearch.plugin.analysis.icu.AnalysisICUPlugin",
  227.    "has_native_controller": false
  228.    },
  229.    ...
  230.    ],
  231.    "ingest": {
  232.    "number_of_pipelines" : 1,
  233.    "processor_stats": {
  234.    ...
  235.    }
  236.    },
  237.    "indexing_pressure": {
  238.    "memory": {
  239.    "current": {
  240.    "combined_coordinating_and_primary": "0b",
  241.    "combined_coordinating_and_primary_in_bytes": 0,
  242.    "coordinating": "0b",
  243.    "coordinating_in_bytes": 0,
  244.    "primary": "0b",
  245.    "primary_in_bytes": 0,
  246.    "replica": "0b",
  247.    "replica_in_bytes": 0,
  248.    "all": "0b",
  249.    "all_in_bytes": 0
  250.    },
  251.    "total": {
  252.    "combined_coordinating_and_primary": "0b",
  253.    "combined_coordinating_and_primary_in_bytes": 0,
  254.    "coordinating": "0b",
  255.    "coordinating_in_bytes": 0,
  256.    "primary": "0b",
  257.    "primary_in_bytes": 0,
  258.    "replica": "0b",
  259.    "replica_in_bytes": 0,
  260.    "all": "0b",
  261.    "all_in_bytes": 0,
  262.    "coordinating_rejections": 0,
  263.    "primary_rejections": 0,
  264.    "replica_rejections": 0,
  265.    "primary_document_rejections": 0
  266.    },
  267.    "limit" : "0b",
  268.    "limit_in_bytes": 0
  269.    }
  270.    },
  271.    "network_types": {
  272.    ...
  273.    },
  274.    "discovery_types": {
  275.    ...
  276.    },
  277.    "packaging_types": [
  278.    {
  279.    ...
  280.    }
  281.    ]
  282.    },
  283.    "snapshots": {
  284.    ...
  285.    }
  286. }

このAPIは、ノードフィルターを使用して、ノードのサブセットに制限することができます。

Python

  1. resp = client.cluster.stats(
  2.    node_id="node1,node*,master:false",
  3. )
  4. print(resp)

Ruby

  1. response = client.cluster.stats(
  2.   node_id: 'node1,node*,master:false'
  3. )
  4. puts response

Js

  1. const response = await client.cluster.stats({
  2.   node_id: "node1,node*,master:false",
  3. });
  4. console.log(response);

コンソール

  1. GET /_cluster/stats/nodes/node1,node*,master:false