vinkdong/timing

Timing Request

镜像概述

Timing是一个轻量级工具，用于发送定时HTTP请求，支持灵活配置请求参数、时间规则及监控功能，适用于API可用性检查、定期数据上报等场景。

核心功能

• 配置HTTP请求：支持设置URL、请求方法、请求体等参数
• 定时规则：可指定时间范围（UTC时间）和运行间隔
• 自动重载：配置文件变更时自动生效
• 监控支持：通过Prometheus收集请求指标（实验性）
• 模板支持：请求URI和body中可使用Go模板动态生成内容

使用场景

• 定时检查API服务的可用性
• 定期向第三方服务发送数据
• 监控接口的响应时间和成功率
• 自动化测试中的定时请求任务

配置说明

配置文件采用YAML格式，关键参数说明如下：

• url：目标请求地址
• method：HTTP请求方法（如GET、POST）
• body：请求体（支持多个body轮流发送）
• range：请求时间范围（UTC时间），支持hour/minute等维度及gt/lt等条件（多条件为AND关系）
• run_every：请求间隔，支持seconds/minutes等单位（多条件为AND关系）
• log_response：是否记录响应体
• 多请求实体：用---分隔多个配置项

示例配置文件参考：https://github.com/VinkDong/TimingRequest/blob/master/config.yaml

部署示例

Docker Run

基础使用

bash
docker run -v /local/path/config.yaml:/app/config.yaml vinkdong/timing --conf /app/config.yaml

启用Prometheus监控

bash
docker run -v /local/path/config.yaml:/app/config.yaml -p 9800:9800 vinkdong/timing --conf /app/config.yaml --enable_metrics --addr :9800

Prometheus配置

在Prometheus的scrape_configs中添加：

yaml
- job_name: 'TimingRequest'
  static_configs:
  - targets: ['your-container-ip:9800']