xingse/kubernetes-oom-event-generator

Kubernetes OOMKilled事件生成器

镜像概述和主要用途

该Docker镜像作为Kubernetes集群的辅助监控工具，专注于检测Pod容器因内存溢出（OOM）导致的终止事件（OOMKilled），并自动在Kubernetes集群中生成标准化事件，以便用户通过Kubernetes事件机制（如kubectl describe pod或监控系统）及时发现和处理容器内存问题，提升集群应用稳定性。

核心功能和特性

• OOMKilled事件检测：实时监控Kubernetes集群中Pod容器状态，精准识别因OOM导致的容器终止事件
• 自动生成Kubernetes事件：检测到OOMKilled事件时，自动向Kubernetes API提交事件，包含事件类型、Pod名称、容器名称、发生时间等关键信息
• 轻量级设计：镜像体积小，资源占用低，运行时仅需少量CPU和内存，不影响集群性能
• 灵活配置：支持通过环境变量自定义监控范围（如特定命名空间）、检查间隔等参数
• 易于集成：可通过Kubernetes DaemonSet或Deployment部署，无缝集成到现有监控体系（如Prometheus、Grafana）

使用场景和适用范围

• 生产环境Kubernetes集群：监控关键业务容器的内存使用情况，及时发现OOM问题
• 容器化应用调试：在应用开发或测试阶段，帮助开发人员定位因内存配置不当导致的OOM问题
• 集群运维监控：为运维团队提供容器异常终止的实时通知，辅助集群资源优化和故障排查
• 多租户集群管理：在共享集群环境中，监控各租户容器资源使用情况，避免资源滥用导致的OOM事件

使用方法和配置说明

部署方式

推荐通过Kubernetes DaemonSet部署，确保在集群每个节点上运行实例，实现全集群监控。

DaemonSet配置示例

yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: oom-event-generator
  namespace: kube-system
spec:
  selector:
    matchLabels:
      app: oom-event-generator
  template:
    metadata:
      labels:
        app: oom-event-generator
    spec:
      containers:
      - name: oom-event-generator
        image: docker.xuanyuan.run/[镜像名称]  # 替换为实际镜像名称
        env:
        - name: NAMESPACE
          value: "all"  # 监控所有命名空间，可指定具体命名空间如"default"
        - name: CHECK_INTERVAL
          value: "30"  # 检查间隔（秒），默认30秒
        - name: EVENT_TTL
          value: "86400"  # 事件存活时间（秒），默认24小时
        resources:
          limits:
            cpu: "100m"
            memory: "128Mi"
          requests:
            cpu: "50m"
            memory: "64Mi"
        volumeMounts:
        - name: kubeconfig
          mountPath: /root/.kube/config
          readOnly: true
      volumes:
      - name: kubeconfig
        hostPath:
          path: /root/.kube/config  # 节点上的kubeconfig路径，确保容器有权限访问Kubernetes API

环境变量配置

验证部署

部署后检查Pod运行状态：

bash
kubectl get pods -n kube-system -l app=oom-event-generator

查看生成的OOMKilled事件：

bash
kubectl describe pod <pod名称>

在事件列表中可看到由该工具生成的OOMKilled相关事件详情。