Documentation Home
MySQL 8.0 リファレンスマニュアル
Download this Manual
PDF (US Ltr) - 36.1Mb
PDF (A4) - 36.2Mb


MySQL 8.0 リファレンスマニュアル  /  ...  /  ndb_top — NDB スレッドの CPU 使用率情報の表示

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

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_top から表示します。 利用されているリソースなど、各ノードの情報を表示します。

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