如何通过 marklogic 中的管理 API 获取有关 marklogic 服务器中的健康指标（如 DB 健康）的信息？

Question

我想要有关林、应用服务器、主机和集群的健康指标的信息，例如

1. 林的运行状况和磁盘空间警告或警报
2. 应用服务器的健康状况。
3. 日志大小超过时发出警报。
4. 数据库的复制状态。

使用管理 API 或用作 8002 监控端口一部分的 API，因为我们必须基于它创建 Prometheus 端点以将其公开给 grafana。

Answer 1

对于您希望监控的许多内容，Manage API 可用于检索配置和状态，并且您可以检索过滤的日志事件。

Manage /v2/logs 端点并指定regex 以过滤相关日志消息。您可以使用format 参数来检索json、xml、html 或text 格式的信息，以更易于解析和处理的格式为准。

1. 林的运行状况和磁盘空间警告或警报 https://help.marklogic.com/knowledgebase/article/View/49/16/recovering-from-low-disk-space

您可以通过定期扫描故障迹象来寻找故障迹象：

• SVC-FILWRT
• XDMP-合并空间

http://localhost:8002/manage/v2/logs?filename=ErrorLog.txt&format=xml&regex=SVC-FILWRT|XDMP-MERGESPACE

1. 应用服务器的健康状况。

要执行基本的 HealthCheck，您可以 ping 每个 MarkLogic 主机上的 HealthCheck 端口 7997。即 http://localhost:7997。这会让您知道 MarkLogic 进程已在每台主机上启动并运行。

根据您要跟踪应用服务器运行状况的指标，您可以使用Manage /v2/servers 端点来获取请求率、缓存比率等。

http://localhost:8002/manage/LATEST/servers/App-Services?group-id=Default&view=status&format=xml

1. 日志大小超过时发出警报。

没有针对日志大小的可配置警报。他们每天轮换，并有a configurable retention policy。

您可能需要通过其他方式来监控文件系统容量以进行主动监控。

当日志文件被写入与数据文件不同的设备时，可能会出现用于记录的空间不足。这似乎不会影响服务器的启动能力，也不会影响林、数据库或应用服务器的可用性。日志条目仍将根据配置的操作系统日志记录级别写入 /var/log/messages。

但是，如果日志挂载已满且无法写入，则会出现日志事件，您可以通过 Manage /v2/logs 检索，如上所示。

4. 数据库的复制状态。

您是指数据库的状态，它是 DR 集群，还是林 HA 副本？

为了查看集群的状态，请使用Manage /v2/clusters

对于每个数据库，您可以从Manage /v2/databases 获取森林列表

http://localhost:8002/manage/LATEST/databases/Documents?view=status&format=html

并且可以从Manage /v2/forests验证状态

http://localhost:8002/manage/LATEST/forests/Documents?view=status&format=html