MySQL :: MySQL 8.3 Reference Manual :: 25.5.30 ndb_top — View CPU usage information for NDB threads

version 8.3

8.0 current
5.7

8.0 Japanese

MySQL 8.3 Reference Manual / ... / ndb_top — View CPU usage information for NDB threads

25.5.30 ndb_top — 查看 NDB 线程的 CPU 使用信息

ndb_top 在终端中显示 NDB 集群数据节点上的 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 连接到 MySQL 服务器，该服务器作为集群的 SQL 节点。默认情况下，它尝试连接到 localhost 的 3306 端口上的 mysqld，作为 MySQL root 用户，无密码指定。你可以使用 --host (-h) 和 --port (-t) 选项来覆盖默认的主机和端口。要指定 MySQL 用户和密码，请使用 --user (-u) 和 --passwd (-p) 选项。该用户必须能够读取 ndbinfo 数据库中的表 (ndb_top 使用 ndbinfo.cpustat 和相关表中的信息)。

有关 MySQL 用户账户和密码的更多信息，请参阅第 8.2 节，“访问控制和账户管理”。

输出可以是纯文本或 ASCII 图形；你可以使用 --text (-x) 和 --graph (-g) 选项来指定。这两个显示模式提供相同的信息；它们可以同时使用。至少需要启用一个显示模式。

图形显示支持颜色显示，默认启用 (--color 或 -c 选项)。启用颜色支持时，图形显示将 OS 用户时间显示为蓝色，OS 系统时间显示为绿色，空闲时间显示为空白。对于测量负载，蓝色表示执行时间，黄色表示发送时间，红色表示等待发送缓冲区的时间，空白表示空闲时间。图形显示中的百分比是所有非空闲线程的百分比之和。颜色当前不可配置；你可以使用 --skip-color 选项来使用灰度模式。

排序视图 (--sort, -r) 基于测量负载和 OS 报告的负载的最大值。可以使用 --measured-load (-m) 和 --os-load (-o) 选项来启用和禁用这些负载的显示。至少需要启用一个负载的显示。

该程序尝试从具有给定节点 ID 的数据节点获取统计信息，该节点 ID 由 --node-id (-n) 选项指定；如果未指定，则默认为 1。ndb_top 无法提供其他类型节点的信息。

视图调整自身以适应终端窗口的高度和宽度；最小支持的宽度为 76 个字符。

一旦启动，ndb_top 将连续运行，直到被强制退出；您可以使用 Ctrl-C 退出程序。显示每秒更新一次；要设置不同的延迟间隔，请使用 --sleep-time (-s)。

Note

ndb_top 在 macOS、Linux 和 Solaris 上可用。目前不支持 Windows 平台。

以下表格包括 NDB 集群程序 ndb_top 的所有选项。表格后面是详细描述。

表 25.50 使用 ndb_top 程序的命令行选项

Format	Description	Added, Deprecated, or Removed
`--color`, `-c`	以颜色显示 ASCII 图形；使用 --skip-colors 禁用	(在所有基于 MySQL 8.3 的 NDB 发布版本中支持)
`--defaults-extra-file=path`	在全局文件读取后读取给定的文件	(在所有基于 MySQL 8.3 的 NDB 发布版本中支持)
`--defaults-file=path`	仅从给定的文件读取默认选项	(在所有基于 MySQL 8.3 的 NDB 发布版本中支持)
`--defaults-group-suffix=string`	也读取带有 concat(group, suffix) 的组	(在所有基于 MySQL 8.3 的 NDB 发布版本中支持)
`--graph`, `-g`	使用图形显示数据；使用 --skip-graphs 禁用	(在所有基于 MySQL 8.3 的 NDB 发布版本中支持)
`--help`	显示程序使用信息	(在所有基于 MySQL 8.3 的 NDB 发布版本中支持)
`--host=string`, `-h string`	要连接的 MySQL 服务器的主机名或 IP 地址	(在所有基于 MySQL 8.3 的 NDB 发布版本中支持)
`--login-path=path`	从登录文件中读取给定的路径	(在所有基于 MySQL 8.3 的 NDB 发布版本中支持)
`--no-login-paths`	不从登录路径文件中读取登录路径	(在所有基于 MySQL 8.3 的 NDB 发布版本中支持)
`--measured-load`, `-m`	显示每个线程的测量负载	(在所有基于 MySQL 8.3 的 NDB 发布版本中支持)
`--no-defaults`	不从任何选项文件中读取默认选项，除了登录文件	(在所有基于 MySQL 8.3 的 NDB 发布版本中支持)
`--node-id=#`, `-n #`	监视具有该节点 ID 的节点	(在所有基于 MySQL 8.3 的 NDB 发布版本中支持)
`--os-load`, `-o`	按照操作系统测量的负载显示	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--密码=password`, `-p 密码`	使用此密码连接	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--端口=#`, `-P #` (>=7.6.6)	连接到 MySQL 服务器时使用的端口号	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--打印默认值`	打印程序参数列表并退出	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--休眠时间=#`, `-s #`	显示刷新之间的等待时间，以秒为单位	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--套接字=path`, `-S path`	用于连接的套接字文件	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--排序`, `-r`	根据使用情况排序线程；使用 --skip-sort 禁用	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--文本`, `-t` (>=7.6.6)	使用文本显示数据	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--使用情况`	显示程序使用情况信息；与 --help 相同	(在所有基于 MySQL 8.3 的 NDB 版本中支持)
`--用户=name`, `-u name`	以此 MySQL 用户身份连接	(在所有基于 MySQL 8.3 的 NDB 版本中支持)

附加选项

--颜色, -c

Command-Line Format	`--颜色`

以颜色显示 ASCII 图形；使用 --skip-colors 禁用。

--默认值额外文件

Command-Line Format	`--默认值额外文件=path`
Type	字符串
Default Value	`[none]`

在全局文件读取后读取给定的文件。

--默认值文件

Command-Line Format	`--默认值文件=path`
Type	字符串
Default Value	`[none]`

仅从给定的文件读取默认选项。

--默认值组后缀

Command-Line Format	`--默认值组后缀=string`
Type	字符串
Default Value	`[none]`

也读取带有 concat(group, suffix) 的组。

--图形, -g

Command-Line Format	`--图形`

使用图形显示数据；使用 --skip-graphs 禁用。该选项或 --文本 必须为 true；这两个选项可以同时为 true。

--帮助, -?

Command-Line Format	`--帮助`

显示程序使用信息。

--主机[=名称], -h

Command-Line Format	`--主机=字符串`
Type	字符串
Default Value	`localhost`

要连接的 MySQL 服务器的主机名或 IP 地址。

--登录路径

Command-Line Format	`--登录路径=路径`
Type	字符串
Default Value	`[none]`

从登录文件中读取给定的路径。

--不使用登录路径

Command-Line Format	`--不使用登录路径`

跳过从登录路径文件中读取选项。

--测量负载, -m

Command-Line Format	`--测量负载`

显示每个线程的测量负载。此选项或 --操作系统负载 必须为 true；这两个选项可以同时为 true。

--不使用默认值

Command-Line Format	`--不使用默认值`

不从任何选项文件中读取默认值，除了登录文件。

--节点 ID[=#], -n

Command-Line Format	`--节点 ID=#`
Type	整数
Default Value	`1`

监视具有该节点 ID 的数据节点。

--操作系统负载, -o

Command-Line Format	`--操作系统负载`

显示操作系统测量的负载。此选项或 --测量负载 必须为 true；这两个选项可以同时为 true。

--密码[=密码], -p

Command-Line Format	`--密码=密码`
Type	字符串
Default Value	`NULL`

使用指定的密码和 MySQL 用户连接到 MySQL 服务器。

该密码仅与 MySQL 用户账户相关，不与加密的 NDB 备份密码相关。

--端口[=#], -P

Command-Line Format	`--端口=#`
Type	整数
Default Value	`3306`

连接到 MySQL 服务器时使用的端口号。

(以前，该选项的简写形式为 -t，现在是 --文本 的简写形式。)

--打印默认值

Command-Line Format	`--打印默认值`

打印程序参数列表并退出。

--休眠时间[=秒], -s

Command-Line Format	`--休眠时间=#`
Type	整数
Default Value	`1`

在显示刷新之间等待的时间，以秒为单位。

--套接字=路径/文件, -S

Command-Line Format	`--套接字=路径`
Type	路径名称
Default Value	`[none]`

使用指定的套接字文件进行连接。

--sort, -r

Command-Line Format	`--sort`

按使用情况排序线程；使用 --skip-sort 禁用。

--text, -t

Command-Line Format	`--text`

使用文本显示数据。此选项或 --graph 必须为 true；两个选项可以同时为 true。

(在 NDB 集群的早期版本中，该选项的简写形式为 -x，但现在不再支持。)

--usage

Command-Line Format	`--usage`

显示帮助文本并退出；与 --help 相同。

--user[=name], -u

Command-Line Format	`--user=name`
Type	字符串
Default Value	`root`

以该 MySQL 用户身份连接。通常需要使用 --password 选项提供的密码。

示例输出。 下图显示了在 Linux 系统上运行的 ndb_top，该系统上有一个 ndbmtd 数据节点，负载适中。在这里，该程序使用 ndb_top -n8 -x 提供文本和图形输出：

图 25.5 ndb_top 在终端窗口中运行

Display from ndb_top, running in a terminal window. Shows information for each node, including the utilized resources.

ndb_top 还显示了线程的自旋时间，以绿色显示。

PREV HOME UP NEXT