Nightingale Apache 监控集成实战Categraf 采集配置、指标解读与告警规则全解【免费下载链接】nightingaleNightingale is to monitoring and alerting what Grafana is to visualization.项目地址: https://gitcode.com/GitHub_Trending/ni/nightingaleNightingale 将 Apache 等组件的监控能力以「集成Integration」的形式内置在仓库中每个集成目录同时承载采集配置、告警规则与多语言说明文档。本文以integrations/Apache下的官方配置示例markdown/README.en_US.md为核心讲解如何通过 Categraf 采集 Apachemod_status状态页指标、理解各采集参数的语义、解读上报的 Prometheus 指标并直接复用仓库内置的 5 条告警规则完成从采集到告警的闭环。读完本文你将能独立完成 Apache 实例的接入、验证与告警治理。Apache 集成在 Nightingale 仓库中的形态在 integrations/Apache 目录下集成以四类文件组织collect/apache/apache.tomlCategraf 采集器的配置样例即本文主体alerts/apache_by_categraf.json随集成附带的告警规则Prometheus 数据源格式i18n/en_US.json告警规则名称与排查建议的英文翻译markdown/README.en_US.md、markdown/README.md面向用户与面向 AI 检索的说明文档。这套「目录即组件、文件即权威」的组织方式并非摆设。从源码 aiagent/tools/integrations_loader.go 可以看到Nightingale 的 AI Agent 会把integrations/下每个组件的markdown/README.md与collect/*/*.toml扫描进文档索引README 生成[integration-doc]条目TOML 配置生成[integration-config]条目LLM 通过search_n9e_docs检索时能直接命中真实的[[instances]]写法。也就是说本文讲解的这份配置不仅是人工参考手册也是 AI 助手回答「如何采集 Apache」时的权威依据见 scanIntegrationComponent 的读取逻辑。前置准备开启 Apache 状态页采集器拉取的是 Apache 自带的server-status状态页机器可读格式为?auto因此接入前必须先确保目标 Apache 已启用mod_status并开放该页面IfModule mod_status_module ExtendedStatus On Location /server-status SetHandler server-status Require local /Location /IfModule要点说明ExtendedStatus On是必须的只有开启后状态页才会输出请求速率、总流量、每个 worker 状态等扩展字段采集器才能拿到完整指标生产环境建议先仅允许本机访问Require local再由 Categraf 从采集机拉取避免状态页暴露公网配置完成后需重载 Apache如systemctl reload httpd或apachectl graceful然后用curl http://127.0.0.1/server-status?auto验证返回的是Scoreboard、BusyWorkers等键值对文本而非 HTML 页面。采集配置详解[[instances]]各参数完整配置样例位于 collect/apache/apache.toml与文档 markdown/README.en_US.md 完全一致[[instances]] # https://statuslist.app/apache/apache-status-page-simple-setup-guide/ # scrape_uri http://localhost/server-status/?auto # host_override # insecure false # custom_headers {} # log_level info所有参数默认处于注释状态按需取消注释即可。参数语义如下参数类型默认值作用说明scrape_uristringhttp://localhost/server-status/?auto状态页抓取地址必须带?auto以获得机器可读输出跨机采集时改为实际地址如http://10.0.0.5/server-status/?autohost_overridestring空覆盖 HTTP 请求中的Host头适用于虚拟主机vhost场景或经反代访问时固定 Host 的场景insecureboolfalse访问 HTTPS 状态页时是否跳过 TLS 证书校验内网自签证书可设为true公网环境不建议custom_headersmap{}自定义附加请求头如custom_headers { Authorization Bearer xxx }用于状态页前置了认证的场景log_levelstringinfo采集器日志级别可按debug/info/warn/error调整排障时临时调为debug可看到请求细节结合参数命名与告警规则中实际用到的指标可以推断采集器通过 HTTP GETscrape_uri解析状态页文本并将up实例可达性、worker 数、scoreboard 状态、请求计数、累计耗时、uptime 等字段转换为 Prometheus 指标。若状态页被Require指令或防火墙拦截采集会失败apache_up 0指标会持续为 0触发下文的第一条告警。在 Categraf 中本文件应放置到采集器的配置目录如conf/input.apache/apache.toml[[instances]]表示一个采集实例可重复定义多个实例以采集多台 Apache 或同一台机器的多个 vhost。指标解读采集器上报了什么虽然文档没有逐条列出指标清单但仓库内置告警规则 alerts/apache_by_categraf.json 中的 PromQL 完整暴露了采集器实际上报的核心指标可作为指标命名与含义的权威依据指标含义出现位置PromQL 用法apache_up实例可达性1 为正常、0 为抓取失败apache_up 0apache_workers按状态区分的 worker 数量state标签取值如idle、busyapache_workers{stateidle}、apache_workers{statebusy}apache_scoreboardscoreboard 各槽位计数的总和含 open_slot 等用作总容量分母sum without (state) (apache_scoreboard)apache_accesses_total累计处理的请求总数Counterrate(apache_accesses_total[5m])apache_duration_ms_total累计请求处理耗时毫秒Counterrate(apache_duration_ms_total[5m])apache_uptime_seconds_total进程累计运行秒数apache_uptime_seconds_total 300其中apache_accesses_total与apache_duration_ms_total的rate比值即为平均单请求耗时可直接用于延迟类告警apache_workers{statebusy}与apache_scoreboard的比值则是进程池饱和度的直观度量。开箱即用的告警规则仓库为 Apache 集成预置了 5 条 Prometheus 告警规则默认disabled状态导入后按需启用即可。以下 PromQL、严重级别与处置建议均来自 apache_by_categraf.json 与 i18n/en_US.json。1. Apache 实例不可达severity 1PromQLapache_up 0附加标签alertnameApacheDown处置思路先systemctl status httpd或apache2确认 master 进程是否存活进程存活则用curl -s http://127.0.0.1/server-status?auto验证状态页是否被Require指令或防火墙挡住进程不在则先httpd -t校验配置再启动并查看 error_log 尾部定位退出原因常见为端口占用、证书过期、模块加载失败最后确认上游负载均衡已摘除该节点。2. Apache 空闲工作进程耗尽severity 1PromQLapache_workers{stateidle} 0附加标签alertnameApacheNoIdleWorker当所有 worker 都被占用、无空闲槽位时触发。处置时用curl -s http://127.0.0.1/server-status?auto查看 Scoreboard确认 worker 卡在哪个状态卡在W正在发送响应说明后端慢卡在R读请求说明客户端慢应急可调大MaxRequestWorkers与ServerLimit并 graceful 重载但必须同步核算内存每 worker 内存 × 并发数不能超过物理内存若被慢客户端拖住可启用mod_reqtimeout并调小KeepAliveTimeout。3. Apache 工作进程使用率过高severity 2PromQLsum without (state) (apache_workers{statebusy}) / sum without (state) (apache_scoreboard) * 100 85附加标签alertnameApacheWorkerSaturation进程池持续高水位时触发。先用curl对比BusyWorkers与 scoreboard 中open_slot的余量再用tail -n 10000 access_log | awk统计 TOP URL 与耗时区分是流量自然增长还是某个接口变慢占住 worker流量增长则扩容实例或调大MaxRequestWorkers按内存重算ServerLimit接口变慢则优先修后端并对该 URL 配置mod_reqtimeout或限流。4. Apache 平均请求处理耗时过长severity 2PromQLrate(apache_duration_ms_total[5m]) / (rate(apache_accesses_total[5m]) 0) 1000附加标签alertnameApacheSlowRequest平均请求耗时超过 1000ms 时触发。先确认 access_log 的LogFormat已带%D微秒耗时执行awk {print $NF, $7} access_log | sort -rn | head -20找出最慢 URL慢在动态请求则排查后端PHP-FPM slowlog、应用日志、数据库慢查询慢在静态资源则检查磁盘 IO 与 sendfile/缓存配置排查期间可对该 URL 临时加mod_ratelimit或降级。5. Apache 近期发生过重启severity 3PromQLapache_uptime_seconds_total 300附加标签alertnameApacheRecentlyRestarted进程运行不足 300 秒时提示可能异常重启。先确认是否为计划内发布非计划则执行journalctl -u httpd --since -30min与tail -200 error_log判断是 segfault、OOM 还是配置错误OOM 杀掉的可dmesg -T | grep -i killed process确认并按实际内存下调MaxRequestWorkers反复崩溃时保留 core dumpCoreDumpDirectory并逐个禁用第三方模块二分定位。接入与验证流程完整接入链路可概括为四步开状态页按上文在 Apache 配置中启用mod_status与ExtendedStatus Onreload 后用curl http://127.0.0.1/server-status?auto自测配采集将 apache.toml 放入 Categraf 的conf/input.apache/目录取消注释并填写scrape_uri跨机采集时替换为实际地址必要时按上表配置insecure、custom_headers等参数验证指标重启 Categraf 后在 Nightingale 查询apache_up、apache_workers、apache_scoreboard等指标确认数值与server-status?auto页面对应启用告警导入 apache_by_categraf.json 中的规则配置通知渠道与接收人将默认disabled状态改为启用。小结Apache 集成是 Nightingale「集成目录 配置 告警 文档」范式的典型样本[[instances]]配置示例界定了采集入口与可调参数告警规则 JSON 则沉淀了apache_up、apache_workers、apache_scoreboard、apache_accesses_total、apache_duration_ms_total、apache_uptime_seconds_total等核心指标的实战 PromQL 与排障手册。无论是人工配置还是经由 AI Agent 检索 integrations_loader.go 建立的文档索引这套集成都能让 Apache 的监控接入保持「配置可复制、告警可落地、语义可检索」。【免费下载链接】nightingaleNightingale is to monitoring and alerting what Grafana is to visualization.项目地址: https://gitcode.com/GitHub_Trending/ni/nightingale创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/15 22:29:00 · 阅读 1.2k Nightingale Apache 监控集成实战：Categraf 采集配置、指标解读与告警规则全解
Nightingale Apache 监控集成实战Categraf 采集配置、指标解读与告警规则全解【免费下载链接】nightingaleNightingale is to monitoring and alerting what Grafana is to visualization.项目地址: https://gitcode.com/GitHub_Trending/ni/nightingaleNightingale 将 Apache 等组件的监控能力以「集成Integration」的形式内置在仓库中每个集成目录同时承载采集配置、告警规则与多语言说明文档。本文以integrations/Apache下的官方配置示例markdown/README.en_US.md为核心讲解如何通过 Categraf 采集 Apachemod_status状态页指标、理解各采集参数的语义、解读上报的 Prometheus 指标并直接复用仓库内置的 5 条告警规则完成从采集到告警的闭环。读完本文你将能独立完成 Apache 实例的接入、验证与告警治理。Apache 集成在 Nightingale 仓库中的形态在 integrations/Apache 目录下集成以四类文件组织collect/apache/apache.tomlCategraf 采集器的配置样例即本文主体alerts/apache_by_categraf.json随集成附带的告警规则Prometheus 数据源格式i18n/en_US.json告警规则名称与排查建议的英文翻译markdown/README.en_US.md、markdown/README.md面向用户与面向 AI 检索的说明文档。这套「目录即组件、文件即权威」的组织方式并非摆设。从源码 aiagent/tools/integrations_loader.go 可以看到Nightingale 的 AI Agent 会把integrations/下每个组件的markdown/README.md与collect/*/*.toml扫描进文档索引README 生成[integration-doc]条目TOML 配置生成[integration-config]条目LLM 通过search_n9e_docs检索时能直接命中真实的[[instances]]写法。也就是说本文讲解的这份配置不仅是人工参考手册也是 AI 助手回答「如何采集 Apache」时的权威依据见 scanIntegrationComponent 的读取逻辑。前置准备开启 Apache 状态页采集器拉取的是 Apache 自带的server-status状态页机器可读格式为?auto因此接入前必须先确保目标 Apache 已启用mod_status并开放该页面IfModule mod_status_module ExtendedStatus On Location /server-status SetHandler server-status Require local /Location /IfModule要点说明ExtendedStatus On是必须的只有开启后状态页才会输出请求速率、总流量、每个 worker 状态等扩展字段采集器才能拿到完整指标生产环境建议先仅允许本机访问Require local再由 Categraf 从采集机拉取避免状态页暴露公网配置完成后需重载 Apache如systemctl reload httpd或apachectl graceful然后用curl http://127.0.0.1/server-status?auto验证返回的是Scoreboard、BusyWorkers等键值对文本而非 HTML 页面。采集配置详解[[instances]]各参数完整配置样例位于 collect/apache/apache.toml与文档 markdown/README.en_US.md 完全一致[[instances]] # https://statuslist.app/apache/apache-status-page-simple-setup-guide/ # scrape_uri http://localhost/server-status/?auto # host_override # insecure false # custom_headers {} # log_level info所有参数默认处于注释状态按需取消注释即可。参数语义如下参数类型默认值作用说明scrape_uristringhttp://localhost/server-status/?auto状态页抓取地址必须带?auto以获得机器可读输出跨机采集时改为实际地址如http://10.0.0.5/server-status/?autohost_overridestring空覆盖 HTTP 请求中的Host头适用于虚拟主机vhost场景或经反代访问时固定 Host 的场景insecureboolfalse访问 HTTPS 状态页时是否跳过 TLS 证书校验内网自签证书可设为true公网环境不建议custom_headersmap{}自定义附加请求头如custom_headers { Authorization Bearer xxx }用于状态页前置了认证的场景log_levelstringinfo采集器日志级别可按debug/info/warn/error调整排障时临时调为debug可看到请求细节结合参数命名与告警规则中实际用到的指标可以推断采集器通过 HTTP GETscrape_uri解析状态页文本并将up实例可达性、worker 数、scoreboard 状态、请求计数、累计耗时、uptime 等字段转换为 Prometheus 指标。若状态页被Require指令或防火墙拦截采集会失败apache_up 0指标会持续为 0触发下文的第一条告警。在 Categraf 中本文件应放置到采集器的配置目录如conf/input.apache/apache.toml[[instances]]表示一个采集实例可重复定义多个实例以采集多台 Apache 或同一台机器的多个 vhost。指标解读采集器上报了什么虽然文档没有逐条列出指标清单但仓库内置告警规则 alerts/apache_by_categraf.json 中的 PromQL 完整暴露了采集器实际上报的核心指标可作为指标命名与含义的权威依据指标含义出现位置PromQL 用法apache_up实例可达性1 为正常、0 为抓取失败apache_up 0apache_workers按状态区分的 worker 数量state标签取值如idle、busyapache_workers{stateidle}、apache_workers{statebusy}apache_scoreboardscoreboard 各槽位计数的总和含 open_slot 等用作总容量分母sum without (state) (apache_scoreboard)apache_accesses_total累计处理的请求总数Counterrate(apache_accesses_total[5m])apache_duration_ms_total累计请求处理耗时毫秒Counterrate(apache_duration_ms_total[5m])apache_uptime_seconds_total进程累计运行秒数apache_uptime_seconds_total 300其中apache_accesses_total与apache_duration_ms_total的rate比值即为平均单请求耗时可直接用于延迟类告警apache_workers{statebusy}与apache_scoreboard的比值则是进程池饱和度的直观度量。开箱即用的告警规则仓库为 Apache 集成预置了 5 条 Prometheus 告警规则默认disabled状态导入后按需启用即可。以下 PromQL、严重级别与处置建议均来自 apache_by_categraf.json 与 i18n/en_US.json。1. Apache 实例不可达severity 1PromQLapache_up 0附加标签alertnameApacheDown处置思路先systemctl status httpd或apache2确认 master 进程是否存活进程存活则用curl -s http://127.0.0.1/server-status?auto验证状态页是否被Require指令或防火墙挡住进程不在则先httpd -t校验配置再启动并查看 error_log 尾部定位退出原因常见为端口占用、证书过期、模块加载失败最后确认上游负载均衡已摘除该节点。2. Apache 空闲工作进程耗尽severity 1PromQLapache_workers{stateidle} 0附加标签alertnameApacheNoIdleWorker当所有 worker 都被占用、无空闲槽位时触发。处置时用curl -s http://127.0.0.1/server-status?auto查看 Scoreboard确认 worker 卡在哪个状态卡在W正在发送响应说明后端慢卡在R读请求说明客户端慢应急可调大MaxRequestWorkers与ServerLimit并 graceful 重载但必须同步核算内存每 worker 内存 × 并发数不能超过物理内存若被慢客户端拖住可启用mod_reqtimeout并调小KeepAliveTimeout。3. Apache 工作进程使用率过高severity 2PromQLsum without (state) (apache_workers{statebusy}) / sum without (state) (apache_scoreboard) * 100 85附加标签alertnameApacheWorkerSaturation进程池持续高水位时触发。先用curl对比BusyWorkers与 scoreboard 中open_slot的余量再用tail -n 10000 access_log | awk统计 TOP URL 与耗时区分是流量自然增长还是某个接口变慢占住 worker流量增长则扩容实例或调大MaxRequestWorkers按内存重算ServerLimit接口变慢则优先修后端并对该 URL 配置mod_reqtimeout或限流。4. Apache 平均请求处理耗时过长severity 2PromQLrate(apache_duration_ms_total[5m]) / (rate(apache_accesses_total[5m]) 0) 1000附加标签alertnameApacheSlowRequest平均请求耗时超过 1000ms 时触发。先确认 access_log 的LogFormat已带%D微秒耗时执行awk {print $NF, $7} access_log | sort -rn | head -20找出最慢 URL慢在动态请求则排查后端PHP-FPM slowlog、应用日志、数据库慢查询慢在静态资源则检查磁盘 IO 与 sendfile/缓存配置排查期间可对该 URL 临时加mod_ratelimit或降级。5. Apache 近期发生过重启severity 3PromQLapache_uptime_seconds_total 300附加标签alertnameApacheRecentlyRestarted进程运行不足 300 秒时提示可能异常重启。先确认是否为计划内发布非计划则执行journalctl -u httpd --since -30min与tail -200 error_log判断是 segfault、OOM 还是配置错误OOM 杀掉的可dmesg -T | grep -i killed process确认并按实际内存下调MaxRequestWorkers反复崩溃时保留 core dumpCoreDumpDirectory并逐个禁用第三方模块二分定位。接入与验证流程完整接入链路可概括为四步开状态页按上文在 Apache 配置中启用mod_status与ExtendedStatus Onreload 后用curl http://127.0.0.1/server-status?auto自测配采集将 apache.toml 放入 Categraf 的conf/input.apache/目录取消注释并填写scrape_uri跨机采集时替换为实际地址必要时按上表配置insecure、custom_headers等参数验证指标重启 Categraf 后在 Nightingale 查询apache_up、apache_workers、apache_scoreboard等指标确认数值与server-status?auto页面对应启用告警导入 apache_by_categraf.json 中的规则配置通知渠道与接收人将默认disabled状态改为启用。小结Apache 集成是 Nightingale「集成目录 配置 告警 文档」范式的典型样本[[instances]]配置示例界定了采集入口与可调参数告警规则 JSON 则沉淀了apache_up、apache_workers、apache_scoreboard、apache_accesses_total、apache_duration_ms_total、apache_uptime_seconds_total等核心指标的实战 PromQL 与排障手册。无论是人工配置还是经由 AI Agent 检索 integrations_loader.go 建立的文档索引这套集成都能让 Apache 的监控接入保持「配置可复制、告警可落地、语义可检索」。【免费下载链接】nightingaleNightingale is to monitoring and alerting what Grafana is to visualization.项目地址: https://gitcode.com/GitHub_Trending/ni/nightingale创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考