如何检查Windows上OpenELM部署状态

在 Windows 上检查 OpenELM 部署状态
一、先确认部署形态

• 明确你的运行方式，不同方式对应的检查命令不同：
• 作为 Windows 服务 运行（常见服务名示例：openelm）。
• 作为 Python 模块/脚本 运行（如 python -m openelm 或 python app.py）。
• 在 Docker Desktop for Windows 容器中运行（镜像名含 openelm）。
• 在 WSL（Windows Subsystem for Linux） 中运行（本质为 Linux 进程）。

二、通用快速检查清单

• 服务状态（若注册为服务）
• PowerShell（管理员）：Get-Service -Name openelm；或使用 sc query openelm。
• 进程与资源
• 任务管理器：详细信息中查找 python.exe、uvicorn/gunicorn、或你的启动脚本名；观察 CPU/内存 占用。
• PowerShell：Get-Process | Where-Object { $_.ProcessName -like '*python*' -or $_.Name -eq 'openelm' }；资源监视器（resmon）定位句柄与线程。
• 端口与连通性
• 查找监听端口：netstat -ano | findstr ":8000"（示例端口）；或 Get-NetTCPConnection -LocalPort 8000。
• 连通性测试：Test-NetConnection 127.0.0.1 -Port 8000；远程时用目标 IP。
• 日志与控制台输出
• 服务日志：事件查看器（eventvwr.msc）→ Windows 日志 → 应用程序，筛选来源为你的服务或 Python。
• 应用日志：查看你配置的日志文件路径（如 logs/ 目录下的 .log），或使用 Get-Content -Path "C:pathtoapp.log" -Tail 50 -Wait 实时跟踪。
• 依赖与健康检查
• 数据库/缓存：是否能连接（例如：Test-NetConnection db-host -Port 5432；或 redis-cli ping）。
• 模型与权重：确认模型文件路径存在且可读（Test-Path "C:modelsopenelmmodel.safetensors"）。
• API 自检：浏览器或 PowerShell 访问 /health 或 /docs（如：Invoke-RestMethod http://127.0.0.1:8000/health）。

三、按部署方式执行对照检查

四、常见症状与定位路径

• 端口未监听
• 可能未启动或启动失败；确认启动命令与 host/port 配置；检查端口是否被占用（netstat -ano）。
• 服务启动失败
• 事件查看器查看“应用程序”日志中的错误；检查工作目录、虚拟环境、依赖安装（pip show 包名）、配置文件路径。
• API 访问异常
• 本机测试（127.0.0.1）与远程测试（主机 IP）区分防火墙/安全组；确认路由与反向代理（如 nginx）配置正确。
• GPU/加速不可用
• 执行 nvidia-smi（若使用 NVIDIA GPU）确认驱动与 CUDA 可用；在 Python 中检查 torch.cuda.is_available()。

五、一键诊断脚本示例（PowerShell）

• 将以下脚本保存为 Check-OpenELM.ps1，按需修改服务名、端口与日志路径后运行（管理员 PowerShell）：

# 参数
$ServiceName = "openelm"
$Port       = 8000
$LogPath    = "C:\logs\app.log"
Write-Host "=== OpenELM 部署状态检查 ===" -ForegroundColor Cyan
# 1) 服务状态
$svc = Get-Service -Name $ServiceName -ErrorAction SilentlyContinue
if ($svc) {
Write-Host "[服务] $($svc.Status) (启动类型: $($svc.StartType))" -ForegroundColor $(if ($svc.Status -eq 'Running') { 'Green' } else { 'Yellow' })
} else {
Write-Host "[服务] 未找到服务: $ServiceName" -ForegroundColor Red
}
# 2) 进程
$procs = Get-Process | Where-Object { $_.ProcessName -like '*python*' -or $_.Name -eq $ServiceName }
if ($procs) {
$procs | Select-Object Id, ProcessName, CPU, WorkingSet | Format-Table -AutoSize
} else {
Write-Host "[进程] 未找到相关 Python/服务进程" -ForegroundColor Red
}
# 3) 端口
$tcp = Get-NetTCPConnection -LocalPort $Port -ErrorAction SilentlyContinue
if ($tcp) {
Write-Host "[端口] $Port 已被 PID $($tcp.OwningProcess) 占用" -ForegroundColor Green
} else {
Write-Host "[端口] $Port 未被监听" -ForegroundColor Red
}
# 4) 本地连通性
$conn = Test-NetConnection -ComputerName 127.0.0.1 -Port $Port
Write-Host "[连通] 127.0.0.1:$Port -> $($conn.TcpTestSucceeded)" -ForegroundColor $(if ($conn.TcpTestSucceeded) { 'Green' } else { 'Red' })
# 5) 日志尾部
if (Test-Path $LogPath) {
Write-Host "[日志] 最近 20 行：" -ForegroundColor Cyan
Get-Content -Path $LogPath -Tail 20
} else {
Write-Host "[日志] 未找到日志文件: $LogPath" -ForegroundColor Yellow
}

• 如需在 WSL 中检查，可在 WSL 终端执行：
• ps aux | grep openelm
• ss -tuln | grep 8000
• tail -f /var/log/openelm.log 或 journalctl -u openelm -f（若以 systemd 托管）

提示：若你采用 Docker 或 WSL，优先在对应环境中执行相应命令；Windows 服务与 Python 脚本的检查互不冲突，可并行使用以交叉验证。