ndb_top在终端中显示有关 NDB Cluster 数据节点上 NDB 线程 CPU 使用情况的运行信息。每个线程在输出中由两行表示,第一行显示系统统计信息,第二行显示线程的测量统计信息。
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 服务器。默认情况下,它会尝试连接到运行在
端口 3306 上的mysqldlocalhost
,作为未指定密码的 MySQL
root
用户。您可以分别使用
--host
(-h
) 和
--port
(-t
) 覆盖默认主机和端口。要指定 MySQL 用户和密码,请使用
--user
(-u
) 和
--passwd
(-p
) 选项。该用户必须能够读取
ndbinfo
数据库中的表( ndb_top使用来自
ndbinfo.cpustat
相关表的信息)。
有关 MySQL 用户帐户和密码的更多信息,请参阅第 6.2 节,“访问控制和帐户管理”。
输出以纯文本或 ASCII 图形形式提供;您可以分别使用--text
( -x
) 和
--graph
( -g
) 选项指定它。这两种显示模式提供相同的信息;它们可以同时使用。必须至少使用一种显示模式。
默认情况下支持并启用图形的颜色显示(--color
或-c
选项)。启用颜色支持后,图形显示以蓝色显示 OS 用户时间,以绿色显示 OS 系统时间,以空白显示空闲时间。对于测量的负载,蓝色用于执行时间,黄色用于发送时间,红色用于发送缓冲区已满等待时间,空白用于空闲时间。图形显示中显示的百分比是所有非空闲线程的百分比总和。颜色目前不可配置;您可以使用灰度代替使用
--skip-color
.
排序视图 ( --sort
,
-r
) 基于测量负载的最大值和操作系统报告的负载。可以使用
--measured-load
( -m
) 和
--os-load
( -o
) 选项启用和禁用这些显示。必须启用至少其中一个负载的显示。
该程序尝试从具有
--node-id
( -n
) 选项给出的节点 ID 的数据节点获取统计信息;如果未指定,则为1。ndb_top
无法提供有关其他类型节点的信息。
视图根据终端窗口的高度和宽度自行调整;支持的最小宽度为 76 个字符。
一旦启动,ndb_top将持续运行,直到被迫退出;您可以使用退出程序
Ctrl-C
。显示每秒更新一次;要设置不同的延迟间隔,请使用
--sleep-time
( -s
)。
ndb_top在 macOS、Linux 和 Solaris 上可用。Windows 平台目前不支持它。
下表包括特定于 NDB Cluster 程序ndb_top的所有选项。表后有其他说明。
表 23.50 与程序 ndb_top 一起使用的命令行选项
格式 | 描述 | 添加、弃用或删除 |
---|---|---|
以彩色显示 ASCII 图形;使用 --skip-colors 禁用 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
读取全局文件后读取给定文件 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
仅从给定文件中读取默认选项 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
还阅读带有 concat(group, suffix) 的组 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
使用图表显示数据;使用 --skip-graphs 禁用 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
显示程序使用信息 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
要连接的 MySQL 服务器的主机名或 IP 地址 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
从登录文件中读取给定路径 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
按线程显示测量的负载 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
不要从登录文件以外的任何选项文件中读取默认选项 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
具有此节点 ID 的监视节点 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
显示操作系统测量的负载 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
使用此密码连接 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
|
连接到 MySQL 服务器时使用的端口号 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
打印程序参数列表并退出 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
显示刷新之间等待的时间,以秒为单位 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
用于连接的套接字文件 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
按用途对线程进行排序;使用 --skip-sort 禁用 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
|
使用文本显示数据 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
显示程序使用信息;与 --help 相同 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
|
以此 MySQL 用户身份连接 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
附加选项
--color
,-c
命令行格式 --color
以彩色显示 ASCII 图形;用于
--skip-colors
禁用。-
命令行格式 --defaults-extra-file=path
类型 细绳 默认值 [none]
读取全局文件后读取给定文件。
-
命令行格式 --defaults-file=path
类型 细绳 默认值 [none]
仅从给定文件中读取默认选项。
-
命令行格式 --defaults-group-suffix=string
类型 细绳 默认值 [none]
还可以阅读带有 concat(group, suffix) 的组。
--graph
,-g
命令行格式 --graph
使用图表显示数据;用于
--skip-graphs
禁用。此选项或--text
必须为真;这两个选项都可能是正确的。--help
,-?
命令行格式 --help
显示程序使用信息。
--host[
=name]
,-h
命令行格式 --host=string
类型 细绳 默认值 localhost
要连接的 MySQL 服务器的主机名或 IP 地址。
-
命令行格式 --login-path=path
类型 细绳 默认值 [none]
从登录文件中读取给定路径。
--measured-load
,-m
命令行格式 --measured-load
按线程显示测量的负载。此选项或
--os-load
必须为真;这两个选项都可能是正确的。-
命令行格式 --no-defaults
不要从登录文件以外的任何选项文件中读取默认选项。
--node-id[
=#]
,-n
命令行格式 --node-id=#
类型 整数 默认值 1
观察具有此节点 ID 的数据节点。
--os-load
,-o
命令行格式 --os-load
显示操作系统测量的负载。此选项或
--measured-load
必须为真;这两个选项都可能是正确的。--password[
=password]
,-p
命令行格式 --password=password
类型 细绳 默认值 NULL
使用此密码和 指定的 MySQL 用户连接到 MySQL 服务器
--user
。此密码仅与 MySQL 用户帐户相关联,与加密
NDB
备份使用的密码没有任何关系。--port[
=#]
,-P
命令行格式 --port=#
类型 整数 默认值 3306
连接到 MySQL 服务器时使用的端口号。
(以前,此选项的缩写形式是
-t
,现在改用为 的缩写形式--text
。)-
命令行格式 --print-defaults
打印程序参数列表并退出。
--sleep-time[
=seconds]
,-s
命令行格式 --sleep-time=#
类型 整数 默认值 1
显示刷新之间等待的时间,以秒为单位。
-
命令行格式 --socket=path
类型 路径名 默认值 [none]
使用指定的套接字文件进行连接。
--sort
,-r
命令行格式 --sort
按用途对线程进行排序;用于
--skip-sort
禁用。--text
,-t
命令行格式 --text
使用文本显示数据。此选项或
--graph
必须为真;这两个选项都可能是正确的。(此选项的缩写形式出现
-x
在以前版本的 NDB Cluster 中,但不再受支持。)-
命令行格式 --usage
显示帮助文本并退出;一样
--help
。 --user[
=name]
,-u
命令行格式 --user=name
类型 细绳 默认值 root
以此 MySQL 用户身份连接。通常需要
--password
选项提供的密码。
示例输出。
下图显示了ndb_top在 Linux 系统的终端窗口中运行,其中有一个
ndbmtd数据节点处于中等负载下。在这里,已使用
ndb_top
调用程序以提供文本和图形输出:
-n8
-x
从 NDB 8.0.20 开始,ndb_top还显示线程的自旋时间,以绿色显示。