Skip to main content
MCPHub 提供三个可观测性入口。MCPHub 没有内置 Prometheus exporter、OpenTelemetry SDK 或告警管线;如需这些能力,请使用外部基础设施工具接入下面的端点。

健康检查端点

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。

另请参阅