svenstaro/site24x7_exporter

site24x7_exporter 镜像文档

1. 镜像概述

site24x7_exporter是一个轻量级的Prometheus兼容导出器，专门用于从site24x7.com监控平台获取监控数据并转换为Prometheus可采集的指标格式。site24x7.com是一款提供网站、服务器、云资源等全方位监控服务的平台，该导出器作为数据桥梁，能够将site24x7的监控指标标准化后暴露给Prometheus，帮助用户实现跨平台监控数据的集中管理与可视化分析。

2. 核心功能与特性

• Prometheus兼容输出：将site24x7监控数据转换为Prometheus标准指标格式，支持Prometheus自动发现与数据采集
• site24x7 API集成：通过site24x7官方API获取监控数据，支持多种监控类型（网站、服务器、云服务等）指标导出
• 可配置化采集：支持自定义API请求参数、数据抓取间隔、指标过滤等功能，适应不同监控场景需求
• HTTP指标端点：默认提供/metrics端点，支持Prometheus定期抓取，无需额外插件
• 轻量级部署：基于容器化设计，资源占用低，支持Docker、Docker Compose及Kubernetes等多种部署方式

3. 使用场景与适用范围

• Prometheus监控体系整合：适用于已部署Prometheus作为核心监控系统，需要将site24x7监控数据纳入统一平台的用户
• 多源监控数据聚合：帮助用户整合来自site24x7与其他监控工具（如Prometheus、Grafana）的数据，实现一站式监控视图
• 监控数据二次分析：支持将site24x7数据导入Prometheus后，结合PromQL进行复杂指标查询与告警规则配置
• DevOps监控流程优化：为DevOps团队提供标准化的监控数据接口，简化跨平台监控流程

4. 使用方法与配置说明

4.1 前置条件

• 拥有site24x7.com账户及有效的API密钥（获取路径：site24x7账户 > 设置 > API > 生成API密钥）
• 已安装Docker环境或容器编排平台（如Docker Compose、Kubernetes）
• Prometheus服务已部署并可访问导出器实例

4.2 Docker快速启动

bash
docker run -d \
  --name site24x7-exporter \
  -p 9275:9275 \
  -e API_KEY="your_site24x7_api_key" \
  docker.xuanyuan.run/svenstaro/site24x7_exporter

4.3 Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  site24x7-exporter:
    image: docker.xuanyuan.run/svenstaro/site24x7_exporter
    container_name: site24x7-exporter
    ports:
      - "9275:9275"
    environment:
      - API_KEY=your_site24x7_api_key  # 替换为实际API密钥
      - LISTEN_PORT=9275               # 可选，默认监听端口
      - SCRAPE_INTERVAL=300            # 可选，API数据抓取间隔（秒），默认300
      - LOG_LEVEL=info                 # 可选，日志级别(debug/info/warn/error)
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

4.4 环境变量配置说明

4.5 Prometheus采集配置

在Prometheus配置文件(prometheus.yml)中添加如下采集任务：

yaml
scrape_configs:
  - job_name: 'site24x7'
    scrape_interval: 60s  # 建议与导出器SCRAPE_INTERVAL保持一致
    static_configs:
      - targets: ['site24x7-exporter:9275']  # 替换为导出器实际访问地址

重启Prometheus后，可在Prometheus UI中查询以site24x7_为前缀的监控指标。

5. 注意事项

• API密钥安全：API_KEY为敏感信息，建议通过环境变量注入或使用容器编排平台的密钥管理功能，避免明文存储
• API请求限制：site24x7 API存在请求频率限制，建议根据账户API配额调整SCRAPE_INTERVAL参数，避免触发限制
• 网络连通性：确保导出器容器能够访问site24x7 API端点(https://www.site24x7.com/api)及Prometheus能够访问导出器监听端口
• 指标命名规范：所有导出指标均以site24x7_为前缀，便于Prometheus查询与规则配置

6. 参考链接

• https://github.com/svenstaro/site24x7_exporter
• site24x7 API官方文档
• https://prometheus.io/docs/introduction/overview/