bitnamicharts/prometheus

Bitnami Prometheus Helm Chart

镜像概述和主要用途

Prometheus 是一款开源的监控和告警系统，能够通过配置的目标定期采集指标，帮助系统管理员监控基础设施。Bitnami 提供的 Prometheus Helm Chart 经过精心设计和维护，可快速、简便地在 Kubernetes 集群中部署 Prometheus，适用于开发和生产环境的容器化应用监控需求。

Prometheus 官方概述

商标说明：本软件列表由 Bitnami 打包。所提及的商标分别归各自公司所有，使用这些商标并不意味着任何关联或认可。

核心功能和特性

• 指标采集：支持从配置的目标以指定间隔采集监控指标
• 告警管理：集成 Alertmanager 实现告警规则配置和通知分发
• 灵活集成：可与 Thanos、Grafana Mimir、Grafana 等工具无缝集成
• 资源优化：支持自定义资源请求与限制，适配不同负载需求
• 持久化存储：支持 PV 存储，确保监控数据持久化
• 安全强化：遵循容器安全最佳实践，后续将迁移至 Bitnami Secure Images
• Kubernetes 原生：支持 Kubernetes 服务发现、Pod 亲和性/反亲和性配置

使用场景和适用范围

适用场景

• Kubernetes 集群基础设施监控
• 微服务应用性能指标采集与分析
• 自定义业务指标监控与告警
• 与 Grafana 结合构建可视化监控面板
• 与 Thanos 集成实现长期指标存储和查询

适用范围

• 开发环境：适合使用社区版“latest”标签镜像进行开发测试
• 生产环境：建议采用 Bitnami Secure Images（提供硬化容器、CVE 透明度、SBOM 和企业支持）

前提条件

• Kubernetes 1.23+
• Helm 3.8.0+
• 底层基础设施支持 PV 供应
• 支持 ReadWriteMany 卷（用于部署扩展）

详细使用方法和配置说明

快速安装（TL;DR）

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/prometheus

注意：生产环境建议使用 VMware Tanzu Application Catalog（Bitnami 商业版目录）。

安装步骤

使用发布名称 my-release 安装 Chart：

console
helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/prometheus

注意：需替换占位符 REGISTRY_NAME 和 REPOSITORY_NAME。例如，Bitnami 官方仓库需使用 REGISTRY_NAME=registry-1.docker.io 和 REPOSITORY_NAME=bitnamicharts。

默认配置将在 Kubernetes 集群中部署 Prometheus。可通过 参数 部分配置自定义选项。

提示：使用 helm list 查看所有发布。

配置详情

资源请求与限制

Bitnami Charts 允许为部署中的所有容器设置资源请求和限制，通过 resources 参数配置。生产环境必须设置资源请求，并根据实际需求调整。

可通过 resourcesPreset 参数应用预设资源配置（详见 https://github.com/bitnami/charts/blob/main/bitnami/common/templates/_resources.tpl#L15%EF%BC%89%EF%BC%8C%E4%BD%86%E7%94%9F%E4%BA%A7%E7%8E%AF%E5%A2%83%E4%B8%8D%E5%BB%BA%E8%AE%AE%E4%BE%9D%E8%B5%96%E9%A2%84%E8%AE%BE%EF%BC%8C%E9%9C%80%E6%A0%B9%E6%8D%AE%E5%85%B7%E4%BD%93%E8%B4%9F%E8%BD%BD%E8%87%AA%E5%AE%9A%E4%B9%89%E3%80%82%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E5%8F%82%E8%A7%81 Kubernetes 容器资源管理文档。

滚动标签与不可变标签

生产环境强烈建议使用不可变标签，避免因标签更新导致部署自动变更。Bitnami 会在主容器更新、重大变更或存在严重漏洞时发布新 Chart 更新容器镜像。

部署额外资源

可通过 extraDeploy 参数部署额外 Kubernetes 对象（如 ConfigMap、Deployment 等），需提供完整对象规格。

备份与恢复

使用 Velero（Kubernetes 备份/恢复工具）备份源部署的持久卷，并将其附加到新部署。详见 Velero 使用指南。

Pod 亲和性配置

可通过 XXX.affinity 参数设置自定义亲和性，或使用 https://github.com/bitnami/charts/tree/main/bitnami/common#affinities Chart 提供的预设配置（XXX.podAffinityPreset、XXX.podAntiAffinityPreset、XXX.nodeAffinityPreset）。

集成示例

与 Thanos 集成

使用 Prometheus Chart 与 https://github.com/bitnami/charts/tree/main/bitnami/thanos 集成（以 MinIO 作为对象存储，部署在 monitoring 命名空间）：

1. 创建 Thanos 配置文件 values.yaml：

yaml
objstoreConfig: |-
  type: s3
  config:
    bucket: thanos
    endpoint: {{ include "thanos.minio.fullname" . }}.{{ .Release.Namespace }}.svc.cluster.local:9000
    access_key: minio
    secret_key: minio123
    insecure: true
query:
  dnsDiscovery:
    sidecarsService: prometheus-thanos
    sidecarsNamespace: monitoring
bucketweb:
  enabled: true
compactor:
  enabled: true
storegateway:
  enabled: true
ruler:
  enabled: true
  alertmanagers:
    - http://prometheus-alertmanager.monitoring.svc.cluster.local:9093
  config: |-
    groups:
      - name: "metamonitoring"
        rules:
          - alert: "PrometheusDown"
            expr: absent(up{prometheus="monitoring/prometheus"})
metrics:
  enabled: true
  serviceMonitor:
    enabled: true
minio:
  enabled: true
  auth:
    rootPassword: minio123
    rootUser: minio
  monitoringBuckets: thanos
  accessKey:
    password: minio
  secretKey:
    password: minio123

2. 安装 Prometheus 和 Thanos：

console
kubectl create namespace monitoring
helm install prometheus \
    --set prometheus.thanos.create=true \
    --namespace monitoring \
    oci://registry-1.docker.io/bitnamicharts/prometheus
helm install thanos \
    --values values.yaml \
    --namespace monitoring \
    oci://registry-1.docker.io/bitnamicharts/thanos

与 Grafana Mimir 集成

通过 remoteWrite 配置将 Prometheus 与 Grafana Mimir 集成：

1. 创建 Prometheus 配置文件 values.yaml：

yaml
server:
  remoteWrite:
    - url: http://grafana-mimir-gateway.svc.cluster.local/api/v1/push
      headers:
        X-Scope-OrgID: demo

2. 安装 Prometheus 和 Grafana Mimir：

console
kubectl create namespace monitoring
helm install prometheus \
    --values values.yaml \
    --namespace monitoring \
    oci://registry-1.docker.io/bitnamicharts/prometheus
helm install grafana-mimir \
    oci://registry-1.docker.io/bitnamicharts/grafana-mimir

与 Grafana 集成

配置 Grafana 数据源连接 Prometheus：

1. 创建 Grafana 配置文件 values.yaml：

yaml
datasources:
  secretDefinition:
    apiVersion: 1
    datasources:
      - name: Prometheus
        type: prometheus
        access: proxy
        orgId: 1
        url: http://prometheus.monitoring.svc.cluster.local
        version: 1
        editable: true
        isDefault: true
      - name: Alertmanager
        uid: alertmanager
        type: alertmanager
        access: proxy
        orgId: 1
        url: http://prometheus-alertmanager.monitoring.svc.cluster.local:9093
        version: 1
        editable: true

2. 安装 Prometheus 和 Grafana：

console
kubectl create namespace monitoring
helm install prometheus \
    --namespace monitoring \
    oci://registry-1.docker.io/bitnamicharts/prometheus
helm install grafana \
    --values values.yaml \
    --namespace monitoring \
    oci://registry-1.docker.io/bitnamicharts/grafana

添加自定义监控目标

通过 server.extraScrapeConfigs 参数添加自定义监控目标，格式遵循 Prometheus scrape_configs。示例：监控 default 命名空间中的 WordPress：

yaml
server:
  extraScrapeConfigs:
    - job_name: wordpress
      kubernetes_sd_configs:
        - role: endpoints
          namespaces:
            names:
            - default
      metrics_path: /metrics
      relabel_configs:
        - source_labels: [job]
          target_label: __tmp_wordpress_job_name
        - action: keep
          source_labels: [__meta_kubernetes_service_label_app_kubernetes_io_instance, __meta_kubernetes_service_labelpresent_app_kubernetes_io_instance]
          regex: (wordpress);true
        - action: keep
          source_labels: [__meta_kubernetes_service_label_app_kubernetes_io_name, __meta_kubernetes_service_labelpresent_app_kubernetes_io_name]
          regex: (wordpress);true
        - action: keep
          source_labels: [__meta_kubernetes_endpoint_port_name]
          regex: metrics
        # 更多 relabel 配置...

参数说明

全局参数

通用参数

Alertmanager 参数

注意：完整参数列表请参见 https://github.com/bitnami/charts/blob/main/bitnami/prometheus/README.md%EF%BC%88%E5%8E%9F README 因长度限制被截断）。

⚠️ 重要通知：Bitnami 镜像目录即将变更

自 2025 年 8 月 28 日起，Bitnami 将升级其公共目录，通过 Bitnami Secure Images 计划 提供精选的硬化、安全聚焦镜像。过渡要点：

• 首次向社区用户开放流行容器镜像的安全优化版本
• 社区版将逐步弃用非硬化 Debian 基础镜像，仅保留“latest”标签的硬化镜像（用于开发）
• 8 月 28 日起两周内，所有现有容器镜像（含历史版本标签，如 2.50.0、10.6）将从公共仓库（docker.io/bitnami）迁移至“Bitnami Legacy”仓库（docker.io/bitnamilegacy），且不再更新
• 生产环境建议采用 Bitnami Secure Images，包含硬化容器、更小***面、CVE 透明度（VEX/KEV）、SBOM 和企业支持

更多详情参见 https://github.com/bitnami/containers/issues/83267%E3%80%82