bitnamicharts/kubernetes-event-exporter

Kubernetes Event Exporter - Bitnami镜像文档

镜像概述和主要用途

Kubernetes Event Exporter 能够轻松将 Kubernetes 事件导出到其他工具，从而实现更好的事件可观测性、自定义告警和聚合功能。

https://github.com/resmoio/kubernetes-event-exporter

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

核心功能和特性

• 从 Kubernetes 集群收集事件并导出到外部系统
• 支持多种事件接收器配置
• 灵活的事件路由规则设置
• 可配置的日志级别和格式
• 支持 Prometheus 指标集成
• 符合生产环境安全标准的容器镜像
• 可通过 Helm 图表轻松部署和配置

使用场景和适用范围

• Kubernetes 集群事件集中管理
• 自定义事件告警和通知
• 集群事件长期存储和分析
• 多集群事件聚合
• 运维监控和故障排查
• 合规性审计和事件追踪

快速入门 (TL;DR)

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/kubernetes-event-exporter

如需在生产环境中使用 Kubernetes Event Exporter，建议尝试 VMware Tanzu Application Catalog，这是 Bitnami 目录的商业版本。

⚠️ 重要通知：Bitnami Catalog即将变更

自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 和企业支持。

这些变更旨在通过促进软件供应链完整性和最新部署的最佳实践，提高所有 Bitnami 用户的安全状况。有关更多详细信息，请访问 https://github.com/bitnami/containers/issues/83267%E3%80%82

前提条件

• Kubernetes 1.23+
• Helm 3.8.0+

详细使用方法和配置说明

安装图表

要安装名为 my-release 的图表：

console
helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/kubernetes-event-exporter

注意：您需要将占位符 REGISTRY_NAME 和 REPOSITORY_NAME 替换为您的 Helm 图表 registry 和仓库的引用。例如，对于 Bitnami，您需要使用 REGISTRY_NAME=registry-1.docker.io 和 REPOSITORY_NAME=bitnamicharts。

这些命令使用默认配置在 Kubernetes 集群上部署 Kubernetes Event Exporter。可在 参数 部分查看可在安装过程中配置的参数列表。

提示：使用 helm list 或 helm ls --all-namespaces 列出所有发布版本

资源请求和限制

Bitnami 图表允许为图表部署中的所有容器设置资源请求和限制。这些设置位于 resources 值下（参见参数表）。设置请求对于生产工作负载至关重要，应根据您的具体用例进行调整。

为简化此过程，图表包含 resourcesPreset 值，可根据不同预设自动设置 resources 部分。可在 https://github.com/bitnami/charts/blob/main/bitnami/common/templates/_resources.tpl#L15 中查看这些预设。但是，在生产工作负载中不建议使用 resourcesPreset，因为它可能无法完全适应您的特定需求。有关容器资源管理的更多信息，请参阅 官方 Kubernetes 文档。

Prometheus 指标

通过将 metrics.enabled 设置为 true，可以将此图表与 Prometheus 集成。这将在所有 Pod 中启用 kubernetes-event-exporter 原生 Prometheus 端点和 metrics 服务，可在 metrics.service 部分下进行配置。此 metrics 服务将具有必要的注释，以便被 Prometheus 自动抓取。

Prometheus 要求

要使集成正常工作，必须安装 Prometheus 或 Prometheus Operator。安装 https://github.com/bitnami/charts/tree/main/bitnami/prometheus 或 https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus%EF%BC%8C%E5%8F%AF%E4%BB%A5%E8%BD%BB%E6%9D%BE%E5%9C%A8%E9%9B%86%E7%BE%A4%E4%B8%AD%E9%83%A8%E7%BD%B2%E5%8F%AF%E7%94%A8%E7%9A%84 Prometheus。

与 Prometheus Operator 集成

该图表可以部署 ServiceMonitor 对象，以便与 Prometheus Operator 安装集成。要实现此目的，请将值 metrics.serviceMonitor.enabled=true 设置为 true。确保在集群中安装了 Prometheus Operator CustomResourceDefinitions，否则将失败并显示以下错误：

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

安装 https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus 以获取必要的 CRD 和 Prometheus Operator。

Rolling vs Immutable 标签

在生产环境中强烈建议使用不可变标签。这可确保如果相同标签使用不同镜像更新，您的部署不会自动更改。

如果主容器有新版本、重大更改或严重漏洞，Bitnami 将发布新图表更新其容器。

使用不同版本

要修改此图表中使用的应用程序版本，请使用 image.tag 参数指定不同版本的镜像和/或使用 image.repository 参数指定不同的仓库。

设置 Pod 亲和性

此图表允许使用 affinity 参数设置自定义 Pod 亲和性。有关 Pod 亲和性的更多信息，请参阅 Kubernetes 文档。

作为替代方案，可以使用 https://github.com/bitnami/charts/tree/main/bitnami/common#affinities 图表中提供的 Pod 亲和性、Pod 反亲和性和节点亲和性的预设配置之一。为此，请设置 podAffinityPreset、podAntiAffinityPreset 或 nodeAffinityPreset 参数。

备份和恢复

要在 Kubernetes 上备份和恢复 Helm 图表部署，您需要从源部署备份持久卷，并使用 Velero（Kubernetes 备份/恢复工具）将它们附加到新部署。在 本指南 中找到使用 Velero 的说明。

部署方案示例

使用 Helm 安装

基本安装：

console
helm install my-k8s-event-exporter oci://registry-1.docker.io/bitnamicharts/kubernetes-event-exporter

指定命名空间安装：

console
helm install my-k8s-event-exporter oci://registry-1.docker.io/bitnamicharts/kubernetes-event-exporter \
  --namespace event-exporter --create-namespace

自定义配置安装：

console
helm install my-k8s-event-exporter oci://registry-1.docker.io/bitnamicharts/kubernetes-event-exporter \
  --set config.logLevel=info \
  --set config.clusterName=my-k8s-cluster \
  --set replicaCount=2

使用自定义 values 文件安装：

console
helm install my-k8s-event-exporter oci://registry-1.docker.io/bitnamicharts/kubernetes-event-exporter \
  -f custom-values.yaml

示例接收器配置

以下是一个基本的 values.yaml 示例，配置将事件导出到 Elasticsearch：

yaml
config:
  logLevel: info
  logFormat: json
  clusterName: my-k8s-cluster
  receivers:
    - name: "elasticsearch"
      elasticsearch:
        hosts:
          - "http://elasticsearch:9200"
        index: "k8s-events"
        username: "elastic"
        password: "changeme"
  route:
    routes:
      - match:
          - receiver: "elasticsearch"

参数

全局参数

通用参数

Kubernetes Event Exporter 参数