sumologic/kubernetes-log-linker

Log-linker 镜像文档

概述

Log-linker是一个轻量级工具镜像，专门用于解决Kubernetes环境中日志符号链接（symlinks）创建不全的问题。该镜像基于Kubernetes GitHub issue #52172中描述的日志链接缺失场景开发，确保容器日志文件的符号链接被正确创建，从而保障日志收集工具能够可靠访问和收集容器日志。

核心功能与特性

• 自动链接修复：检测并创建Kubernetes环境中缺失的日志符号链接
• 针对性解决方案：专门解决Kubernetes issue #52172中记录的日志链接问题
• 轻量级设计：资源占用低，适合在Kubernetes集群中大规模部署
• 无侵入性：仅处理日志链接创建，不干扰容器运行和日志生成过程

使用场景与适用范围

• Kubernetes集群中需要稳定收集容器日志的场景
• 使用日志收集工具（如Promtail、Filebeat、Fluentd等）时，解决因日志链接缺失导致的收集失败问题
• 容器日志路径解析异常，日志收集工具无法找到实际日志文件的场景
• 多节点Kubernetes集群环境，需要统一日志链接管理的场景

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name log-linker \
  --volume /var/log/pods:/var/log/pods:ro \
  --volume /var/lib/docker/containers:/var/lib/docker/containers:ro \
  --privileged \
  log-linker:latest

Kubernetes部署（DaemonSet配置）

yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: log-linker
  namespace: kube-system
spec:
  selector:
    matchLabels:
      app: log-linker
  template:
    metadata:
      labels:
        app: log-linker
    spec:
      containers:
      - name: log-linker
        image: log-linker:latest
        volumeMounts:
        - name: pods-log
          mountPath: /var/log/pods
          readOnly: true
        - name: docker-containers
          mountPath: /var/lib/docker/containers
          readOnly: true
        securityContext:
          privileged: true
      volumes:
      - name: pods-log
        hostPath:
          path: /var/log/pods
          type: Directory
      - name: docker-containers
        hostPath:
          path: /var/lib/docker/containers
          type: Directory

必要挂载说明

Log-linker需要访问以下主机目录以完成日志链接创建：

• /var/log/pods: Kubernetes Pod日志元数据及链接存储路径（只读）
• /var/lib/docker/containers: Docker容器实际日志文件存储路径（只读）

运行要求

• 需要特权模式运行（--privileged）以允许创建符号链接
• 需确保主机上上述两个目录存在且可访问
• 支持Kubernetes 1.10+及主流容器运行时（Docker、containerd等）