Prometheus 监控 Nexus 全栈实战从存储容量到组件健康的制品仓库可观测性Nexus Repository Manager 是大多数企业不可或缺的制品仓库托管着 Maven、Docker、npm、PyPI 等海量组件。一旦它的存储空间耗尽、Blob 存储异常、任务失败、GC 停顿或并发请求阻塞整个 CI/CD 流水线和生产部署都可能瘫痪。Nexus 3.19 及以上版本原生内置了 Prometheus 指标端点只需启用便可暴露 JVM、存储、仓库、任务等关键数据。本文将从启用端点、配置抓取到解读指标、创建 Grafana 大屏与告警规则让你像监控应用一样监控制品仓库的每一次呼吸。1. 方案选型内置端点 vs JMX Exporter方案适用版本特点Nexus 内置 Prometheus 端点(推荐)Nexus 3.19官方支持开箱即用暴露存储、Blob 存储、仓库、任务、Jetty 线程池等指标无需额外插件JMX Exporter所有版本通用 Java Agent需手工编写 MBean 规则无法直接获取 Nexus 业务指标如仓库计数、任务状态社区插件 (nexus-prometheus-plugin)3.19 之前已不推荐因内置功能已覆盖明确选择如果使用 Nexus 3.19 及以上版本直接启用内置 Prometheus 端点若为更早版本建议升级或临时使用 JMX Exporter 过渡。本文以Nexus 3.x 内置端点为主线。2. 启用 Nexus 内置 Prometheus 端点2.1 配置 Nexus 暴露指标Nexus 的 Prometheus 端点默认处于关闭状态需要通过配置nexus.properties或环境变量开启。编辑/opt/nexus/etc/nexus-default.properties或nexus.properties添加以下行nexus.metrics.export.prometheus.enabledtrue nexus.metrics.export.prometheus.port9101 nexus.metrics.export.prometheus.path/metrics或者通过环境变量启动dockerrun-d\--namenexus\-p8081:8081\-p9101:9101\-eNEXUS_METRICS_EXPORT_PROMETHEUS_ENABLEDtrue\-eNEXUS_METRICS_EXPORT_PROMETHEUS_PORT9101\sonatype/nexus3:latest重启 Nexus 后访问http://nexus-host:9101/metrics应看到nexus_storage_used_bytes、jvm_memory_used_bytes等指标。2.2 安全与网络隔离生产环境中建议将 Prometheus 端点端口如 9101仅绑定至内网 IP或通过防火墙限制访问来源。若需加密和认证可在 Nexus 前部署 Nginx 反向代理。3. 配置 Prometheus 抓取scrape_configs:-job_name:nexusscrape_interval:30smetrics_path:/metricsstatic_configs:-targets:[nexus-host:9101]labels:env:productioninstance:nexus-prod如果 Nexus 使用了 HTTPS 和自签名证书需配置scheme: https和tls_config。4. 核心监控指标与 PromQLNexus 内置端点暴露的指标涵盖存储、Blob 存储、仓库、任务、Jetty (HTTP)、JVM、系统等类别。4.1 存储与 Blob 存储指标含义nexus_storage_used_bytes各存储Blob 存储已用字节数nexus_storage_total_bytes总容量nexus_blobstore_used_bytes按 Blob 存储名称的已用字节PromQL 示例存储使用率nexus_storage_used_bytes / nexus_storage_total_bytes * 100某个 Blob 存储接近满nexus_blobstore_used_bytes / on(blobstore) nexus_storage_total_bytes 0.854.2 仓库统计指标含义nexus_repository_count仓库数量按类型type标签nexus_repository_component_count组件总数虽然后者可能不直接暴露但有nexus_repository_status等指标。具体指标名可能因版本而异可通过/metrics确认。常见指标如nexus_http_requests_total等。按格式分组示例nexus_repository_count{typedocker}用于观察 Docker 仓库数量。4.3 任务状态指标含义nexus_task_last_run_duration_seconds任务最后一次运行耗时nexus_task_last_run_status状态0成功, 1失败, 2运行中, 3取消 等nexus_task_last_run_timestamp_seconds最后运行时间戳PromQL 示例任务失败nexus_task_last_run_status 1任务运行超时nexus_task_last_run_duration_seconds 3600超过 1 小时4.4 HTTP (Jetty) 指标指标含义jetty_threads_busy忙碌的 Jetty 线程数jetty_threads_max最大线程数jetty_threads_idle空闲线程数http_server_requests_seconds_count/sum(若暴露)HTTP 请求计数与延迟PromQL 示例线程池饱和度jetty_threads_busy / jetty_threads_max活跃请求数jetty_threads_busy4.5 JVM 与系统指标含义jvm_memory_used_bytes{areaheap}/jvm_memory_max_bytes{areaheap}堆内存使用/上限jvm_gc_pause_seconds_count/sumGC 暂停次数与总时间process_cpu_seconds_totalCPU 使用时间process_open_fds打开的文件描述符数PromQL 示例堆使用率jvm_memory_used_bytes{areaheap} / jvm_memory_max_bytes{areaheap} * 100GC 平均暂停rate(jvm_gc_pause_seconds_sum[5m]) / rate(jvm_gc_pause_seconds_count[5m])5. Grafana 仪表盘推荐Nexus Repository Manager DashboardDashboard ID14642社区适配展示存储使用、Blob 存储、仓库统计、任务状态、JVM 堆、HTTP 线程池等。Nexus OSSID11512备选。自定义制品仓库大屏使用 Stat Panel 显示存储使用率Table 展示失败任务Time series 绘制 HTTP 请求延迟和 JVM 内存趋势。导入后选择数据源变量instance对应你的 Nexus 实例。6. 告警规则实战groups:-name:nexus_alertsrules:-alert:NexusDownexpr:up{jobnexus} 0for:1mlabels:severity:criticalannotations:summary:Nexus 实例 {{ $labels.instance }} 不可达-alert:NexusStorageSpaceLowexpr:(nexus_storage_used_bytes / nexus_storage_total_bytes) * 10085for:10mlabels:severity:criticalannotations:summary:Nexus 存储使用率超过 85%当前 {{ $value }}%-alert:NexusTaskFailedexpr:nexus_task_last_run_status 1for:2mlabels:severity:criticalannotations:summary:Nexus 任务 {{ $labels.task }} 执行失败-alert:NexusHighHeapUsageexpr:(jvm_memory_used_bytes{areaheap}/ jvm_memory_max_bytes{areaheap}) * 10085for:10mlabels:severity:warningannotations:summary:Nexus 堆内存使用率超过 85%-alert:NexusThreadPoolSaturationexpr:(jetty_threads_busy / jetty_threads_max)0.8for:10mlabels:severity:warningannotations:summary:Nexus HTTP 线程池使用率超过 80%-alert:NexusBlobStoreFullexpr:(nexus_blobstore_used_bytes / on(blobstore) nexus_storage_total_bytes)0.9for:10mlabels:severity:criticalannotations:summary:Blob 存储 {{ $labels.blobstore }} 使用率超过 90%7. 进阶多实例、安全与旧版本方案7.1 监控多个 Nexus 实例每个 Nexus 实例独立启用 Prometheus 端点Prometheus 中配置多个 target 并用instance标签区分。Grafana 面板通过变量切换。7.2 安全加固确保 Prometheus 端点端口9101仅被 Prometheus 服务器访问使用防火墙或安全组。可在 Nexus 前部署 Nginx对/metrics添加 Basic Auth并在 Prometheus 中配置basic_auth。定期轮换 Nexus 管理员密码尽管指标端点无需认证。7.3 旧版本 Nexus (3.19 之前)如果无法升级可选择部署JMX Exporter。下载jmx_prometheus_javaagent.jar编写规则文件nexus_jmx.yml然后在 Nexus 的 JVM 参数中添加-javaagent:/path/to/jmx_prometheus_javaagent.jar9092:/path/to/nexus_jmx.ymlPrometheus 抓取nexus-host:9092/metrics。规则文件需手动定义感兴趣的 MBean例如org.sonatype.nexus下的指标。这需要一定的手工调试。8. 总结借助 Nexus 3.19 的原生 Prometheus 端点制品仓库的内部状态不再是一团迷雾。从存储容量到任务健康从 Blob 存储到 HTTP 线程池所有关键信号都实时进入 Prometheus在 Grafana 中可视化并通过 Alertmanager 及时告警。将 Nexus 纳入全栈可观测性体系意味着你的 CI/CD 流水线和制品链路的最后一块拼图也被点亮真正实现从代码提交到制品管理的全链路透明。部署它让制品仓库也拥有属于自己的“健康手环”。