kubectl log pod/yourpod对应容器日志默认路径及修改方法

1. 容器日志默认存储路径 #

kubectl logs pod/yourpod 能读取到日志的核心前提是：容器内业务进程将日志输出到**标准输出(stdout)或标准错误(stderr)**流，你提到的sigs.k8s.io/controller-runtime/pkg/log库默认配置就是将日志输出到上述两个流，完全适配K8s的默认日志采集规则。

节点上的日志存储分三层链路：

• 上层统一访问软链：/var/log/containers/<Pod名>_<命名空间>_<容器名>-<容器短ID>.log，所有日志采集组件默认从这个路径匹配Pod日志
• Pod维度软链：/var/log/pods/<命名空间>_<Pod名>_<PodUID>/<容器名>/<容器重启次数>.log，按Pod、容器重启次数做维度隔离
• 实际存储位置由容器运行时决定，主流运行时默认路径：
  • containerd（K8s 1.24+默认运行时）：默认将结构化JSON日志存在/var/lib/containerd/io.containerd.runtime.v2.task/k8s.io/<容器完整ID>/log.json，再软链到上述的pods、containers目录
  • Docker（旧版K8s支持）：日志存在/var/lib/docker/containers/<容器完整ID>/<容器完整ID>-json.log

从容器内部进程视角看，stdout/stderr对应的是进程自身的文件描述符/proc/self/fd/1（stdout）、/proc/self/fd/2（stderr），没有单独的默认容器内落盘路径。

2. 修改日志存储路径的方法 #

根据你要调整的范围，分两种常见场景操作：

场景1：修改节点侧容器stdout/stderr日志的根存储路径 #

这个配置由容器运行时控制，以最常用的containerd为例：

1. 编辑containerd配置文件/etc/containerd/config.toml，找到[plugins."io.containerd.grpc.v1.cri"]配置段，修改log_dir字段为你自定义的绝对路径，比如/data/k8s-container-logs
2. 新建自定义路径，配置权限为0755，保证containerd、kubelet进程有读写权限
3. 执行systemctl restart containerd重启运行时生效，后续新建的Pod日志都会落到新路径，存量Pod的日志不会自动迁移

注意：不建议随意修改运行时的底层日志存储路径，修改后要同步更新节点上的日志采集、日志轮转规则，避免采集丢日志或者磁盘打满。

场景2：修改controller-runtime业务日志的输出路径，不输出到stdout #

如果你不想让业务日志走K8s默认的stdout流，要输出到容器内指定文件路径，可以在业务代码初始化日志时自定义zap实例（controller-runtime/log底层默认用zap实现），示例代码：

package main

import (
	"os"
	"go.uber.org/zap/zapcore"
	"sigs.k8s.io/controller-runtime/pkg/log"
	"sigs.k8s.io/controller-runtime/pkg/log/zap"
)

func main() {
	// 打开自定义日志文件，提前在容器镜像中创建对应目录、配置好权限
	logFile, err := os.OpenFile("/var/log/my-business/controller.log", os.O_CREATE|os.O_APPEND|os.O_WRONLY, 0644)
	if err != nil {
		panic("init log file failed: " + err.Error())
	}

	// 配置日志编码、级别、输出目标
	encoderCfg := zap.NewProductionEncoderConfig()
	encoderCfg.TimeKey = "ts"
	encoder := zapcore.NewJSONEncoder(encoderCfg)
	customCore := zapcore.NewCore(encoder, zapcore.AddSync(logFile), zapcore.InfoLevel)

	// 初始化logger并设置为controller-runtime全局日志实例
	customLogger := zap.New(zap.WrapCore(func(_ zapcore.Core) zapcore.Core {
		return customCore
	}))
	log.SetLogger(customLogger)

	// 后续业务、Reconcile逻辑直接调用log.Log即可写入自定义文件
}

重要提醒：如果业务日志输出到容器内自定义文件，kubectl logs默认无法读取这部分内容，你需要额外配置日志采集组件（比如以DaemonSet部署的Filebeat、Promtail）挂载容器内的日志目录做采集；同时必须配置日志轮转规则，避免日志文件持续增长打满容器磁盘、影响节点稳定。

内容的提问来源于stack exchange，提问作者Mike