このページは機械翻訳したものです。

23.4.29 ndb_top — NDB スレッドの CPU 使用率情報の表示

ndb_top は、NDB Cluster データノード上の NDB スレッドによる CPU 使用率に関する実行中の情報を端末に表示します。 出力では、各スレッドは 2 行で表され、最初にシステム統計が表示され、2 行目にスレッドの測定統計が表示されます。

ndb_top は、MySQL NDB Cluster 7.6.3 以降で使用できます。

使用法

ndb_top [-h hostname] [-t port] [-u user] [-p pass] [-n node_id]

ndb_top は、クラスタの SQL ノードとして実行中の MySQL Server に接続します。 デフォルトでは、localhost およびポート 3306 で実行されている mysqld に、パスワードを指定せずに MySQL root ユーザーとして接続しようとします。 デフォルトのホストおよびポートは、それぞれ --host (-h) および --port (-t) を使用してオーバーライドできます。 MySQL のユーザーおよびパスワードを指定するには、--user (-u) および --passwd (-p) オプションを使用します。 このユーザーは、ndbinfo データベース内のテーブルを読み取ることができる必要があります (ndb_top では、ndbinfo.cpustat および関連するテーブルの情報が使用されます)。

MySQL のユーザーアカウントおよびパスワードの詳細は、セクション6.2「アクセス制御とアカウント管理」 を参照してください。

出力はプレーンテキストまたは ASCII グラフとして使用できます。これは、それぞれ --text (-x) および --graph (-g) オプションを使用して指定できます。 これら 2 つの表示モードは同じ情報を提供し、同時に使用できます。 少なくとも 1 つの表示モードを使用する必要があります。

グラフの色表示は、デフォルトでサポートされ、有効になっています (--color または -c オプション)。 カラーサポートが有効な場合、グラフ表示には OS ユーザー時間が青、OS システム時間が緑、アイドル時間が空白で表示されます。 測定負荷の場合、実行時間には青、送信時間には黄色、送信バッファのフル待機に費やされた時間には赤、アイドル時間には空白が使用されます。 グラフ表示に表示されるパーセンテージは、アイドル状態でないすべてのスレッドのパーセンテージの合計です。 現在、色は構成できません。かわりに、--skip-color を使用してグレースケールを使用できます。

ソートされたビュー (--sort、-r) は、測定された負荷の最大および OS によって報告された負荷に基づきます。 これらの表示は、--measured-load (-m) および --os-load (-o) オプションを使用して有効または無効にできます。 少なくとも 1 つの荷重の表示を有効にする必要があります。

プログラムは、--node-id (-n) オプションで指定されたノード ID を持つデータノードから統計情報を取得しようとします。指定されていない場合、これは 1 です。ndb_top は、他のタイプのノードに関する情報を提供できません。

ビュー自体が端末ウィンドウの高さと幅に合わせて調整されます。サポートされる最小幅は 76 文字です。

一度起動すると、ndb_top は強制的に終了するまで継続して実行されます。Ctrl-C を使用してプログラムを終了できます。 表示は毎秒 1 回更新されます。異なる遅延間隔を設定するには、--sleep-time (-s) を使用します。

注記

ndb_top は、macOS、Linux および Solaris で使用できます。 現在、Windows プラットフォームではサポートされていません。

次のテーブルに、NDB Cluster プログラム ndb_top に固有のすべてのオプションを示します。 追加説明が表のあとにあります。

表 23.48 プログラムで使用されるコマンドライン・オプション ndb_top

形式	説明	追加、非推奨、または削除された
--color, -c	ASCII グラフを色で表示します。無効にするには --skip-colors を使用	(MySQLに基づくすべてのNDBリリースでサポート 8.0)
--graph, -g	グラフを使用してデータを表示します。--skip-graphs を使用して無効にします	(MySQLに基づくすべてのNDBリリースでサポート 8.0)
--help, -?	プログラム使用状況情報の表示	(MySQLに基づくすべてのNDBリリースでサポート 8.0)
--host[=name], -h	接続先の MySQL Server のホスト名または IP アドレス	(MySQLに基づくすべてのNDBリリースでサポート 8.0)
--measured-load, -m	測定された負荷をスレッド別に表示	(MySQLに基づくすべてのNDBリリースでサポート 8.0)
--node-id[=#], -n	このノード ID を持つウォッチノード	(MySQLに基づくすべてのNDBリリースでサポート 8.0)
--os-load, -o	オペレーティングシステムによって測定された負荷の表示	(MySQLに基づくすべてのNDBリリースでサポート 8.0)
--password[=password], -p	このパスワードを使用して接続	(MySQLに基づくすべてのNDBリリースでサポート 8.0)
--port[=#], -P (>=7.6.6)	MySQL Server への接続時に使用するポート番号	(MySQLに基づくすべてのNDBリリースでサポート 8.0)
--sleep-time[=seconds], -s	表示リフレッシュ間の待機時間 (秒)	(MySQLに基づくすべてのNDBリリースでサポート 8.0)
--socket, -S	接続で使用されるソケットファイル	(MySQLに基づくすべてのNDBリリースでサポート 8.0)
--sort, -r	スレッドを使用状況でソートします。--skip-sort を使用して無効にします	(MySQLに基づくすべてのNDBリリースでサポート 8.0)
--text, -t (>=7.6.6)	テキストを使用したデータの表示	(MySQLに基づくすべてのNDBリリースでサポート 8.0)
--user[=name], -u	この MySQL ユーザーとして接続	(MySQLに基づくすべてのNDBリリースでサポート 8.0)

NDB 7.6.6 以降では、ndb_top は共通の NDB プログラムオプション --defaults-file, --defaults-extra-file, --print-defaults, --no-defaults および --defaults-group-suffix もサポートしています。 (Bug #86614、Bug #26236298)

その他のオプション

• --color, -c

  コマンド行形式	--color
  型	Boolean
  デフォルト値	TRUE

  ASCII グラフを色で表示します。無効にするには --skip-colors を使用します。

• --graph, -g

  コマンド行形式	--graph
  型	Boolean
  デフォルト値	TRUE

  グラフを使用してデータを表示します。無効にするには --skip-graphs を使用します。 このオプションまたは --text は true である必要があります。両方のオプションが true の場合があります。

• --help, -?

  コマンド行形式	--help
  型	Boolean
  デフォルト値	TRUE

  プログラム使用状況情報を表示します。

• --host[=name], -h

  コマンド行形式	--host[=name]
  型	文字列
  デフォルト値	localhost

  接続先の MySQL Server のホスト名または IP アドレス。

• --measured-load, -m

  コマンド行形式	--measured-load
  型	Boolean
  デフォルト値	FALSE

  測定された負荷をスレッド別に表示します。 このオプションまたは --os-load は true である必要があります。両方のオプションが true の場合があります。

• --node-id[=#], -n

  コマンド行形式	--node-id[=#]
  型	Integer
  デフォルト値	1

  このノード ID を持つデータノードを監視します。

• --os-load, -o

  コマンド行形式	--os-load
  型	Boolean
  デフォルト値	TRUE

  オペレーティングシステムによって測定された負荷を表示します。 このオプションまたは --measured-load は true である必要があります。両方のオプションが true の場合があります。

• --passwd[=password], -p

  コマンド行形式	--passwd[=password]
  型	Boolean
  デフォルト値	NULL

  このパスワードを使用して接続します。

  このオプションは NDB 7.6.4 では非推奨です。 NDB 7.6.6 では削除され、--password オプションに置き換えられます。 (Bug #26907833)

• --password[=password], -p

  コマンド行形式	--password[=password]
  型	Boolean
  デフォルト値	NULL

  このパスワードを使用して接続します。

  このオプションは、NDB 7.6.6 で、以前に使用された --passwd オプションの代替として追加されました。 (Bug #26907833)

• --port[ = #]、-t (NDB 7.6.6 以降: -P )

  コマンド行形式	--port[=#]
  型	Integer
  デフォルト値	3306

  MySQL Server への接続時に使用するポート番号。

  NDB 7.6.6 以降では、このオプションの短い形式は -P で、-t は --text オプションの短い形式として再利用されます。 (Bug #26907833)

• --sleep-time[=seconds], -s

  コマンド行形式	--sleep-time[=seconds]
  型	Integer
  デフォルト値	1

  表示がリフレッシュされるまでの待機時間 (秒)。

• --socket=path/to/file, -S

  コマンド行形式	--socket
  型	パス名
  デフォルト値	[none]

  指定されたソケットファイルを接続に使用します。

  NDB 7.6.6 に追加されました。 (Bug #86614、Bug #26236298)

• --sort, -r

  コマンド行形式	--sort
  型	Boolean
  デフォルト値	TRUE

  スレッドを使用状況でソートします。無効にするには --skip-sort を使用します。

• --text, -t

  コマンド行形式	--text
  型	Boolean
  デフォルト値	FALSE

  テキストを使用したデータの表示。 このオプションまたは --graph は true である必要があります。両方のオプションが true の場合があります。

  このオプションの短い形式は以前のバージョンの NDB Cluster では -x でしたが、これはサポートされなくなりました。

• --user[=name], -u

  コマンド行形式	--user[=name]
  型	文字列
  デフォルト値	root

  この MySQL ユーザーとして接続します。

出力例.  次の図は、負荷が中程度の ndbmtd データノードを備えた Linux システムの端末ウィンドウで実行されている ndb_top を示しています。 ここでは、テキストとグラフの両方の出力を提供するために、ndb_top -n8 -x を使用してプログラムが起動されています:

図 23.26 ターミナルで実行されている ndb_top

NDB 8.0.20 以降、ndb_top はスレッドのスピン時間も緑色で表示します。