forked from niuniu/llm-intelligence
119 lines
2.4 KiB
Markdown
119 lines
2.4 KiB
Markdown
# LLM Intelligence Hub - 运维手册
|
|
|
|
> 版本: v1.1
|
|
> 日期: 2026-05-21
|
|
|
|
---
|
|
|
|
## 服务启停
|
|
|
|
### 启动全部服务
|
|
```bash
|
|
docker-compose up -d --build
|
|
```
|
|
|
|
### 停止服务
|
|
```bash
|
|
docker-compose down
|
|
```
|
|
|
|
### 查看日志
|
|
```bash
|
|
docker-compose logs -f app
|
|
docker-compose logs -f db
|
|
```
|
|
|
|
---
|
|
|
|
## 日常巡检
|
|
|
|
### 应用健康
|
|
```bash
|
|
curl http://localhost:8080/health
|
|
curl http://localhost:8080/api/v1/models
|
|
```
|
|
|
|
### 数据库健康
|
|
```bash
|
|
psql "$DATABASE_URL" -c "SELECT COUNT(*) FROM models WHERE deleted_at IS NULL"
|
|
psql "$DATABASE_URL" -c "SELECT source, success, created_at FROM collector_stats ORDER BY created_at DESC LIMIT 5"
|
|
```
|
|
|
|
### 日报检查
|
|
```bash
|
|
ls -la reports/daily/daily_report_$(date +%Y-%m-%d).md
|
|
```
|
|
|
|
### 磁盘空间
|
|
```bash
|
|
df -h /var/lib/postgresql
|
|
df -h /tmp
|
|
```
|
|
|
|
---
|
|
|
|
## 故障排查
|
|
|
|
### 采集器失败
|
|
1. 检查 API Key: `echo $OPENROUTER_API_KEY`
|
|
2. 检查网络: `curl https://openrouter.ai/api/v1/models`
|
|
3. 查看日志: `tail /tmp/llm_hub_daily_*.log`
|
|
|
|
### 数据库连接失败
|
|
1. 检查 PostgreSQL 状态: `pg_isready`
|
|
2. 检查连接串: `echo $DATABASE_URL`
|
|
3. 检查权限: `psql -c "\du"`
|
|
|
|
### 日报未生成
|
|
1. 检查 cron: `crontab -l | grep llm-intelligence`
|
|
2. 手动执行: `bash scripts/run_daily.sh`
|
|
3. 检查最近日报: `ls reports/daily/*.md | tail -1`
|
|
|
|
### 前端无法访问
|
|
1. 检查应用容器: `docker-compose ps app`
|
|
2. 检查首页响应: `curl -I http://localhost:8080/`
|
|
3. 检查 API 响应: `curl http://localhost:8080/api/v1/models`
|
|
4. 查看应用日志: `docker-compose logs -f app`
|
|
|
|
### 静态资源 404
|
|
1. 重新构建镜像: `docker-compose up -d --build`
|
|
2. 本地校验前端构建: `cd frontend && npm run build`
|
|
3. 确认容器内含有前端产物: `docker-compose exec app ls /app/frontend/dist`
|
|
|
|
---
|
|
|
|
## 备份恢复
|
|
|
|
### 手动备份
|
|
```bash
|
|
bash scripts/backup.sh
|
|
```
|
|
|
|
### 手动恢复
|
|
```bash
|
|
gunzip < backup_file.sql.gz | psql "$DATABASE_URL"
|
|
```
|
|
|
|
### 定时备份
|
|
```bash
|
|
0 2 * * * cd /path/to/llm-intelligence && bash scripts/backup.sh >> /tmp/backup.log 2>&1
|
|
```
|
|
|
|
---
|
|
|
|
## 监控指标
|
|
|
|
| 指标 | 告警阈值 | 检查命令 |
|
|
|------|----------|----------|
|
|
| 模型数 | `< 300` | `SELECT COUNT(*) FROM models` |
|
|
| 采集成功率 | `< 95%` | `SELECT success_rate FROM collector_stats` |
|
|
| 数据库连接 | 失败 | `pg_isready` |
|
|
| 磁盘空间 | `> 80%` | `df -h` |
|
|
|
|
---
|
|
|
|
## 联系信息
|
|
|
|
- 维护者: 宅相
|
|
- 项目路径: `D:\project\llm-intelligence`
|