Uptime-Kuma 监控公开状态配置指南

在Uptime-Kuma监控系统中，用户有时会遇到无法通过API获取监控数据的问题，特别是当返回结果为N/A时。这种情况通常是由于监控项未被正确配置为公开状态所导致。

问题背景

Uptime-Kuma提供了丰富的API接口，其中/api/badge/:id/uptime/:duration?接口可用于获取指定监控项的可用性数据。但某些监控项返回N/A，经代码检查发现这些监控项未被标记为公开状态。

技术原理

Uptime-Kuma通过数据库中的monitor_group表来管理监控项的公开状态。当监控项被添加到特定组(如状态页组)时，系统会在此表中创建相应记录，从而使其成为公开监控项。

解决方案

官方推荐方法

1. 创建状态页面
2. 将需要公开的监控项添加到状态页面中
3. 系统会自动将这些监控项标记为公开状态

数据库直接操作(高级用法)

对于熟悉数据库操作的技术人员，可以通过直接修改数据库来实现：

INSERT INTO monitor_group (monitor_id, group_id, weight) VALUES (监控ID, 组ID, 权重值);

其中：

• 监控ID：需要公开的监控项ID
• 组ID：状态页面对应的组ID(通常为4)
• 权重值：显示排序权重

注意事项

1. 直接修改数据库存在风险，建议优先使用官方提供的界面操作
2. 修改后需要重启服务使更改生效
3. 确保操作前备份数据库

最佳实践

建议通过Uptime-Kuma的Web界面创建状态页面并添加监控项，这是最安全可靠的方式。只有在特殊情况下才考虑直接操作数据库的方法。

通过正确配置监控项的公开状态，用户可以充分利用Uptime-Kuma提供的API接口获取所需的监控数据，实现更灵活的监控数据集成和应用。