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の出力について説明しています。
統計の名前 | 値の例 | 簡単な説明 | 関連情報 |
---|---|---|---|
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 |