ZincSearch服务启动验证

发布时间: 2025-04-08 10:46

↑

# ZincSearch服务启动验证

本文将指导您如何验证ZincSearch服务是否正常运行，并进行基本功能测试。

## 服务启动流程

### 1. 启动服务

```bash
# 直接启动
zinc

# 或使用配置文件启动
zinc --config config.yaml

# 后台运行
nohup zinc > zinc.log 2>&1 &
```

### 2. 验证服务状态

1. 检查进程
```bash
ps aux | grep zinc
```

2. 检查端口
```bash
netstat -tulpn | grep 4080
```

3. 查看日志
```bash
tail -f zinc.log
```

## Web界面验证

1. 访问管理界面
   - 打开浏览器访问：http://localhost:4080
   - 使用管理员账号登录

2. 界面功能检查
   - 仪表板是否正常显示
   - 导航菜单是否可用
   - 系统状态信息是否更新

## API健康检查

1. 健康检查接口
```bash
curl http://localhost:4080/healthz
```
预期返回：`{"status":"ok"}`

2. 版本信息
```bash
curl http://localhost:4080/version
```

3. 节点状态
```bash
curl -u admin:password http://localhost:4080/api/node/stats
```

## 基础功能测试

### 1. 创建索引

```bash
curl -X PUT -H "Content-Type: application/json" -u admin:password \
http://localhost:4080/api/index/test -d '{
  "name": "test",
  "storage_type": "disk",
  "shard_num": 1
}'
```

### 2. 添加文档

```bash
curl -X POST -H "Content-Type: application/json" -u admin:password \
http://localhost:4080/api/test/_doc -d '{
  "title": "测试文档",
  "content": "这是一个测试文档内容"
}'
```

### 3. 搜索测试

```bash
curl -X POST -H "Content-Type: application/json" -u admin:password \
http://localhost:4080/api/test/_search -d '{
  "search_type": "match",
  "query": {
    "term": "测试"
  }
}'
```

## 性能验证

### 1. 资源使用情况

1. CPU使用率
```bash
top -p $(pgrep zinc)
```

2. 内存使用
```bash
ps -o pid,rss,command -p $(pgrep zinc)
```

3. 磁盘使用
```bash
du -sh /path/to/zinc/data
```

### 2. 并发测试

使用Apache Bench进行简单压力测试：

```bash
ab -n 1000 -c 10 -A admin:password http://localhost:4080/healthz
```

## 常见问题排查

### 1. 服务无法启动

检查项：
- 端口是否被占用
- 日志文件权限
- 配置文件格式

### 2. 无法访问Web界面

检查项：
- 防火墙设置
- 网络连接
- 浏览器兼容性

### 3. API调用失败

检查项：
- 认证信息
- 请求格式
- 网络连通性

## 监控指标

### 1. 系统指标

- CPU使用率
- 内存占用
- 磁盘I/O
- 网络流量

### 2. 应用指标

- 查询延迟
- 索引大小
- 文档数量
- 请求成功率

## 安全检查

1. 访问控制
   - 修改默认密码
   - 配置访问权限
   - 启用HTTPS

2. 日志审计
   - 检查访问日志
   - 监控异常请求
   - 设置日志轮转

## 故障处理流程

1. 收集信息
   - 查看错误日志
   - 获取系统状态
   - 记录错误现象

2. 分析问题
   - 确定问题范围
   - 复现问题
   - 定位根因

3. 解决方案
   - 实施修复
   - 验证结果
   - 预防措施

元素码农