tpimages/sitest

sitest

Prometheus exporter工具，用于测试HTTP/HTTPS网站。

概述

Sitest（由web-sites + test组合而来）是一款简单的网站检测工具。它通过访问指定URL，生成包含响应码、响应时间、页面大小、页面哈希等指标的数据，并以Prometheus格式暴露这些指标，可用于触发网站宕机、内容变更或响应缓慢等场景的告警。

配置

监听地址和配置文件路径可通过命令行参数修改：

Usage of sitest:
  -config_file string
        配置文件路径（默认值："./sitest.yaml"）
  -listen_addr string
        监听地址（默认值："0.0.0.0:8080"）

需监控的URL及参数存储在YAML配置文件中，格式如下：

yaml
# 每个站点的默认配置
default:
  interval: 1m  # 测试频率

# 站点列表及自定义配置
sites:
  "https://golang.org":
    interval: 15s  # 自定义测试频率
  "https://api.myip.com/": {}  # 使用默认配置

运行

Docker部署

镜像不包含配置文件，需挂载本地配置目录：

bash
$ docker run -v `pwd`/config:/etc/sitest tpimages/sitest:latest

2018/01/01 11:11:11 配置已加载：
2018/01/01 11:11:11 - 站点：http://example.com/ 参数：{1m0s}
2018/01/01 11:11:11 - 站点：https://golang.org 参数：{15s}
2018/01/01 11:11:11 - 站点：https://api.myip.com/ 参数：{1m0s}
2018/01/01 11:11:11 开始查询站点...
2018/01/01 11:11:11 [https://golang.org] 延迟启动，休眠14s
2018/01/01 11:11:11 [http://example.com/] 延迟启动，休眠36s
2018/01/01 11:11:11 [https://api.myip.com/] 延迟启动，休眠39s
2018/01/01 11:11:25 [https://golang.org] 查询中...
2018/01/01 11:11:25 [https://golang.org] 成功，结果：{StatusCode:200 Length:8099 Duration:423.640439ms Hash:13824383691894627592}

Kubernetes部署

通过./kubernetes-manifests目录下的清单部署：

bash
kubectl apply -f ./kubernetes-manifests

该目录包含ServiceMonitor清单，用于K8s Prometheus抓取指标。

暴露的指标列表

指标示例：

# HELP sitest_code 响应码
# TYPE sitest_code gauge
sitest_code{site="[***]"} 200
sitest_code{site="[***]"} 200
sitest_code{site="https://golang.org"} 200
# HELP sitest_count 执行检查的总次数
# TYPE sitest_count counter
sitest_count{site="[***]"} 1
sitest_count{site="[***]"} 1
sitest_count{site="https://golang.org"} 6
# HELP sitest_duration_seconds 请求持续时间直方图
# TYPE sitest_duration_seconds histogram
sitest_duration_seconds_bucket{site="[***]",le="0.005"} 0
sitest_duration_seconds_bucket{site="[***]",le="0.01"} 0
sitest_duration_seconds_bucket{site="[***]",le="0.025"} 0
sitest_duration_seconds_bucket{site="[***]",le="0.05"} 0
sitest_duration_seconds_bucket{site="[***]",le="0.1"} 0
sitest_duration_seconds_bucket{site="[***]",le="0.25"} 0
sitest_duration_seconds_bucket{site="[***]",le="0.5"} 1
sitest_duration_seconds_bucket{site="[***]",le="1"} 1
sitest_duration_seconds_bucket{site="[***]",le="2.5"} 1
sitest_duration_seconds_bucket{site="[***]",le="5"} 1
sitest_duration_seconds_bucket{site="[***]",le="10"} 1
sitest_duration_seconds_bucket{site="[***]",le="+Inf"} 1
sitest_duration_seconds_sum{site="[***]"} 0.294034706
sitest_duration_seconds_count{site="[***]"} 1
# HELP sitest_hash 页面哈希
# TYPE sitest_hash gauge
sitest_hash{site="[***]"} 2.2135241933328225e+18
# HELP sitest_length 页面长度
# TYPE sitest_length