maxrocketinternet/k8s-event-logger

k8s-event-logger 镜像文档

概述

k8s-event-logger是一个轻量级工具，用于实时监控Kubernetes集群事件，并将事件数据以JSON格式输出到标准输出(stdout)。该工具旨在简化Kubernetes集群事件的收集、解析和分析流程，便于集成到日志管理系统中进行集中处理。

核心功能与特性

• 实时事件监控：持续监听Kubernetes集群中的各类事件（如Pod调度、节点状态变更、资源创建/删除等）
• 结构化日志输出：事件数据以JSON格式标准化输出，包含事件类型、资源对象、时间戳、消息内容等关键字段，便于日志系统解析和过滤
• 轻量级设计：容器化部署，资源占用低，适合在Kubernetes环境中高效运行
• 无状态架构：无需持久化存储，直接通过Kubernetes API获取事件数据，部署简单

使用场景

• 集群事件集中收集：适用于需要将Kubernetes事件统一汇总至ELK、Loki、Splunk等日志平台的场景
• 事件监控与告警：结合日志告警工具（如Promtail+Alertmanager）实现关键事件实时告警
• 故障排查辅助：通过结构化事件日志快速定位集群异常（如Pod启动失败、资源配额超限等）
• 合规审计：记录集群资源变更历史，满足运维审计需求

使用方法

前提条件

• 已部署Kubernetes集群（版本1.16+）
• 具备集群管理员权限（用于配置RBAC权限）
• 已安装kubectl命令行工具并配置集群访问凭证

部署步骤

1. 配置RBAC权限

该工具需要访问Kubernetes API的权限以获取事件数据，需创建对应的ServiceAccount、ClusterRole和ClusterRoleBinding：

yaml
apiVersion: v1
kind: ServiceAccount
metadata:
  name: k8s-event-logger
  namespace: default
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: k8s-event-logger-role
rules:
- apiGroups: [""]
  resources: ["events"]
  verbs: ["get", "watch", "list"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: k8s-event-logger-binding
subjects:
- kind: ServiceAccount
  name: k8s-event-logger
  namespace: default
roleRef:
  kind: ClusterRole
  name: k8s-event-logger-role
  apiGroup: rbac.authorization.k8s.io

2. 部署应用

通过Deployment部署k8s-event-logger：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: k8s-event-logger
  namespace: default
spec:
  replicas: 1  # 单副本足以满足事件监听需求
  selector:
    matchLabels:
      app: k8s-event-logger
  template:
    metadata:
      labels:
        app: k8s-event-logger
    spec:
      serviceAccountName: k8s-event-logger
      containers:
      - name: k8s-event-logger
        image: max-rocket-internet/k8s-event-logger:latest  # 使用最新稳定版本
        resources:
          limits:
            cpu: 100m
            memory: 128Mi
          requests:
            cpu: 50m
            memory: 64Mi

3. 验证部署

部署完成后，通过以下命令查看输出的JSON格式事件日志：

bash
kubectl logs -l app=k8s-event-logger -f

预期输出示例（JSON格式）：

json
{"metadata":{"name":"nginx-78f5d695bd-2xqzv.176f5d3b1a2b3","namespace":"default","selfLink":"/api/v1/namespaces/default/events/nginx-78f5d695bd-2xqzv.176f5d3b1a2b3","uid":"a1b2c3d4-5678-90ef-ghij-klmnopqrstuv","resourceVersion":"123456","creationTimestamp":"2023-10-01T12:00:00Z"},"involvedObject":{"kind":"Pod","namespace":"default","name":"nginx-78f5d695bd-2xqzv","uid":"wxyz1234-5678-90ab-cdef-ghijklmnopqr","apiVersion":"v1","resourceVersion":"78901"},"reason":"Scheduled","message":"Successfully assigned default/nginx-78f5d695bd-2xqzv to node-1","source":{"component":"default-scheduler"},"firstTimestamp":"2023-10-01T12:00:00Z","lastTimestamp":"2023-10-01T12:00:00Z","count":1,"type":"Normal","eventTime":null,"reportingComponent":"","reportingInstance":""}

集成建议

• 与日志收集工具（如Fluentd、Promtail）配合，将stdout输出的JSON日志转发至集中日志平台
• 针对关键事件类型（如Warning级别事件）配置日志告警规则，提升集群异常响应速度
• 在多集群环境中，可通过跨集群日志聚合工具（如Grafana Loki with Agent）实现统一事件监控