如何修改kubectl logs --timestamps输出的日志时间戳时区

执行kubectl logs <mypod> --timestamps时，输出的前缀时间戳由节点上的容器运行时、kubelet采集日志时生成，默认采用UTC标准时区。K8s原生未提供直接调整该时间戳输出时区的kubectl参数，可根据使用场景选择以下方案实现UTC+8东八区时间戳输出。

方案1：客户端侧转换（无需修改集群配置，临时排查首选） #

直接通过管道命令对输出的UTC时间戳做转换，不需要改动集群、节点任何配置，适合临时排查问题时使用：

kubectl logs <mypod> --timestamps | awk -F 'Z ' '{ t=$1; gsub(/T/," ",t); cmd="TZ=Asia/Shanghai date -d \""t"\" +\"%Y-%m-%dT%H:%M:%S+0800\""; cmd | getline ts; close(cmd); print ts, substr($0, length($1)+3) }'

如果需要长期使用，可以将逻辑封装为shell别名，添加到本地.bashrc或.zshrc配置中：

alias klogscn='f(){ kubectl logs "$@" --timestamps | awk -F "Z " "{ t=\$1; gsub(/T/,\" \",t); cmd=\"TZ=Asia/Shanghai date -d \\\"\"t\"\\\" +\\\"%Y-%m-%dT%H:%M:%S+0800\\\"\"; cmd | getline ts; close(cmd); print ts, substr(\$0, length(\$1)+3) }"; unset -f f; }'

后续直接执行klogscn <mypod>即可直接输出东八区时间戳的日志。

方案2：调整节点kubelet配置（集群全局生效） #

如果需要集群内所有Pod日志默认输出东八区时间戳，可以统一调整所有工作节点的kubelet时区配置：

1. 先将节点本地时区设置为东八区：

   timedatectl set-timezone Asia/Shanghai
   

2. 修改kubelet的systemd服务配置（kubeadm部署的集群默认配置路径为/etc/systemd/system/kubelet.service.d/10-kubeadm.conf），在[Service]段添加时区环境变量：

   [Service]
   Environment="TZ=Asia/Shanghai"
   

3. 重载配置并重启kubelet生效：

   systemctl daemon-reload
   systemctl restart kubelet
   

注意：配置生效后新产生的日志会使用东八区时间戳，配置生效前已经存在的历史日志时间戳不会变更。

方案3：调整容器运行时配置（全局生效） #

前缀时间戳最终由容器运行时负责记录，也可以直接调整容器运行时的时区配置实现全局生效：

• 若使用Docker作为运行时：修改Docker的systemd服务配置，在[Service]段添加Environment="TZ=Asia/Shanghai"，之后执行systemctl daemon-reload && systemctl restart docker生效。
• 若使用containerd作为运行时：修改containerd的systemd服务配置，添加同上的TZ环境变量，执行systemctl daemon-reload && systemctl restart containerd生效。

注意：不要通过修改Pod内时区、为Pod添加TZ=Asia/Shanghai环境变量的方式调整前缀时间戳。该时间戳由集群侧组件生成，和容器内部时区无关，修改容器内时区只会影响应用自身打印的日志内容中的时间，不会改变前缀时间戳。

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