77 lines
3.4 KiB
Markdown
77 lines
3.4 KiB
Markdown
# 6.17 服务器监控
|
||
|
||
:::tip 概述
|
||
服务器监控是无表模块：单接口聚合返回运行时、内存、磁盘、数据库连通、缓存模式与调度器健康。磁盘读取按平台分文件实现（windows/other build tags）。路由 GET /api/server/info（登录即可）。
|
||
:::
|
||
|
||
## 接口
|
||
|
||
```text
|
||
GET /api/server/info 登录即可，log "服务器监控-查询信息"
|
||
权限：无 permission 节点（登录即可）
|
||
```
|
||
|
||
## 返回结构（ServerInfoRes）
|
||
|
||
```text
|
||
Server hostname / goVersion / arch / numCPU / goroutines / uptime
|
||
（procStart 为包加载时刻）
|
||
Mem allocMB / totalAllocMB / sysMB / heapAllocMB / heapSysMB /
|
||
heapObjects / gccycles（runtime.ReadMemStats，MB 保留两位小数）
|
||
Disk 平台分支实现：
|
||
windows（//go:build windows）：GetDiskFreeSpaceEx 读工作目录所在盘符
|
||
（wd[:3] 如 "E:\"），返回 totalGB/freeGB/usedPercent
|
||
other（!windows）：syscall.Statfs
|
||
Db SELECT VERSION() 计时（pingMs）+ 版本号；
|
||
数据库不通不视为整体失败（版本留空，err 置 nil 返回）
|
||
Cache cache.UsingMemory() → {mode:"memory", connected:false}
|
||
否则 Redis PING → {mode:"redis", connected:true/false}
|
||
Scheduler 调度器健康：统计 gcron 中 "job:" 前缀条目数（mounted）与
|
||
goframe_job status=1 计数（expected）；enabled=DaemonInit 已执行；
|
||
healthy = mounted >= expected（挂载失败或数据被外部改动会出现差值）
|
||
```
|
||
|
||
## 平台分支实现（文件组织示例）
|
||
|
||
```text
|
||
internal/logic/server_monitor.go 公共组装
|
||
internal/logic/server_monitor_windows.go //go:build windows —— GetDiskFreeSpaceEx
|
||
internal/logic/server_monitor_other.go //go:build !windows —— syscall.Statfs
|
||
|
||
Go build tags 实现"同函数名、按平台选实现"——编译期裁剪，零运行时分支
|
||
```
|
||
|
||
## 调度器健康判定（运维关键）
|
||
|
||
```text
|
||
mounted = gcron 中 "job:" 前缀条目数（实际挂载）
|
||
expected = goframe_job status=1 计数（应该挂载）
|
||
healthy = mounted >= expected
|
||
|
||
差值排查：
|
||
mounted < expected 部分任务挂载失败（cron 表达式无效？）
|
||
或任务数据被外部改动（直接改库没走 API）
|
||
mounted > expected 摘除遗漏（API 路径应先摘除再处理）
|
||
注意口径：daemonStatus.running 是 gcron 全部条目数（含 CleanTemp 等非任务条目），
|
||
Scheduler.mounted 只统计 "job:" 前缀——两处口径不同
|
||
```
|
||
|
||
## 运维用法
|
||
|
||
```text
|
||
日常巡检：GET /api/server/info 一眼看全（CPU 核数/内存/磁盘余量/DB/缓存/调度）
|
||
磁盘告警阈值：usedPercent > 85% 关注
|
||
内存观察：heapObjects 持续增长 + gccycles 低 → 疑似泄漏
|
||
调度异常：healthy=false → 逐条核对任务 cron 与 status
|
||
```
|
||
|
||
## 排障
|
||
|
||
| 症状 | 原因 |
|
||
|------|------|
|
||
| Disk 数据异常 | windows 读的是工作目录所在盘符（wd[:3]）——服务在哪个盘就读哪个盘 |
|
||
| Db 版本为空 | 数据库不通（不视为整体失败的设计）；查 database 配置 |
|
||
| Cache mode=memory | Redis 不可用已降级（限流/锁/黑名单退化单机语义） |
|
||
| Scheduler healthy=false | 见上方差值排查；对照 /api/job/daemonStatus |
|
||
| uptime 很长但内存高 | procStart 是包加载时刻——优雅重启才会重置 |
|