如何使用static_status的脚本检查功能实现复杂监控逻辑

如何使用static_status的脚本检查功能实现复杂监控逻辑

【免费下载链接】static_status🚦Bash script to generate a static status page.项目地址: https://gitcode.com/gh_mirrors/st/static_status

static_status是一款功能强大的Bash脚本工具，能够帮助用户快速生成静态状态页面，实现对网站、服务器等服务的监控。通过其灵活的脚本检查功能，用户可以轻松实现复杂的监控逻辑，确保系统的稳定运行。

快速上手：安装与基础配置

要开始使用static_status，首先需要克隆项目仓库。打开终端，执行以下命令：

git clone https://gitcode.com/gh_mirrors/st/static_status

进入项目目录后，你会看到多个关键文件，其中status.sh是主脚本，scripts/check-websites.sh用于网站检查，status_hostname_list.txt和status_website_list.txt则是监控目标配置文件。

核心配置文件介绍

• status_hostname_list.txt：定义需要监控的主机和服务，每行格式为命令;主机名;端口/参数
• status_website_list.txt：纯网站URL列表，用于基础HTTP状态检查
• config-example：配置示例文件，可复制为config进行个性化设置

脚本检查功能详解：从简单到复杂

static_status的脚本检查功能是实现复杂监控逻辑的核心。通过编写自定义脚本，你可以实现远超基础HTTP检查的监控能力。

基础网站检查：check-websites.sh

项目中提供的scripts/check-websites.sh是一个基础的网站监控脚本，其核心代码如下：

WEBSITES=$(cat "$DIR"/../status_website_list.txt) TIMEOUT="10" for WEBSITE in $WEBSITES do /usr/bin/curl --write-out "%{http_code}" --silent --location --head --max-time "$TIMEOUT" "$WEBSITE" --output /dev/null | grep -q "200" || exit 80 done

这个脚本读取status_website_list.txt中的URL列表，使用curl检查每个网站是否返回200状态码。如果任何网站检查失败，脚本将以80状态码退出，这会被主程序识别为"降级"状态。

高级监控：status.sh中的脚本执行逻辑

主脚本status.sh提供了更强大的脚本执行能力。在第922-948行，我们可以看到对"script"类型监控的处理：

elif [[ "$MY_COMMAND" = "script" ]]; then (( MY_HOSTNAME_COUNT++ )) if [[ -x "$MY_STATUS_CONFIG_DIR/$MY_HOSTNAME" ]]; then cmd="$MY_STATUS_CONFIG_DIR/$MY_HOSTNAME" else cmd="$MY_HOSTNAME" fi (timeout --preserve-status "$MY_SCRIPT_TIMEOUT" "$cmd" &> /dev/null) case "$?" in "0") # 状态正常处理逻辑 ;; "80") # 降级状态处理逻辑 ;; *) # 其他错误状态处理逻辑 ;; esac

这段代码允许你在status_hostname_list.txt中定义"script"类型的监控项，指向一个可执行脚本。根据脚本的退出码，static_status会将服务状态分为正常(0)、降级(80)或故障(其他非0值)。

实现复杂监控逻辑的步骤

步骤1：创建自定义监控脚本

首先，在MY_STATUS_CONFIG_DIR目录(默认为~/status)下创建你的监控脚本。例如，创建一个检查数据库连接的脚本check_mysql.sh：

#!/bin/bash # 检查MySQL连接 mysql -h db.example.com -u monitor -psecret -e "SELECT 1" > /dev/null 2>&1 if [ $? -ne 0 ]; then exit 1 # 连接失败，返回故障状态 fi # 检查查询响应时间 response_time=$(mysql -h db.example.com -u monitor -psecret -e "SELECT BENCHMARK(1000000, SHA1('test'))" 2>&1) if [ $(echo "$response_time" | awk '{print $2}') -gt 500 ]; then exit 80 # 响应时间过长，返回降级状态 fi exit 0 # 一切正常

别忘了给脚本添加执行权限：

chmod +x ~/status/check_mysql.sh

步骤2：配置监控项

编辑status_hostname_list.txt，添加你的自定义脚本监控项：

script;check_mysql.sh|MySQL数据库连接检查;

这里的格式是script;脚本路径|显示文本;，"显示文本"会在状态页面中显示，方便识别监控项。

步骤3：运行监控并查看结果

执行主脚本开始监控：

./status.sh

监控结果会生成在MY_STATUS_HTML指定的文件中(默认为~/status_index.html)。打开这个文件，你可以看到类似下面的状态页面：

这个状态页面直观地显示了所有监控项的状态，包括正常运行、降级和故障的服务。

高级技巧：定制化与扩展

利用配置文件自定义监控行为

static_status提供了丰富的配置选项，通过修改config文件，你可以自定义监控超时时间、状态页面标题、图标颜色等。例如：

# 监控超时设置 MY_TIMEOUT="5" MY_PING_TIMEOUT="4" MY_SCRIPT_TIMEOUT="30" # 状态页面自定义 MY_STATUS_TITLE="我的服务监控中心" MY_HOMEPAGE_TITLE="返回首页" # 图标颜色 MY_STATUS_ICON_COLOR_SUCCESS="green" MY_STATUS_ICON_COLOR_WARNING="yellow" MY_STATUS_ICON_COLOR_DANGER="red"

维护模式与自定义消息

当你需要进行系统维护时，可以通过status_maintenance_text.txt文件添加维护消息。只需要在该文件中写入维护信息，状态页面就会显示维护提示，而不是常规的状态警报：

历史事件追踪

static_status会自动记录服务故障历史，你可以在状态页面底部查看过去的事件记录：

这对于分析系统稳定性和故障模式非常有帮助。

常见问题与解决方案

问题1：脚本权限不足

如果你的监控脚本执行失败，可能是权限问题。确保脚本有执行权限，并且运行static_status的用户有足够的权限执行脚本中的命令。

问题2：误报故障

如果出现频繁的误报，可能需要调整超时设置。通过修改MY_TIMEOUT、MY_PING_TIMEOUT或MY_SCRIPT_TIMEOUT参数，增加超时时间，减少网络波动导致的误报。

问题3：状态页面不更新

如果状态页面没有及时更新，检查是否有多个static_status实例在运行，这可能会导致锁文件问题。可以手动删除锁文件：

rm /tmp/STATUS_SH_IS_RUNNING.lock

总结：释放static_status的监控潜力

通过static_status的脚本检查功能，你可以轻松实现从简单到复杂的各种监控逻辑。无论是基础的HTTP状态检查，还是复杂的数据库性能监控，static_status都能满足你的需求。

利用本文介绍的方法，你可以：

• 创建自定义监控脚本，检查任何类型的服务
• 配置多级别状态（正常、降级、故障）
• 自定义状态页面的外观和行为
• 追踪历史事件，分析系统稳定性

开始使用static_status，让你的监控工作变得更加简单高效！

【免费下载链接】static_status🚦Bash script to generate a static status page.项目地址: https://gitcode.com/gh_mirrors/st/static_status