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
| 形式 | 説明 | 追加、非推奨、または削除された |
|---|---|---|
| ASCII グラフを色で表示します。無効にするには --skip-colors を使用 | (MySQLに基づくすべてのNDBリリースでサポート 8.0) |
|
| グラフを使用してデータを表示します。--skip-graphs を使用して無効にします | (MySQLに基づくすべてのNDBリリースでサポート 8.0) |
|
| プログラム使用状況情報の表示 | (MySQLに基づくすべてのNDBリリースでサポート 8.0) |
|
| 接続先の MySQL Server のホスト名または IP アドレス | (MySQLに基づくすべてのNDBリリースでサポート 8.0) |
|
| 測定された負荷をスレッド別に表示 | (MySQLに基づくすべてのNDBリリースでサポート 8.0) |
|
| このノード ID を持つウォッチノード | (MySQLに基づくすべてのNDBリリースでサポート 8.0) |
|
| オペレーティングシステムによって測定された負荷の表示 | (MySQLに基づくすべてのNDBリリースでサポート 8.0) |
|
| このパスワードを使用して接続 | (MySQLに基づくすべてのNDBリリースでサポート 8.0) |
|
|
|
MySQL Server への接続時に使用するポート番号 | (MySQLに基づくすべてのNDBリリースでサポート 8.0) |
| 表示リフレッシュ間の待機時間 (秒) | (MySQLに基づくすべてのNDBリリースでサポート 8.0) |
|
| 接続で使用されるソケットファイル | (MySQLに基づくすべてのNDBリリースでサポート 8.0) |
|
| スレッドを使用状況でソートします。--skip-sort を使用して無効にします | (MySQLに基づくすべてのNDBリリースでサポート 8.0) |
|
|
|
テキストを使用したデータの表示 | (MySQLに基づくすべてのNDBリリースでサポート 8.0) |
| この 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型 Boolean デフォルト値 TRUEASCII グラフを色で表示します。無効にするには
--skip-colorsを使用します。 -
コマンド行形式 --graph型 Boolean デフォルト値 TRUEグラフを使用してデータを表示します。無効にするには
--skip-graphsを使用します。 このオプションまたは--textは true である必要があります。両方のオプションが true の場合があります。 -
コマンド行形式 --help型 Boolean デフォルト値 TRUEプログラム使用状況情報を表示します。
-
コマンド行形式 --host[=name]型 文字列 デフォルト値 localhost接続先の MySQL Server のホスト名または IP アドレス。
-
コマンド行形式 --measured-load型 Boolean デフォルト値 FALSE測定された負荷をスレッド別に表示します。 このオプションまたは
--os-loadは true である必要があります。両方のオプションが true の場合があります。 -
コマンド行形式 --node-id[=#]型 Integer デフォルト値 1このノード ID を持つデータノードを監視します。
-
コマンド行形式 --os-load型 Boolean デフォルト値 TRUEオペレーティングシステムによって測定された負荷を表示します。 このオプションまたは
--measured-loadは true である必要があります。両方のオプションが true の場合があります。 -
コマンド行形式 --passwd[=password]型 Boolean デフォルト値 NULLこのパスワードを使用して接続します。
このオプションは NDB 7.6.4 では非推奨です。 NDB 7.6.6 では削除され、
--passwordオプションに置き換えられます。 (Bug #26907833) -
コマンド行形式 --password[=password]型 Boolean デフォルト値 NULLこのパスワードを使用して接続します。
このオプションは、NDB 7.6.6 で、以前に使用された
--passwdオプションの代替として追加されました。 (Bug #26907833) -
--port[=#]、-t(NDB 7.6.6 以降:-P)コマンド行形式 --port[=#]型 Integer デフォルト値 3306MySQL Server への接続時に使用するポート番号。
NDB 7.6.6 以降では、このオプションの短い形式は
-Pで、-tは--textオプションの短い形式として再利用されます。 (Bug #26907833) -
コマンド行形式 --sleep-time[=seconds]型 Integer デフォルト値 1表示がリフレッシュされるまでの待機時間 (秒)。
-
コマンド行形式 --socket型 パス名 デフォルト値 [none]指定されたソケットファイルを接続に使用します。
NDB 7.6.6 に追加されました。 (Bug #86614、Bug #26236298)
-
コマンド行形式 --sort型 Boolean デフォルト値 TRUEスレッドを使用状況でソートします。無効にするには
--skip-sortを使用します。 -
コマンド行形式 --text型 Boolean デフォルト値 FALSEテキストを使用したデータの表示。 このオプションまたは
--graphは true である必要があります。両方のオプションが true の場合があります。このオプションの短い形式は以前のバージョンの NDB Cluster では
-xでしたが、これはサポートされなくなりました。 -
コマンド行形式 --user[=name]型 文字列 デフォルト値 rootこの MySQL ユーザーとして接続します。
出力例.
次の図は、負荷が中程度の ndbmtd
データノードを備えた Linux
システムの端末ウィンドウで実行されている
ndb_top を示しています。
ここでは、テキストとグラフの両方の出力を提供するために、ndb_top
-n8
-x
を使用してプログラムが起動されています:
NDB 8.0.20 以降、ndb_top はスレッドのスピン時間も緑色で表示します。