sapcc/kubernetes-oomkill-exporter

kubernetes-oomkill-exporter 镜像文档

镜像概述

kubernetes-oomkill-exporter 是一款用于监控 Kubernetes 集群中因 OOM（内存溢出）被终止的 Pod 的工具。它通过解析内核日志识别被终止的 Pod，从 Docker 容器运行时收集命名空间、Pod 名称等元数据，并将这些信息转换为 Prometheus 兼容的指标形式暴露，便于集成到监控系统中进行分析和告警。

核心功能与特性

• 内核日志解析：实时监控并解析内核日志，精准识别因 OOM 被终止的 Pod 事件。
• 元数据收集：通过 Docker 接口获取被终止 Pod 的关键元数据，包括命名空间、Pod 名称等。
• 指标暴露：将收集到的 OOM 事件数据转换为 Prometheus 指标，支持标准监控工具集成。
• 轻量级设计：资源占用低，可在 Kubernetes 集群中高效部署运行。

使用场景与适用范围

• OOM 问题排查：帮助运维人员快速定位集群中因内存溢出被终止的 Pod，加速问题诊断。
• 性能监控：持续跟踪 Pod 内存使用情况，为优化资源配置提供数据支持。
• 告警集成：结合 Prometheus Alertmanager 实现 OOM 事件实时告警，提升集群稳定性。
• 适用环境：适用于使用 Docker 容器运行时的 Kubernetes 集群，支持各类节点环境。

使用方法与配置说明

环境要求

• 运行环境：Kubernetes 集群节点（需安装 Docker）
• 权限要求：需挂载内核日志文件和 Docker socket，具备读取权限

部署示例

Docker 直接运行

bash
docker run -d \
  -p 9256:9256 \
  -v /var/log/kern.log:/var/log/kern.log:ro \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  --name oomkill-exporter \
  kubernetes-oomkill-exporter:latest

Kubernetes DaemonSet 部署

yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: oomkill-exporter
  namespace: monitoring
spec:
  selector:
    matchLabels:
      app: oomkill-exporter
  template:
    metadata:
      labels:
        app: oomkill-exporter
    spec:
      containers:
      - name: oomkill-exporter
        image: kubernetes-oomkill-exporter:latest
        ports:
        - containerPort: 9256
          name: metrics
        volumeMounts:
        - name: kern-log
          mountPath: /var/log/kern.log
          readOnly: true
        - name: docker-sock
          mountPath: /var/run/docker.sock
          readOnly: true
      volumes:
      - name: kern-log
        hostPath:
          path: /var/log/kern.log
      - name: docker-sock
        hostPath:
          path: /var/run/docker.sock

配置参数

指标说明