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