监控服务器

要监控集群中各个服务器的状态，请使用 SHOW SERVERS 命令。

列出服务器

语法

SHOW SERVERS

返回值

名称 类型 描述

name

字符串

服务器的友好名称，如果未设置名称，则为其 UUID。

address

字符串

服务器的 Bolt 端口地址。可能为 null。

state

字符串

服务器在拓扑中的状态。

health

字符串

服务器的当前可用性。

hosting

List<String>

此服务器当前正在运行的数据库。

state 的可能值

  • Free - 服务器已启动，但尚未添加到集群。需要使用 ENABLE SERVER 添加它。

  • Enabled - 服务器是集群的一部分，可以为其分配数据库。

  • Cordoned - 服务器可能正在托管数据库，但不能再为其分配任何数据库。

  • Deallocating - 服务器正在移除其数据库的过程中。这可能需要一些时间，因为它不会停止其数据库副本（如果处于主模式），直到另一台服务器完全启动其副本，以保留请求的主副本数量。

  • Deallocated - 服务器已完成移除其数据库。

  • Dropped - 服务器已从集群中移除，但进程尚未退出。

health 的可能值

  • Available - 服务器最近与执行 SHOW SERVERS 的集群成员保持联系。

  • Unavailable - 服务器一段时间内没有与集群进行成功的网络通信。

Unavailable 不一定意味着服务器未运行，只是与它的网络连接存在问题。
示例 1. 列出集群中的服务器

在对集群运行 SHOW SERVERS 时，预计输出与以下类似

+------------------------------------------------------------------------------------------------------+
| name                                 | address        | state   | health    | hosting                |
+------------------------------------------------------------------------------------------------------+
|"f4ae1895-26f1-4b93-bd31-6f482be80d3d"|"localhost:7681"|"Enabled"|"Available"|["system","foo","neo4j"]|
|"ffa55a5b-2aca-45fc-be09-2a894067025c"|"localhost:7682"|"Enabled"|"Available"|["system","foo","neo4j"]|
|"server3"                             |"localhost:7683"|"Enabled"|"Available"|["system","neo4j"]      |
+------------------------------------------------------------------------------------------------------+

列出服务器的更多详细信息

如果需要有关服务器的更多详细信息，可以将 SHOW SERVERS 附加 YIELD *。

语法

SHOW SERVERS YIELD *

返回值

名称 类型 描述

serverId

字符串

服务器的 UUID

name

字符串

服务器的友好名称，如果未设置名称，则为其 UUID。

address

字符串

服务器的 Bolt 端口地址。可能为 null。

httpAddress

字符串

服务器的 HTTP 端口地址。可能为 null。

httpsAddress

字符串

服务器的 HTTPS 端口地址。可能为 null。

state

字符串

服务器在拓扑中的状态。

health

字符串

服务器的当前可用性。

hosting

List<String>

此服务器当前正在运行的数据库。

requestedHosting

List<String>

此服务器应该运行的数据库。如果服务器正在安全地停止一个数据库，则可能较少，或者如果服务器正在启动一个数据库，则可能较多。复合数据库目前不会出现在此列表中，但会出现在所有服务器的 hosting 中。

tags

List<String>

应用于此服务器的标签。用于路由策略。

allowedDatabases

List<String>

此服务器上唯一允许的数据库列表。空表示允许所有数据库。

deniedDatabases

List<String>

不允许在此服务器上托管的数据库列表。空表示允许所有数据库。

modeConstraint

字符串

对数据库在此服务器上可以处于哪些模式（即 primary 或 secondary）的限制。

version

字符串

此服务器运行的 Neo4j 版本。

只能设置 allowedDatabases 和 deniedDatabases 之一，因为它们是互斥的。

modeConstraint 的可能值

  • NONE - 任何模式都可以分配到此服务器。

  • PRIMARY - 只能将主模式分配到此服务器。它们可能是数据库写入的目标。

  • SECONDARY - 只能将从模式分配到此服务器。它们永远不会写入数据库，只读。

示例 2. 列出集群中服务器的更多详细信息

在集群中运行 SHOW SERVERS YIELD * 时，预计输出与以下类似

+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| serverId                             | name                                 | address        | httpAddress    | httpsAddress | state   | health    | hosting                | requestedHosting       | tags | allowedDatabases| deniedDatabases| modeConstraint| version        |
+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|"f4ae1895-26f1-4b93-bd31-6f482be80d3d"|"f4ae1895-26f1-4b93-bd31-6f482be80d3d"|"localhost:7681"|"localhost:7471"|null          |"Enabled"|"Available"|["system","foo","neo4j"]|["system","foo","neo4j"]|[]    |[]               |[]              |"NONE"         |"5.0.0-SNAPSHOT"|
|"ffa55a5b-2aca-45fc-be09-2a894067025c"|"ffa55a5b-2aca-45fc-be09-2a894067025c"|"localhost:7682"|"localhost:7472"|null          |"Enabled"|"Available"|["system","foo","neo4j"]|["system","foo","neo4j"]|[]    |[]               |[]              |"NONE"         |"5.0.0-SNAPSHOT"|
|"72bd3d0f-c1d1-4d39-9da7-015f5656e40b"|"server3"                             |"localhost:7683"|"localhost:7473"|null          |"Enabled"|"Available"|["system","neo4j"]      |["system","neo4j"]      |[]    |[]               |[]              |"NONE"         |"5.0.0-SNAPSHOT"|
+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+