ClearerVoice-StudioWeb服务高可用：Supervisor自动重启+健康检查配置-开发者社区

ClearerVoice-StudioWeb服务高可用：Supervisor自动重启+健康检查配置

1. 产品概述

ClearerVoice-Studio 是一款语音处理全流程的一体化开源工具包，提供开箱即用的语音处理能力。该工具包集成了FRCRN、MossFormer2等成熟预训练模型，用户无需从零训练即可直接进行语音处理推理。

主要技术特点包括：

多采样率适配：支持16KHz/48KHz输出，满足电话、会议、直播等不同场景的音频需求
一体化处理流程：从语音增强到说话人提取的全套解决方案
高性能推理：基于PyTorch框架优化，充分利用GPU加速

2. 高可用架构设计

2.1 为什么需要高可用

语音处理服务通常需要长时间稳定运行，但在实际生产环境中可能遇到以下问题：

服务进程意外崩溃
内存泄漏导致服务不可用
资源耗尽导致服务无响应
网络波动导致服务中断

2.2 Supervisor解决方案

Supervisor是一个进程控制系统，可以：

监控服务进程状态
自动重启崩溃的服务
管理服务日志
提供统一的管理接口

3. Supervisor配置详解

3.1 安装Supervisor

在Ubuntu系统上安装Supervisor：

sudo apt-get update sudo apt-get install supervisor

验证安装是否成功：

supervisord --version

3.2 服务配置文件

创建ClearerVoice-Studio的Supervisor配置文件：

sudo nano /etc/supervisor/conf.d/clearervoice.conf

配置文件内容示例：

[program:clearervoice-streamlit] command=/root/miniconda3/envs/ClearerVoice-Studio/bin/streamlit run /root/ClearerVoice-Studio/clearvoice/streamlit_app.py --server.port=8501 directory=/root/ClearerVoice-Studio user=root autostart=true autorestart=true startsecs=10 startretries=3 stopwaitsecs=60 stdout_logfile=/var/log/supervisor/clearervoice-stdout.log stdout_logfile_maxbytes=50MB stdout_logfile_backups=10 stderr_logfile=/var/log/supervisor/clearervoice-stderr.log stderr_logfile_maxbytes=50MB stderr_logfile_backups=10 environment=PYTHONUNBUFFERED="1"

3.3 关键配置参数说明

参数	说明	推荐值
command	服务启动命令	完整conda环境路径+启动命令
autostart	随Supervisor自动启动	true
autorestart	自动重启	true
startsecs	启动等待时间	10
startretries	启动重试次数	3
stopwaitsecs	停止等待时间	60
stdout_logfile	标准输出日志路径	/var/log/supervisor/xxx.log
stderr_logfile	错误日志路径	/var/log/supervisor/xxx.log

4. 健康检查机制

4.1 基础健康检查配置

在Supervisor配置中添加健康检查：

[program:clearervoice-streamlit] ... ; 健康检查配置 healthcheck=curl -f http://localhost:8501/_stcore/health healthcheck_timeout=10 healthcheck_interval=60 healthcheck_retries=3

4.2 自定义健康检查脚本

创建更复杂的健康检查脚本：

sudo nano /root/ClearerVoice-Studio/healthcheck.sh

脚本内容：

#!/bin/bash # 检查服务端口是否监听 if ! netstat -tuln | grep -q ':8501'; then exit 1 fi # 检查API响应 response=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:8501/_stcore/health) if [ "$response" -ne 200 ]; then exit 1 fi # 检查GPU内存使用情况 gpu_mem=$(nvidia-smi --query-gpu=memory.used --format=csv,noheader,nounits) if [ "$gpu_mem" -gt 8000 ]; then exit 1 fi exit 0

更新Supervisor配置使用自定义脚本：

[program:clearervoice-streamlit] ... healthcheck=/root/ClearerVoice-Studio/healthcheck.sh healthcheck_timeout=30 healthcheck_interval=120

5. 服务管理实践

5.1 常用管理命令

# 重新加载配置 sudo supervisorctl reread sudo supervisorctl update # 查看服务状态 sudo supervisorctl status # 启动服务 sudo supervisorctl start clearervoice-streamlit # 重启服务 sudo supervisorctl restart clearervoice-streamlit # 停止服务 sudo supervisorctl stop clearervoice-streamlit # 查看日志 sudo tail -f /var/log/supervisor/clearervoice-stdout.log

5.2 日志轮转配置

创建日志轮转配置文件：

sudo nano /etc/logrotate.d/clearervoice

配置内容：

/var/log/supervisor/clearervoice-*.log { daily missingok rotate 30 compress delaycompress notifempty create 0640 root root sharedscripts postrotate /usr/bin/supervisorctl restart clearervoice-streamlit >/dev/null 2>&1 || true endscript }

6. 高级监控与告警

6.1 Prometheus监控集成

配置Prometheus exporter监控Supervisor状态：

sudo apt-get install prometheus-supervisor-exporter

配置Supervisor exporter：

[inet_http_server] port=127.0.0.1:9001

Prometheus配置示例：

scrape_configs: - job_name: 'supervisor' static_configs: - targets: ['localhost:9101']

6.2 告警规则配置

示例告警规则：

groups: - name: clearervoice-alerts rules: - alert: ClearerVoiceServiceDown expr: supervisor_process_status{name="clearervoice-streamlit"} != 20 for: 5m labels: severity: critical annotations: summary: "ClearerVoice service is down" description: "The ClearerVoice service has been down for more than 5 minutes"