bitnamicharts/grafana-tempo

Bitnami Grafana Tempo 镜像文档

镜像概述和主要用途

Grafana Tempo 是一款分布式追踪系统，与 Grafana 具有开箱即用的集成能力。它具备高度可扩展性，支持多种主流追踪协议。Bitnami 提供的此 Helm Chart 旨在通过 Helm 包管理器在 Kubernetes 集群中快速部署 Grafana Tempo，适用于开发和生产环境的容器化部署需求。

https://github.com/grafana/tempo

商标说明：本软件包由 Bitnami 打包。所提及的商标分属各自公司所有，使用此类商标不意味着任何关联或背书。

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

自 2025 年 8 月 28 日起，Bitnami 将升级其公共镜像目录，通过新的 Bitnami Secure Images 计划 提供精选的、专注于安全性的加固镜像。此次过渡包括：

• 首次向社区用户开放热门容器镜像的安全优化版本。
• Bitnami 将逐步弃用免费层级中非加固的 Debian 基础镜像，并从公共目录中移除非最新标签。社区用户将只能访问数量减少的加固镜像，这些镜像仅以“latest”标签发布，适用于开发目的。
• 自 8 月 28 日起，两周内所有现有容器镜像（包括旧版本标签，如 2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移至“Bitnami Legacy”仓库（docker.io/bitnamilegacy），且不再接收更新。
• 对于生产工作负载和长期支持，建议用户采用 Bitnami Secure Images，其包含加固容器、更小***面、CVE 透明度（通过 VEX/KEV）、SBOM 以及企业支持。

核心功能和特性

• 多协议支持：原生支持 Jaeger（GRPC、Thrift Binary/Compact/HTTP）、OTLP（HTTP/GRPC）、OpenCensus、Zipkin 等追踪协议。
• 高可扩展性：采用分布式架构，支持水平扩展以应对大规模追踪数据。
• Grafana 集成：与 Grafana 无缝集成，可直接在 Grafana 界面中查询和可视化追踪数据。
• Prometheus 监控：支持 Prometheus 指标暴露，可通过 ServiceMonitor 与 Prometheus Operator 集成。
• 灵活配置：支持自定义 tempo.yaml 配置文件及覆盖配置，适应不同场景需求。
• 外部缓存支持：可对接外部 Memcached 服务，避免集群内缓存部署。
• 持久化存储：通过 Persistent Volume Claims（PVC）确保追踪数据持久化存储。

使用场景和适用范围

• 分布式系统追踪：适用于微服务架构、云原生应用的分布式追踪，帮助定位跨服务调用问题。
• 可观测性平台构建：与 Grafana、Prometheus 等工具配合，构建完整的可观测性平台。
• 开发与生产环境：Bitnami 提供的镜像支持开发测试（社区版）和生产部署（Secure Images 企业版）。
• 大规模数据处理：高可扩展性设计使其适合处理海量追踪数据，满足大型应用需求。

前提条件

• Kubernetes 集群版本 1.23+
• Helm 版本 3.8.0+
• 底层基础设施支持 PV 动态供应

安装部署

快速部署（TL;DR）

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

生产环境建议

如需在生产环境使用 Grafana Tempo，建议尝试 VMware Tanzu Application Catalog，即 Bitnami 目录的商业版本。

详细安装步骤

1. 添加 Helm 仓库（如未配置）：

   console
   helm repo add bitnami https://charts.bitnami.com/bitnami
   helm repo update
   

2. 安装 Chart：

   使用自定义发布名称（如 my-release）安装：

   console
   helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/grafana-tempo
   

   注意：需替换 REGISTRY_NAME 和 REPOSITORY_NAME 为实际 Helm 仓库地址。Bitnami 官方仓库示例：REGISTRY_NAME=registry-1.docker.io，REPOSITORY_NAME=bitnamicharts。

3. 验证部署：

   console
   helm list  # 查看所有发布
   kubectl get pods  # 检查 Pod 状态
   

配置说明

资源请求与限制

Bitnami Charts 允许为部署中的所有容器设置资源请求（requests）和限制（limits），通过 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%E5%BB%BA%E8%AE%AE%E6%89%8B%E5%8A%A8%E9%85%8D%E7%BD%AE%E4%BB%A5%E9%80%82%E9%85%8D%E5%85%B7%E4%BD%93%E9%9C%80%E6%B1%82%E3%80%82%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E5%8F%82%E8%80%83 Kubernetes 容器资源管理文档。

滚动标签与不可变标签

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

Prometheus 指标集成

通过设置 metrics.enabled=true 可启用 Prometheus 集成，暴露 Grafana Tempo 原生 Prometheus 端口，并为 Service 添加自动发现注解。

集成要求

需预先部署 Prometheus 或 Prometheus Operator。推荐安装 https://github.com/bitnami/charts/tree/main/bitnami/prometheus 或 https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus%E3%80%82

与 Prometheus Operator 集成

设置 metrics.serviceMonitor.enabled=true 可部署 ServiceMonitor 对象。需确保集群已安装 Prometheus Operator CRDs，否则会报错：

text
no matches for kind "ServiceMonitor" in version "monitoring.coreos.com/v1"

Tempo 配置

Tempo 配置文件 tempo.yaml 适用于所有组件（distributor、compactor、ingester、querier、queryFrontend），通过 tempo.configuration 参数配置。配置项参考 Grafana Tempo 官方文档。

也可通过 tempo.existingConfigmap 指定已存在的 ConfigMap 存储配置。

额外环境变量

可为各组件（distributor、compactor、ingester、querier、queryFrontend、vulture）添加额外环境变量，支持以下方式：

1. 直接指定：

   yaml
   compactor:
     extraEnvVars:
       - name: LOG_LEVEL
         value: error
   # 其他组件类似
   

2. 通过 ConfigMap/Secret：

   使用 extraEnvVarsCM（ConfigMap 名称）或 extraEnvVarsSecret（Secret 名称）引用现有配置。

边车容器（Sidecars）

可通过各组件的 sidecars 参数添加额外容器（如指标/日志采集器）：

yaml
sidecars:
  - name: your-image-name
    image: your-image
    imagePullPolicy: Always
    ports:
      - name: portname
        containerPort: 1234

如需暴露边车容器端口，可通过 service.extraPorts 配置：

yaml
service:
  extraPorts:
    - name: extraPort
      port: 11311
      targetPort: 11311

注意：本 Chart 已包含 Prometheus exporter 边车容器（如需启用，设置 --enable-metrics=true），sidecars 参数仅用于添加额外容器。

初始化容器（Init Containers）

通过 initContainers 参数添加初始化容器：

yaml
initContainers:
  - name: your-image-name
    image: your-image
    imagePullPolicy: Always
    ports:
      - name: portname
        containerPort: 1234

Pod 亲和性配置

可通过 affinity 参数自定义 Pod 亲和性，或使用 https://github.com/bitnami/charts/tree/main/bitnami/common#affinities 提供的预设：

• podAffinityPreset：Pod 亲和性预设
• podAntiAffinityPreset：Pod 反亲和性预设
• nodeAffinityPreset：节点亲和性预设

上述预设需在各组件（distributor、compactor 等）的配置项下设置。

外部缓存支持

如需对接外部 Memcached（如托管缓存服务或共享缓存），可通过 externalMemcached 参数配置，并禁用内置 Memcached：

console
memcached.enabled=false
externalMemcached.host=myexternalhost
externalMemcached.port=11211

备份与恢复

Helm Chart 部署的备份与恢复需通过 Velero 工具实现，具体步骤参考 使用 Velero 备份恢复指南。

持久化存储

https://github.com/bitnami/containers/tree/main/bitnami/grafana-tempo 将 ingester 数据存储在容器内 /bitnami 路径，通过 Persistent Volume Claims（PVC）实现数据持久化。

参数详解

全局参数

通用参数

Grafana Tempo 通用参数

Compactor 部署参数

注意：完整参数列表请参考 https://github.com/bitnami/charts/blob/main/bitnami/grafana-tempo/README.md%EF%BC%88%E5%8E%9F%E6%96%87%E6%A1%A3%E5%9B%A0%E9%95%BF%E5%BA%A6%E9%99%90%E5%88%B6%E8%A2%AB%E6%88%AA%E6%96%AD%EF%BC%89%E3%80%82