Search:

Search all manuals
Search this manual
Manual
Couchbase Server マニュアル 2.0
Community Wiki and Resources
Couchbase Server 2.0をダウンロード
Couchbase 開発者ガイド 2.0
クライアントライブラリ
Couchbase Server フォーラム
Additional Resources
Community Wiki
Community Forums
Couchbase SDKs
Parent Section
7 管理用コマンドラインインターフェイス
Chapter Sections
Chapters

7.5. cbstatsツール

7.5.1. サーバのタイミングを取得する
7.5.2. ウォームアップ情報の取得
7.5.3. TAP情報の取得

ノードおよびクラスタレベルのパフォーマンスに関する統計情報とストレージ内のアイテムを取得するために、cbstatsツールを使用します。このツールは使用中のプラットフォームによって次の場所にあります:

Linux /opt/couchbase/bin/cbstats
Windows C:\Program Files\Couchbase\Server\bin\cbstats.exe
Mac OS X /Applications/Couchbase Server.app/Contents/Resources/couchbase-core/bin/cbstats

このツールはノード毎、バケット毎の操作であることに注意してください。 それはあなたがこの処理を実行する場合、クラスタのノードのIPアドレスとバケット名を指定する必要があることを意味します。バケット名が提供されない場合、サーバーは指定されたノードに存在する任意のデフォルトのバケットに設定を適用します。クラスタ全体に対してこの操作を実行する場合、そのクラスタに存在するすべてのノード/バケットの組み合わせに対してコマンドを実行する必要があります。

Couchbaseノードの統計情報を取得するためには、このツールを使用します。コマンドの一般的な形式は次のとおりです。

shell> cbstats <IP>:11210 <command> -b <bucket_name> [-p <bucket_password>]

BUCKET_HOSTはCouchbaseバケットのホスト名とポート番号(HOSTNAME[:PORT]) の組み合わせとなる場合、ユーザ名パスワードは、名前付きバケット認証となります。COMMAND(と[options])は、以下のオプションのいづれかとなります:

all
allocator
checkpoint [vbid]
dispatcher [logs]
hash [detail]
items
kvstore
kvtimings
raw argument
reset
slabs
tap [username password]
tapagg
timings
vkey keyname vbid

これらのオプションのうち、alltimingsは、クラスタやノードのパフォーマンスを理解するために使用する主なものになります。他のオプションは、Couchbase内部で使用され、顧客サポートインシデントを解決するのに役立ちます。

たとえば、cbstatsの出力はデータを並べ替えたり、フィルタするためにその他コマンドラインツールで使用されます。

shell> watch --diff "cbstats \
    ip-10-12-19-81:11210 -b bucket1 -p password all | egrep 'item|mem|flusher|ep_queue|bg|eje|resi|warm'"

次の表は、cbstats allコマンドを実行したときに返される結果リストとなります:

統計情報説明
ep_versionep_engineのバージョン番号
ep_storage_age最も最近保存されたオブジェクトに初期キューが入れられてからの秒数
ep_storage_age_highwatep_storage_ageの高水準値
ep_min_data_age最小データ経過時間の設定
ep_startup_timeシステムによって生成されたep_engineの起動時間
ep_queue_age_capキューの経過時間の上限設定
ep_max_txn_sizeトランザクション当たりの更新最大数
ep_data_age最も最近保存されたオブジェクトの修正以降の秒数
ep_data_age_highwatep_data_ageの高水準値
ep_too_young作成されたばかりでオブジェクトが保存されなかった回数
ep_too_old長い時間経過後、オブジェクトが保存された回数
ep_total_enqueued永続化のためにキューに入れられたアイテム総数
ep_total_new_items新しく登録されたアイテム総数
ep_total_del_items削除されたアイテムの総数
ep_total_persistedアイテムの総数
ep_item_flush_failedストレージエラーの為にフラッシュ出来なかった回数
ep_item_commit_failedストレージエラーによりコミットに失敗したトランザクション回数
ep_item_begin_failedストレージエラーにより開始できなかったトランザクション回数
ep_expired_accessアプリケーションアクセス上でアイテムの有効期限が切れた回数
ep_expired_pagerEPエンジンのアイテムページャーにより有効期限が切れた回数
ep_item_flush_expiredアイテムの有効期限が原因でフラッシュ出来なかった回数
ep_queue_size:ストレージのキューに入れられたアイテムの数
ep_flusher_todo書き込みがまだ残っているアイテム数
ep_flusher_stateフラッシャ・スレッドの現在の状態
ep_commit_num書き込みコミットの総数
ep_commit_time最新コミットのミリ秒数
ep_commit_time_totalコミットに費やした累積ミリ秒数
ep_vbucket_delvBucket削除イベントの数
ep_vbucket_del_failvBucket削除イベントに失敗した数
ep_vbucket_del_max_walltimevBucketの削除に費やした最大時間(μs)
ep_vbucket_del_avg_walltimevBucketの削除に費やした平均時間(μs)
ep_flush_duration_totalフラッシュに費やした累積ミリ秒数
ep_flush_allディスクflush_allがスケジュールされている場合はTrue
ep_num_ops_get_metagetMeta処理の数
ep_num_ops_set_metasetWithMeta処理の数
ep_num_ops_del_metadelWithMeta処理の数
curr_itemsアクティブなvbucketsのアイテム数(temp+live)
curr_temp_itemsアクティブvbuckets中のtempアイテム数
curr_items_tot 現在のアイテム数。activeではないもの(replica、deadそしてpending 状態)も含む。
ep_kv_sizevBucketの状態に関係なく、アイテムメタデータ、キーとその値の格納に使用されるメモリ。アイテム値が追い出された場合、この情報はアイテム値の容量分だけ減少します。
ep_value_size常駐するキー値を格納するために使用されるメモリ
ep_overhead永続キュー、レプリケーションキュー、チェックポイントなどのような一時的なデータで使用される余分なメモリ
ep_max_data_sizeメモリ上の最大データサイズ
ep_mem_low_wat 自動回復の為に低水準値を付加する
ep_mem_high_wat 自動回復の為に高水準値を付加する
ep_total_cache_sizevBucketの状態やアイテム値が取り出されたかに関係なく、全アイテムの総バイト数
ep_oom_errors処理中に発生した回復不能なエラー回数
ep_tmp_oom_errors処理中に発生した一時的なエラー回数
ep_mem_tracker_enabledメモリ使用量を追跡する場合は、Trueにする
ep_bg_fetchedディスクからのアイテムフェッチ回数
ep_bg_meta_fetchedディスクからのメタアイテムのフェッチ回数
ep_bg_remaining_jobs実行中のバックグラウンドフェッチジョブの数
ep_tap_bg_fetchedディスクフェッチしたTAP数
ep_tap_bg_fetch_requeuedタップ・バックグラウンドタスクのフェッチが再キューイングされた回数
ep_num_pager_runs追加メモリを伴う繰り返しページャー検索を実行した回数
ep_num_expiry_pager_runsメモリ/ディスクから有効期限切れのアイテムを除外する有効期限切れページャ処理を実行した回数
ep_num_access_scanner_runsスナップショットのワーキングセットにスキャンを実行した回数
ep_access_scanner_num_items直近にアクセススキャナタスクがアクセスログに集めたアイテム数
ep_access_scanner_task_time次回のアクセススキャナタスクの実行予定時間(GMT)
ep_access_scanner_last_runtime直近のアクセススキャナタスクが完了するまでにかかった秒数
ep_items_rm_from_checkpointsクローズド参照されていないチェックポイントから削除されたアイテムの数
ep_num_value_ejectsアイテムの値がメモリからディスクへ追い出された回数
ep_num_eject_failuresメモリからディスクへ追い出すことが出来なかったアイテム数
ep_num_not_my_vbuckets自分以外のバケットで実行中に例外が発生した回数
ep_tap_keepaliveTAPキープアライブ時間
ep_dbnameDBパス
ep_dbinitDB初期化の秒数
ep_io_num_readI/O読み取り操作の数
ep_io_num_writeI/O書き込み操作の数
ep_io_read_bytes読み込まれたバイト数(キー+値)
ep_io_write_bytes書き込まれたバイト数(キー+値)
ep_pending_ops保留vbucketsを待っているOPS数
ep_pending_ops_totalリセットされてからブロックされた保留中OPS合計
ep_pending_ops_max1つの保留vBucketを待っている最大OPS
ep_pending_ops_max_duration保留vBucketの待機の最大時間(μs)
ep_bg_num_samples平均値に含まれているサンプル数
ep_bg_min_wait待ちキューの最短時間(μs)
ep_bg_max_wait待ちキューの最長時間(μs)
ep_bg_wait_avgディスパッチャに処理される前のアイテム平均待機時間(μs)
ep_bg_min_load最短ロード時間(μs)
ep_bg_max_load最長ロード時間(μs)
ep_bg_load_avg永続化層からロードされたアイテムの平均時間(μs)
ep_num_non_resident常駐データが無かったアイテム数
ep_store_max_concurrencyストレージ層で許可される最大同時実行数
ep_store_max_readers同時読み取り専用ストレージ・スレッドの最大数
ep_store_max_readwrite同時読み取り/書き込みストレージスレッドの最大数
ep_bg_wait待機キューの合計経過時間
ep_bg_load永続化層からロードされたアイテムの合計経過時間
ep_inconsistent_slave_chk“downstream”マスタにチェックポイントメッセージの受信を許可するかどうかを示すフラグ
ep_mlog_compactor_runsログ圧縮実行した回数
ep_vb_total合計vBuckets(総数)
curr_items_tot アイテムの総数
curr_itemsメモリ内のアクティブなアイテム数
curr_temp_itemsメモリ内の一時的なアイテム数
vb_dead_num無効化されたvBuckets数
ep_diskqueue_itemsディスクキューのアイテム総数
ep_diskqueue_memoryディスクキューで使用されるメモリの合計
ep_diskqueue_fillディスクキューにエンキューされたアイテム総数
ep_diskqueue_drainディスクキューに出されたアイテム総数
ep_diskqueue_pending書き込み保留中の合計バイト数
ep_vb_snapshot_totalディスクにスナップショットを取ったVB状態の総数
vb_active_numアクティブなvBuckets数
vb_active_curr_itemsメモリ内のアイテム数
vb_active_num_non_resident常駐データが無かったアイテム数
vb_active_perc_mem_residentメモリ上に存在した割合
vb_active_eject追い出されたアイテム数
vb_active_expiredアイテムの有効期限が切れた回数
vb_active_ht_memoryハッシュテーブルのメモリオーバーヘッド
vb_active_itm_memoryアイテムのメモリ合計
vb_active_meta_data_memoryメモリ上のメタデータ総数
vb_active_ops_create作成処理の数
vb_active_ops_update更新処理の数
vb_active_ops_delete削除処理の数
vb_active_ops_reject拒否された処理の数
vb_active_queue_sizeディスクキューのでアクティブなアイテムサイズ
vb_active_queue_memoryディスクキューに使用されるメモリ
vb_active_queue_ageミリ秒毎のディスクキューの経過時間の和
vb_active_queue_pending書き込み保留中の合計バイト数
vb_active_queue_fillエンキューされたアイテム総数
vb_active_queue_drain追い出されたアイテム総数
vb_active_num_ref_items参照されたアイテム数
vb_active_num_ref_ejects追い出されたアイテム値を参照した回数
vb_pending_num保留中のvBuckets数
vb_pending_curr_itemsメモリ内のアイテム数
vb_pending_num_non_resident常駐データが無かったアイテム数
vb_pending_perc_mem_resident常駐アイテムに使用されるメモリの割合
vb_pending_eject追い出されたアイテム数
vb_pending_expiredアイテムの有効期限が切れた回数
vb_pending_ht_memoryハッシュテーブルのメモリオーバーヘッド
vb_pending_itm_memoryメモリ上のアイテム総数
vb_pending_meta_data_memoryメモリ上のメタデータ総数
vb_pending_ops_create作成処理の数
vb_pending_ops_update更新処理の数
vb_pending_ops_delete削除処理の数
vb_pending_ops_reject拒否された処理の数
vb_pending_queue_sizeディスクキューに入っている保留中のアイテム
vb_pending_queue_memoryディスクキューに使用されるメモリ
vb_pending_queue_ageミリ秒毎のディスクキューの経過時間の和
vb_pending_queue_pending書き込み保留中の合計バイト数
vb_pending_queue_fillエンキューされたアイテム総数
vb_pending_queue_drain追い出されたアイテム総数
vb_pending_num_ref_items参照されたアイテム数
vb_pending_num_ref_ejects追い出されたアイテム値を参照した回数