6 統計関数

この章では、統計情報の検索および調査に使用する関数について説明します。ここで説明する統計には、ストアの操作と状態に関連する統計、およびパラレル・スキャン操作に関連する統計の2種類があります。

ストア関連の統計の場合、メトリックはノードごとまたは操作ごとに取得できます。統計情報はすべて、kv_get_stats()を使用して割り当てる構造体に含まれます。kv_release_stats()を使用して、この構造に割り当てられたリソースを解放します。

多くの場合、統計情報は時間間隔ごとにレポートされます。たとえば、最大、最小および平均数をレポートする情報を取得した場合に行われます。この場合、レポート間隔は、clearパラメータに対して値1を指定してkv_get_stats()を呼び出すことによって再開できます。

パラレル・スキャン統計の場合、統計は、kv_parallel_scan_get_partition_metrics()またはkv_parallel_scan_get_shard_metrics()のいずれかを使用して、パラレル・スキャン・イテレータから取得されます。これは、複数の異なる関数を使用して調査できる構造を返します。kv_release_detailed_metrics_list()を使用してこの構造を解放します。

統計関数

統計関数	説明
kv_get_node_metrics()	KVストアの各ノードに関連付けられたメトリックを返します
kv_get_num_nodes()	KVストアに含まれるノードの数を返します
kv_get_num_operations()	実行された操作の数を返します
kv_get_operation_metrics()	KVストア操作に関連付けられたメトリックを集計します
kv_get_stats()	KVストアに関連付けられた統計を返します
kv_release_stats()	統計構造を解放します
kv_stats_string()	各操作のメトリックを含む説明文字列を返します

パラレル・スキャン統計関数

パラレル・スキャン統計関数	説明
kv_detailed_metrics_list_size()	詳細なメトリック・リストのサイズを返します
kv_detailed_metrics_list_get_record_count()	詳細なメトリック・リスト内のレコード数を返します
kv_detailed_metrics_list_get_scan_time()	パラレル・スキャンの実行に使用した時間を返します
kv_detailed_metrics_list_get_name()	パラレル・スキャンで使用されたシャードまたはパーティションの名前を返します
kv_parallel_scan_get_partition_metrics()	パーティションのパラレル・スキャン・メトリックを返します
kv_parallel_scan_get_shard_metrics()	パーティションのパラレル・スキャン・メトリックを返します
kv_release_detailed_metrics_list()	詳細なメトリック・リストを解放します