Statsig Status Page故障排查：常见问题与解决方案

Statsig Status Page故障排查：常见问题与解决方案

【免费下载链接】statuspageA simple, zero-dependency, pure js/html status page based on GitHub Pages and Actions.项目地址: https://gitcode.com/gh_mirrors/sta/statuspage

Statsig Status Page是一个基于GitHub Pages和Actions构建的轻量级状态监控工具，无需依赖第三方服务，通过纯JavaScript和HTML实现服务健康状态的可视化展示。本文将帮助您快速定位并解决使用过程中可能遇到的常见问题，确保状态监控系统稳定运行。

🔍 状态页面无数据显示的快速修复

当您访问状态页面时发现没有任何服务状态数据显示，可按以下步骤排查：

1. 检查日志目录结构
   确保项目根目录下存在logs文件夹，且具有正确的读写权限。健康检查脚本health-check.sh会自动创建该目录并存储监控日志，若目录缺失或权限不足，将导致数据无法记录。

2. 验证urls.cfg配置
   确认urls.cfg文件格式正确，每行需遵循服务名称=URL的格式，例如：

   statsig=https://www.statsig.com google=https://google.com

   错误的格式（如缺少等号、空格或特殊字符）会导致监控脚本无法解析目标服务。

3. 查看GitHub Actions运行状态
   登录您的GitHub仓库，进入Actions标签页检查健康检查工作流是否正常执行。若工作流失败，可点击具体任务查看错误日志，常见原因为网络连接问题或脚本执行权限不足。

⚠️ 服务状态显示异常的解决方案

状态页面显示的服务状态与实际情况不符时，可从以下方面入手解决：

服务误报"Major Outage"（严重故障）

若服务实际正常但状态页面显示为严重故障，可能是由于：

• 健康检查阈值设置问题
  查看index.js第49-51行的状态判断逻辑：

  return uptimeVal < 0.3 ? "failure" : "partial";

  这里将成功率低于30%判定为严重故障，您可根据实际需求调整该阈值。

• 网络请求超时配置
  health-check.sh第37行使用curl命令检查服务状态，默认无超时设置。若目标服务响应较慢，可添加--connect-timeout参数：

  response=$(curl --connect-timeout 10 --write-out '%{http_code}' --silent --output /dev/null $url)

状态历史数据不完整

状态页面默认显示最近30天的监控数据（index.js第1行const maxDays = 30），若需要展示更长周期的数据，可修改该值并调整日志轮转策略。同时检查health-check.sh第53行的日志截断设置：

echo "$(tail -2000 logs/${key}_report.log)" > "logs/${key}_report.log"

增大tail命令的行数参数可保留更多历史记录。

🛠️ 自动化监控不执行的修复方法

健康检查脚本未按预期自动运行时，可执行以下检查：

1. 确认GitHub Actions配置
   确保仓库中存在.github/workflows目录及正确配置的工作流文件，该文件应包含类似以下的触发条件：

   on: schedule: - cron: '*/30 * * * *' # 每30分钟执行一次

2. 检查脚本执行权限
   运行以下命令确保健康检查脚本具有可执行权限：

   chmod +x health-check.sh

3. 验证Git配置
   health-check.sh第62-63行设置了Git提交用户信息，若出现提交失败，需确保GitHub Actions runner具有仓库的推送权限，或修改为您自己的用户信息：

   git config --global user.name 'Your Name' git config --global user.email 'your.email@example.com'

📊 自定义状态页面的实用技巧

除了解决故障，您还可以通过以下方式优化状态页面：

• 调整状态显示颜色
  修改index.js第44-52行的getColor函数，自定义不同状态的显示颜色，例如将部分故障颜色改为橙色：

  return uptimeVal < 0.3 ? "failure" // 红色 : "partial"; // 橙色

• 添加新的监控服务
  只需在urls.cfg文件中添加新的服务条目，健康检查脚本会自动开始监控并在页面上显示。

• 修改检查频率
  调整GitHub Actions工作流的cron表达式，可更改监控频率。例如，将*/30 * * * *改为*/15 * * * *可提高检查频率至每15分钟一次。

通过以上方法，您可以快速解决Statsig Status Page的常见问题，并根据实际需求自定义监控行为。如果遇到本文未覆盖的问题，建议查看项目的日志文件（位于logs目录下）获取详细错误信息，或检查health-check.sh和index.js的源码了解更多实现细节。

【免费下载链接】statuspageA simple, zero-dependency, pure js/html status page based on GitHub Pages and Actions.项目地址: https://gitcode.com/gh_mirrors/sta/statuspage