服务器监控插件

插件功能

此功能由 Empostor.Plugins.Monitor 插件（gg.empostor.monitor）提供。需要安装并启用该插件才能使用。

概述

服务器监控插件提供用于监控服务器健康状态和状态的 HTTP API 端点。这些端点适用于外部监控工具、负载均衡器和自定义仪表板。

端点

GET /api/monitor/status

返回详细的服务器状态，包括运行时间、资源使用情况和活跃游戏列表。

响应：

{
  "status": "running",
  "timestamp": "2026-05-23T12:00:00.0000000Z",
  "uptime_seconds": 86400,
  "uptime_display": "1d 0h 0m",
  "version": "1.0.0",
  "runtime": ".NET 8.0.0",
  "platform": "Linux 5.15.0",
  "processors": 4,
  "memory_mb": 256,
  "game_count": 3,
  "player_count": 22,
  "active_connections": 30,
  "games": [
    {
      "code": "ABCDEF",
      "state": "Started",
      "map": "Skeld",
      "player_count": 10,
      "host": "PlayerName"
    }
  ]
}

字段	类型	说明
status	string	服务器正常时始终为 "running"
timestamp	string	ISO 8601 UTC 时间戳
uptime_seconds	number	服务器进程启动以来的秒数
uptime_display	string	人类可读的运行时间
version	string	服务器版本
runtime	string	.NET 运行时描述
platform	string	操作系统描述
processors	number	CPU 核心数
memory_mb	number	工作集内存（MB）
game_count	number	活跃游戏总数
player_count	number	当前在游戏中的玩家数
active_connections	number	总连接数
games	array	活跃游戏详情

GET /api/monitor/health

用于负载均衡器和监控工具的简单健康检查。

响应：

{
  "status": "healthy",
  "timestamp": "2026-05-23T12:00:00.0000000Z"
}

服务器健康时返回 HTTP 200。

配置

此插件无需配置。