nodetool tablestats

テーブルに関する統計を表示します。

テーブルに関する統計を表示します。

構文 

$ nodetool <オプション> tablestats -i -- (<keyspace>.<table> ... ) -H 
  • オプションは以下のとおりです。
    • (-h | --host) <ホスト名> | <IPアドレス>
    • (-p | --port) <ポート番号>
    • (-pw | --password) <パスワード>
    • (-u | --username) <ユーザー名>
    • (-pwf <passwordFilePath | --password-file <passwordFilePath>)
  • -- オプションと間違えられる可能性のある引数とオプションを分離します。
  • Iは、後続のテーブルを無視し、他のCassandraテーブルの情報のみを表示します。
  • keyspace.tableは、1つ以上のキースペースとテーブルの名前をドット表記で表したものです。
  • Hは、バイトをキロバイト(KB)、メガバイト(MB)、ギガバイト(GB)、テラバイト(TB)など、より認識しやすい形式に変換します。 (Cassandra 2.1.1)

構文の凡例 

  • 山かっこ(< >)は、リテラルではなく変数を意味する
  • イタリック体は指定が任意であることを意味する
  • パイプ(|)記号はORまたはAND/ORを意味する
  • 省略記号(...)は繰り返し可能を意味する
  • 範囲記号「(」および「)」はリテラルではなく、範囲を示す

説明 

nodetool tablestatsコマンドは、1つ以上のテーブルに関する統計を表示します。1つ以上のキースペースとテーブルの名前を指定するにはドット表記を使用します。キースペースとテーブルを指定しなければ、すべてのテーブルに関する統計が表示されます。 -iオプションを使用すると、指定されたテーブル以外のすべてのテーブルに関する統計が表示されます。 Cassandra 2.1以降でメトリクス・コア・ライブラリを使用することで、出力情報が詳しく、わかりやすくなります。

以下の表は、nodetool tablestatsの出力について説明しています。
nodetool tablestatsの出力
統計の名前 値の例 簡単な説明 関連情報
Keyspace libdata キースペースの名前 キースペースとテーブル
Read count 11207 起動後にlibdataキースペース内のテーブルを読み取る要求が行われた回数  
Read latency 0.047. . . ms libdataキースペース内のテーブルを読み取る際のレイテンシー OpsCenterのアラート・メトリック
Write count 17598 起動後にlibdataキースペース内のテーブルを更新する要求が行われた回数 同上
Write latency 0.053. . . ms libdataキースペース内にテーブルを書き込む際のレイテンシー 同上
Pending tasks 0 キースペース内のテーブルの読み取り、書き込み、およびクラスター操作に対するキュー内のタスク OpsCenterの保留タスク・メトリック
テーブル libout Cassandraテーブルの名前  
SSTable count 3 テーブルのデータを含むSSTableの数 SSTableカウント・メトリックの使用方法およびOpsCenterのアラート・メトリック
Space used (live), bytes: 9592399 テーブルで使用されている領域(オペレーティング・システムに依存) 高度なシステム・アラート・メトリック
Space used (total), bytes: 9592399 同上 同上
Space used by snapshots (total), bytes: 0 バックアップ・データにより占有されている領域  
SSTable compression ratio 0.367. . . 圧縮によるデータ表現サイズの比率 圧縮のオプションの種類
Memtable cell count 1022550 memtable内のデータのセル数(ストレージ・エンジン行×カラム) メモリー内のCassandra memtableの構造
memtableデータのサイズ(バイト単位) 32028148 memtableデータのサイズ 同上
Memtable switch count 3 memtableが満杯になって空のmemtableと交換された回数(テーブルのmemtableがディスクにフラッシュされるたびに増加する) How memtables are measuredの記事
Local read count 11207 起動後にテーブルに対して発生したローカルの読み取り要求の回数 OpsCenter alertのドキュメント
Local read latency 0.048 ms テーブルを読み取る要求が完了するまでのミリ秒単位の往復時間 読み取りのレイテンシーに影響する要因
Local write count 17598 起動後にテーブルを更新するローカル要求が発生した回数 OpsCenter alertのドキュメント
Local write latency 0.054 ms テーブルの更新が完了するまでのミリ秒単位の往復時間 書き込みのレイテンシーに影響する要因
Pending tasks 0 保留中の読み取り、書き込み、およびクラスター操作の数 OpsCenter pending task metricsのドキュメント
Bloom filter false positives 0 ブルーム・フィルターによって行が存在することが報告されたが、実際には絶対数に存在しなかったときに発生する偽陽性の数 ブルーム・フィルターの調整
Bloom filter false ratio 0.00000 すべてのブルーム・フィルター・チェックに対する偽陽性の比率 同上
Bloom filter space used, bytes 11688 ブルーム・フィルター・データのバイト・サイズ 同上
Compacted partition minimum bytes 1110 メモリー内でコンパクションされるパーティションの下限サイズ 行のキャッシュ・サイズを概算するときに使用します。各テーブルについて、キャッシュ内の行数である、報告された行キャッシュ・サイズに、コンパクションされた行の平均サイズを掛け、それらを合計します。
Compacted partition maximum bytes 126934 コンパクションされたテーブル行の上限サイズ。 cassandra.yaml in_memory_compaction _limit_in_mbで構成可能
Compacted partition mean bytes 2730 コンパクションされたテーブル行の平均サイズ  
Average live cells per slice (last five minutes) 0.0 過去5分間にシングル・キー・クエリーでスキャンされた平均セル数。  
Average tombstones per slice (last five minutes) 0.0 過去5分間にシングル・キー・クエリーでスキャンされた平均トゥームストーン数。  

 

この例は、libdataテーブルをディスクにフラッシュした後に表示されたコマンド出力を抜粋したものです。

$ nodetool tablestats libdata.libout
Keyspace:libdata
	Read Count: 11207
	Read Latency:0.047931114482020164 ms.
	Write Count: 17598
	Write Latency:0.053502954881236506 ms.
	Pending Flushes: 0
		Table:libout
		SSTable count: 3
		Space used (live), bytes: 9088955
		Space used (total), bytes: 9088955
		Space used by snapshots (total), bytes: 0
		SSTable Compression Ratio: 0.36751363892150946
		Memtable cell count: 0
		Memtable data size, bytes: 0
		Memtable switch count: 3
		Local read count: 11207
		Local read latency:0.048 ms
		Local write count: 17598
		Local write latency:0.054 ms
		Pending flushes: 0
		Bloom filter false positives: 0
		Bloom filter false ratio: 0.00000
		Bloom filter space used, bytes: 11688
		Compacted partition minimum bytes: 1110
		Compacted partition maximum bytes: 126934
		Compacted partition mean bytes: 2730
		Average live cells per slice (last five minutes): 0.0
		Average tombstones per slice (last five minutes): 0.0

人間が判読可能になるオプションの使用

-Hオプションを使用することにより、人間が判読可能な単位で出力が表示されます。例:

$ nodetool tablestats demodb.nhanes -H
Keyspace: demodb
	Read Count: 0
	Read Latency: NaN ms.
	Write Count: 20050
	Write Latency: 0.08548014962593516 ms.
	Pending Flushes: 0
		Table: nhanes
		SSTable count: 1
		Space used (live):13.75 MB
		Space used (total):13.75 MB
		Space used by snapshots (total): 0 bytes
		SSTable Compression Ratio: 0.3064650643762481
		Memtable cell count: 0
		Memtable data size: 0 bytes
		Memtable switch count: 1
		Local read count: 0
		Local read latency: NaN ms
		Local write count: 20050
		Local write latency: 0.085 ms
		Pending flushes: 0
		Bloom filter false positives: 0
		Bloom filter false ratio: 0.00000
		Bloom filter space used:23.73 KB
		Compacted partition minimum bytes:1.87 KB
		Compacted partition maximum bytes:2.69 KB
		Compacted partition mean bytes:2.26 KB
		Average live cells per slice (last five minutes): 0.0
		Maximum live cells per slice (last five minutes): 0.0
		Average tombstones per slice (last five minutes): 0.0
		Maximum tombstones per slice (last five minutes): 0.0

----------------
cassandra.yamlファイルの場所は、インストールのタイプによって異なります。
パッケージ・インストール /etc/cassandra/cassandra.yaml
tarボール・インストール install_location/resources/cassandra/conf/cassandra.yaml
Windowsインストール C:\Program Files\DataStax Community\apache-cassandra\conf\cassandra.yaml