lusotycoon/apache-exporter

Apache Exporter for Prometheus

概述

Apache Exporter for Prometheus是一款用于通过HTTP协议导出Apache服务器mod_status模块统计数据的工具，供Prometheus监控系统采集和分析。该工具兼容Apache 2.2和2.4版本，支持配置监控目标地址、认证信息、日志级别等参数，帮助用户实时掌握Apache服务器的运行状态与性能指标。

核心功能与特性

• 指标导出：导出Apache服务器关键指标，包括访问量、发送流量、CPU负载、工作进程状态等
• 灵活配置：支持自定义监控目标URI（-scrape_uri）、指标暴露地址（-telemetry.address）及路径（-telemetry.endpoint）
• 安全兼容：支持HTTPS协议（可忽略证书验证）及HTTP基本认证（通过URI嵌入凭据）
• 日志可控：可配置日志级别（-log.level），覆盖从debug到panic的各级别日志
• 版本兼容：经过测试兼容Apache 2.2和2.4，适配主流Apache服务器环境

使用场景

适用于需要通过Prometheus监控Apache Web服务器状态的各类场景，包括：

• Web服务器性能监控（如请求量、响应延迟、资源使用率）
• 服务器健康检查（通过apache_up指标判断Apache服务可用性）
• 资源规划（基于CPU负载、工作进程状态优化服务器配置）
• 业务分析（通过访问量、流量等指标分析用户行为）

使用方法

Docker构建

从项目根目录执行以下命令构建Docker镜像：

bash
docker build -t apache_exporter .

Docker运行

基本运行示例

bash
docker run -d -p 9117:9117 docker.xuanyuan.run/apache_exporter \
  -scrape_uri "https://your.server.com/server-status/?auto"

参数说明：

• -p 9117:9117：将容器内默认监控端口（9117）映射到主机，供Prometheus采集指标
• -scrape_uri：指定Apache服务器server-status页面的URL（需包含?auto参数以获取机器可读格式）

带HTTP认证的运行示例

若Apache的server-status页面启用HTTP基本认证，需在scrape_uri中嵌入用户名和密码：

bash
docker run -d -p 9117:9117 docker.xuanyuan.run/apache_exporter \
  -scrape_uri "http://user:password@localhost/server-status?auto"

配置参数说明

指标说明

Apache服务器指标

# HELP apache_accesses_total 当前Apache总访问量 (*)
# TYPE apache_accesses_total counter
# HELP apache_scoreboard Apache记分板状态（工作进程状态分布）
# TYPE apache_scoreboard gauge
# HELP apache_sent_kilobytes_total 当前总发送千字节数 (*)
# TYPE apache_sent_kilobytes_total counter
# HELP apache_cpu_load CPU负载 (*)
# TYPE apache_cpu_load gauge
# HELP apache_up Apache服务器是否可达（1=可达，0=不可达）
# TYPE apache_up gauge
# HELP apache_uptime_seconds_total Apache服务器运行时间（秒） (*)
# TYPE apache_uptime_seconds_total counter
# HELP apache_workers Apache工作进程状态（各状态进程数量）
# TYPE apache_workers gauge

Exporter进程指标

# HELP http_request_duration_microseconds HTTP请求延迟（微秒）
# TYPE http_request_duration_microseconds summary
# HELP http_request_size_bytes HTTP请求大小（字节）
# TYPE http_request_size_bytes summary
# HELP http_response_size_bytes HTTP响应大小（字节）
# TYPE http_response_size_bytes summary
# HELP process_cpu_seconds_total 进程总CPU时间（秒）
# TYPE process_cpu_seconds_total counter
# HELP process_max_fds 最大打开文件描述符数
# TYPE process_max_fds gauge
# HELP process_open_fds 当前打开文件描述符数
# TYPE process_open_fds gauge
# HELP process_resident_memory_bytes 常驻内存大小（字节）
# TYPE process_resident_memory_bytes gauge
# HELP process_start_time_seconds 进程启动时间（Unix时间戳，秒）
# TYPE process_start_time_seconds gauge
# HELP process_virtual_memory_bytes 虚拟内存大小（字节）
# TYPE process_virtual_memory_bytes gauge

注意：标记(*)的指标需在Apache配置中启用ExtendedStatus On才能获取。Apache 2.3.6及以上版本加载mod_status模块时会默认开启ExtendedStatus。

作者

该Exporter最初由https://github.com/neezgee%E5%88%9B%E5%BB%BA%E3%80%82