健康检查端点
GET /health —— 公开访问,无需认证。
status 的取值如下:
因此,
/health 适合用于存活和就绪探针。详见 src/controllers/healthController.ts。
进程内日志
MCPHub 维护一个滚动的进程内存日志缓冲区(src/services/logService.ts),供控制台的日志查看器使用。
日志流会为每个事件发送一行
data:,并包含初始的 { "type": "initial", "logs": [...] } 快照。以上三个端点都要求已认证的管理员权限(控制台 JWT、accessType: all 的 bearer key、OAuth token 或 Better Auth session)。
该缓冲区只存在于当前进程。在多实例部署中,请将 stdout 发送到日志聚合器,不要依赖此端点。
活动日志(数据库模式)
当 MCPHub 使用 PostgreSQL 运行时(参见数据库配置),每个 MCP 请求和响应都会由src/services/activityLoggingService.ts 持久化到 mcphub_activity 表。控制台通过以下端点提供访问:
在文件模式下,这些端点返回
404,控制台也会隐藏活动页面。
进程级指标
控制台通过getServerConnectionStats() 展示基础的服务器连接统计信息,该信息也嵌入在 /health 响应中。如需导出更丰富的进程指标,可以:
- 使用能够自动包装
http/express的 Node.js APM agent。 - 或从监控平台抓取
/health和/api/activities/stats。
另请参阅
Prometheus 指标
设置ENABLE_METRICS=true 启用根路径 GET /metrics,不受 BASE_PATH 影响;默认关闭并返回 404。设置 METRICS_TOKEN 后,抓取请求必须携带 Authorization: Bearer <token>。这是独立的监控凭据,不使用 Dashboard 或 MCP bearer key。启用后如未设置 token,端点可公开访问;多租户部署应设置 token 或限制监控网络访问。
MCP、Dashboard 和 OpenAPI 工具 API 共用埋点。内部重试不会重复计数;异常和
isError 返回均视为失败。未解析到上游的调用(包括搜索、描述元工具及凭据准备失败)使用 server="unknown"。工具处理器执行前的 HTTP 鉴权拒绝不计入工具调用。首版不增加 group、用户、会话、工具名、原始错误标签或错误分类,也不提供 OTel exporter。
指标不依赖数据库或活动日志。每个进程独立计数,重启归零;多副本部署应分别抓取。服务器和会话 Gauge 在抓取时刷新,不触发上游连接。已删除服务器的历史时间序列保留到重启,避免持续创建不同的服务器名称。Prometheus 抓取配置示例见英文页面。