K8s集群中Haproxy开启Prometheus指标与统计页面遇404问题排查

核心原因分析 #

• 缺失http-use-htx配置：HAProxy 2.2+版本中，prometheus-exporter服务和部分stats功能依赖HTX（HTTP Transaction eXtension）模块，未启用http-use-htx会导致路径匹配、服务路由失效，直接返回404。之前遇到的问题大概率是配置冲突而非HTX本身的问题，没必要禁用它。
• 前端配置逻辑失效：未开启HTX时，{ path /metrics }这类路径匹配条件无法正确解析请求路径，导致规则不触发，请求找不到对应路由返回404。

排查步骤 #

1. 验证HTX启用状态：进入HAProxy Pod执行haproxy -vv，查看输出中是否包含HTX字样，无此标识则说明未启用该模块。
2. 排查网络连通性：在Pod内部执行curl localhost:8404/stats，确认是否返回404，排除端口转发的外部网络问题。
3. 查看HAProxy日志：通过kubectl logs <haproxy-pod-name>查看Pod日志，搜索404请求相关条目，确认是否有路径匹配失败的提示信息。

配置优化方案 #

修改HAProxy配置，添加HTX启用项并保留原有前端规则：

# 全局配置中启用HTX
global
  # 保留原有全局配置项
  http-use-htx

frontend stats
  bind *:8404
  http-request use-service prometheus-exporter if { path /metrics }
  stats enable
  stats uri /stats
  stats refresh 10s
  stats admin if LOCALHOST

额外注意事项 #

• 版本适配：haproxy:2.5.8-alpine原生支持HTX，不存在版本兼容问题。
• 端口转发验证：确保端口转发命令正确（kubectl port-forward <haproxy-pod> 8404:8404），转发过程无中断或报错。
• 权限测试：若stats admin规则未生效，可暂时移除if LOCALHOST测试stats页面访问情况，再逐步限制权限。

内容的提问来源于stack exchange，提问作者Branden