forked from niuniu/llm-intelligence
118 lines
2.1 KiB
Markdown
118 lines
2.1 KiB
Markdown
# LLM Intelligence Hub - 运维手册
|
||
|
||
> 版本: v1.0
|
||
> 日期: 2026-05-10
|
||
> 适用版本: Phase 1
|
||
|
||
---
|
||
|
||
## 服务启停
|
||
|
||
### 启动全部服务
|
||
```bash
|
||
docker-compose up -d
|
||
```
|
||
|
||
### 停止服务
|
||
```bash
|
||
docker-compose down
|
||
```
|
||
|
||
### 查看日志
|
||
```bash
|
||
docker-compose logs -f app
|
||
docker-compose logs -f db
|
||
```
|
||
|
||
---
|
||
|
||
## 日常巡检
|
||
|
||
### 数据库健康
|
||
```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. 检查 Nginx: `docker-compose ps nginx`
|
||
2. 检查 dist: `ls frontend/dist/`
|
||
3. 检查端口: `netstat -tlnp | grep 80`
|
||
|
||
---
|
||
|
||
## 备份恢复
|
||
|
||
### 手动备份
|
||
```bash
|
||
bash scripts/backup.sh
|
||
```
|
||
|
||
### 手动恢复
|
||
```bash
|
||
gunzip < backup_file.sql.gz | psql "$DATABASE_URL"
|
||
```
|
||
|
||
### 定时备份 (cron)
|
||
```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` |
|
||
|
||
---
|
||
|
||
## 扩容指南
|
||
|
||
### 垂直扩容
|
||
增加 PostgreSQL 内存和 CPU。
|
||
|
||
### 水平扩容
|
||
使用读写分离或分片（Phase 2+）。
|
||
|
||
---
|
||
|
||
## 联系信息
|
||
|
||
- 维护者: 宰相
|
||
- 项目路径: /home/long/project/llm-intelligence
|