自动化模型部署解决方案：3步搞定AI应用开发环境搭建
2026/7/28 11:01:42
unsee常见问题解答：新手必知的15个故障排除技巧
【免费下载链接】unseeAlert dashboard for Prometheus Alertmanager项目地址: https://gitcode.com/gh_mirrors/un/unsee
unsee是Prometheus Alertmanager的告警仪表盘工具，帮助用户集中管理和可视化来自Alertmanager的告警信息。本文整理了新手使用unsee时最常见的15个问题及解决方案，助你快速解决使用过程中遇到的各类故障。
一、安装与启动问题
1. 如何正确克隆unsee仓库？
要获取unsee源码，需使用以下命令克隆仓库：
git clone https://gitcode.com/gh_mirrors/un/unsee2. 启动时报"配置文件未找到"错误怎么办？
unsee默认会在当前目录查找unsee.yaml配置文件。若出现此错误，可通过以下方式解决：
- 指定配置文件路径：
unsee --config.file=example --config.dir=./docs/ - 检查配置文件名称是否正确，确保没有拼写错误
- 参考docs/CONFIGURATION.md了解配置文件格式要求
3. 启动后无法访问Web界面（端口问题）
unsee默认使用端口8080。若无法访问，可通过以下方式排查：
- 检查端口是否被占用：
netstat -tuln | grep 8080 - 使用自定义端口启动：
make PORT=5000 run - 检查防火墙设置，确保端口已开放
二、Alertmanager连接问题
4. "Alertmanager连接超时"错误处理
当unsee无法连接到Alertmanager时，可尝试以下解决方案：
- 检查Alertmanager URI是否正确配置
- 增加超时时间：在配置文件中设置
timeout: 30s或使用命令行参数--alertmanager.timeout 30s - 验证网络连通性：
curl <Alertmanager地址>/api/v1/alerts
5. TLS证书验证失败问题
若连接Alertmanager时出现TLS相关错误：
- 在配置文件中指定CA证书路径：
tls:ca: /path/to/ca.crt - 如不需要TLS验证（仅测试环境），可禁用证书验证（不推荐生产环境）
- 检查证书是否过期或配置是否正确
6. 多Alertmanager实例配置后部分实例不可用
配置多个Alertmanager实例后，若部分实例显示错误：
- 检查每个实例的URI和超时设置是否正确
- 查看unsee日志，确认具体错误信息
- 确保网络能够访问所有Alertmanager实例
三、界面与功能问题
unsee告警仪表盘界面展示了多个Alertmanager实例的告警信息，包括不同集群的内存使用率、主机宕机等告警
7. 界面不显示任何告警怎么办？
当unsee界面没有显示任何告警时：
- 检查Alertmanager是否有告警产生：访问
<Alertmanager地址>/api/v1/alerts - 确认unsee配置中的Alertmanager地址正确
- 检查过滤器设置，是否有过滤条件导致告警不显示
- 查看unsee日志，检查是否有错误信息
8. 自动刷新功能不工作
unsee默认启用自动刷新功能。若自动刷新不工作：
- 检查界面右上角的自动刷新开关是否已开启
- 在配置中设置默认刷新间隔：
filters: default: ["refresh=60"] - 检查浏览器控制台是否有JavaScript错误
9. 无法创建或解除静默规则
当创建或解除静默规则失败时：
- 检查网络连接，确保unsee能正常访问Alertmanager
- 检查静默规则的时间范围是否合理（开始时间不能晚于结束时间）
- 查看界面错误提示，通常会显示具体的错误原因
- 确认Alertmanager是否支持静默功能（需要Alertmanager v0.14+）
四、配置问题
10. 如何自定义告警标签的显示？
unsee允许自定义告警标签的显示方式：
- 在配置文件中设置要保留的标签：
labels: keep: ["instance", "job"] - 设置要移除的标签：
labels: strip: ["alertname"] - 配置标签颜色：
labels: color: unique: ["instance"] - 详细配置方法可参考docs/example.yaml
11. 如何设置默认过滤器？
要设置默认过滤器，可在配置文件中添加：
filters: default: ["cluster=prod", "status=active"]这样用户打开unsee时会自动应用这些过滤条件。
12. 如何配置JIRA集成？
unsee支持JIRA集成，可在配置文件中添加：
jira: - regexp: "JIRA-(\\d+)" url: "https://yourcompany.atlassian.net/browse/JIRA-$1"这样告警中的JIRA编号会自动转换为链接。
五、高级故障排除
13. 查看unsee详细日志
当遇到复杂问题时，可通过以下方式获取详细日志：
- 设置日志级别为debug：
--log.level=debug - 查看配置日志：
--log.config=true（默认启用） - 日志会显示配置加载过程、Alertmanager连接状态等信息
14. 前端错误排查
unsee前端问题可通过浏览器开发者工具排查：
- 检查控制台(Console)是否有JavaScript错误
- 查看网络(Network)请求，确认API调用是否成功
- 若启用了Sentry，错误会自动上报，可在界面底部查看错误信息
15. 性能问题处理
当unsee界面加载缓慢或卡顿：
- 减少同时显示的告警数量：使用过滤器限制显示范围
- 增加服务器资源：unsee是CPU密集型应用，可适当增加CPU资源
- 优化Alertmanager性能：确保Alertmanager本身性能良好
- 调整刷新间隔：增加刷新间隔可减轻服务器负担
总结
通过本文介绍的15个故障排除技巧，大多数unsee使用问题都能得到解决。如果遇到本文未涵盖的问题，建议查阅docs/CONFIGURATION.md官方文档，或在项目仓库提交issue获取帮助。unsee作为Prometheus Alertmanager的重要可视化工具，掌握其故障排除方法将极大提高监控告警的处理效率。
【免费下载链接】unseeAlert dashboard for Prometheus Alertmanager项目地址: https://gitcode.com/gh_mirrors/un/unsee
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考