solsson/prometheus-exporter-apache

Apache Exporter for Prometheus

镜像概述

该镜像包含Prometheus的Apache Exporter工具，用于从Apache服务器的mod_status页面获取统计数据，并通过HTTP接口暴露给Prometheus采集，帮助用户监控Apache的运行状态和性能指标。

核心功能

1. 导出Apache关键指标：访问总量、发送字节数、CPU负载、工作进程状态、服务器可达性、运行时间等；
2. 支持对受HTTP基本认证保护的server-status页面进行采集；
3. 可配置指标暴露的地址和端口；
4. 支持日志级别和格式自定义；
5. 兼容Apache 2.2和2.4版本。

使用场景

1. 生产环境中Apache服务器的实时性能监控；
2. 多实例Apache集群的状态跟踪与故障排查；
3. 结合Prometheus和Grafana构建可视化监控仪表盘；
4. 长期性能数据分析，优化Apache配置。

配置说明

主要命令行参数：

• --telemetry.address: 暴露指标的地址（默认：:9117）；
• --telemetry.endpoint: 指标暴露的路径（默认：/metrics）；
• --scrape_uri: Apache server-status页面的URI（默认：http://localhost/server-status/?auto）；
• --host_override: 覆盖HTTP请求的Host头（为空则不覆盖）；
• --insecure: 忽略HTTPS证书验证（当scrape_uri为HTTPS时使用）；
• --log.level: 日志级别（可选值：debug/info/warn/error/fatal，默认：info）；
• --log.format: 日志格式（默认：logger:stderr）。

Docker部署示例

构建镜像

bash
# 从项目根目录执行
docker build -t apache_exporter .

运行容器

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

带HTTP认证的采集示例

若server-status页面受认证保护，可在scrape_uri中加入凭据：

bash
docker run -d -p 9117:9117 apache_exporter \
  --scrape_uri="http://user:password@your-apache-server.com/server-status/?auto"

常见问题（FAQ）

1. 是否有对应的Grafana仪表盘？
   有第三方仪表盘可用：Grafana Dashboard 3894。

2. 如何计算请求率、字节率等指标？
   可通过PromQL从原始指标推导：

   • 请求率：rate(apache_accesses_total[5m])
   • 字节率：rate(apache_sent_kilobytes_total[5m])
   • 每请求字节数：rate(apache_sent_kilobytes_total[5m]) / rate(apache_accesses_total[5m])

3. 能否监控多个Apache实例？
   按照Prometheus最佳实践，每个Apache实例应对应一个Exporter，建议通过自动化工具（如Ansible、Kubernetes）批量部署。

4. apache_up指标为0怎么办？
   这表示Exporter无法连接到Apache：

   • 检查Apache是否启用了mod_status并配置了server-status路径；
   • 验证从Exporter容器能否访问scrape_uri；
   • 查看Exporter日志排查错误。