GitLab-Docker环境无法访问Prometheus及metrics端点求助

一、无法访问http://localhost:9090的原因及解决 #

核心原因 #

1. 端口未映射：你的Docker启动命令仅映射了22、80、443端口，Prometheus在容器内默认监听9090端口，但未将该端口映射到宿主机，导致宿主机无法直接访问容器内的9090端口。
2. Prometheus默认仅监听容器内部：GitLab Omnibus自带的Prometheus默认配置为监听127.0.0.1:9090，仅允许容器内部进程访问，即使映射端口，外部请求也会被拒绝。
3. 默认不对外暴露Prometheus：Omnibus GitLab中Prometheus是内部监控组件，默认不会通过GitLab的Nginx反向代理对外提供访问入口。

解决步骤 #

1. 在GITLAB_OMNIBUS_CONFIG中添加Prometheus监听配置，允许外部访问：

   prometheus['listen_address'] = '0.0.0.0:9090';
   

2. 在Docker启动命令的--publish参数中新增端口映射，把容器9090端口暴露到宿主机：

   --publish 9090:9090 \
   

二、无法访问/-/metrics端点的原因 #

/-/metrics是GitLab聚合自身运行指标与系统监控指标的统一端点，核心依赖关系如下：

• 该端点的系统级指标完全由node_exporter提供，未启用node_exporter时，系统指标缺失，部分场景下会导致端点无法正常返回完整内容（甚至无响应）。
• 当你添加node_exporter['enable'] = true配置后，node_exporter启动并采集系统指标，/-/metrics的指标集合变得完整，因此可以正常访问并查看所有指标。

若仅需使用/-/metrics而无需单独访问Prometheus，保持node_exporter['enable'] = true配置即可，无需额外暴露Prometheus端口。

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