K8s边车容器中tail命令停止追踪日志问题排查

我在完成A Cloud Guru的实验，需要创建两个Busybox容器：一个写入日志文件，另一个作为边车容器读取该日志并输出到stdout。操作本身不复杂，但执行kubectl logs -f时，只返回日志首行就停止输出。

Pod定义 #

kind: Pod
metadata:
  name: logging-sidecar
  namespace: baz
spec:
  containers:
  - image: busybox
    name: logger
    command: ['sh', '-c', 'while true; do date > /output/output.log; sleep 5; done']
    volumeMounts:
    - name: share-vol
      mountPath: '/output'
  - image: busybox
    name: sidecar
    command: ['sh', '-c', 'tail -F /input/output.log']
    volumeMounts:
    - name: share-vol
      mountPath: '/input'
  volumes:
  - name: share-vol
    emptyDir: {}

实际运行命令 #

日志生成容器命令：

sh -c 'while true; do date > /output/output.log; sleep 5; done'

边车容器命令：

sh -c 'tail -F /input/output.log'

现象 #

将日志生成命令中的覆盖符号>改为追加符号>>后，一切正常，每5秒kubectl logs -f会显示新日志行。换用Alpine镜像的边车容器也存在相同问题，但换成Debian镜像则恢复正常，Debian下的输出如下：

Sat Sep 16 17:38:07 UTC 2023
tail: /input/output.log: file truncated
Sat Sep 16 17:38:12 UTC 2023
tail: /input/output.log: file truncated
Sat Sep 16 17:38:17 UTC 2023

原因分析 #

核心差异：Busybox tail vs GNU tail的截断处理 #

Busybox（包括Alpine使用的Busybox版本）的tail -F命令，与Debian使用的GNU tail在处理文件截断时行为不同：

• GNU tail的-F（等价于--follow=name --retry）会主动检测文件被截断的情况，自动重置读取偏移量到文件开头，输出新内容的同时还会打印file truncated提示。
• Busybox的tail -F仅处理文件被删除后重新创建的场景，当文件被覆盖（本质是先将文件长度截断为0，再写入新内容）时，它会继续从之前的偏移量等待新数据——但此时偏移量已经超出了截断后的文件长度，因此不会再输出任何内容。

使用>>追加模式正常的原因是：追加操作不会改变文件的inode，只是在文件末尾添加内容，文件长度持续递增，tail可以持续跟踪到新写入的数据，无需处理截断场景。

版本验证 #

Busybox v1.36.1的tail确实存在这个行为差异。你可以在Busybox容器内手动验证：

1. 创建测试文件并写入初始内容：echo "test1" > test.log
2. 启动tail跟踪：tail -F test.log
3. 另一个终端覆盖文件：echo "test2" > test.log
4. 此时Busybox的tail不会输出test2，而GNU tail则会正常输出并提示文件被截断。

解决办法 #

• 方案1（推荐）：修改日志生成命令为追加模式（>>），彻底避免文件截断的场景，这是最简单且高效的解决方式。
• 方案2：如果必须使用覆盖模式，可以调整边车容器的命令来适配Busybox的tail行为。例如：

  sh -c 'while true; do tail -n +1 /input/output.log; sleep 5; done'
  

  或者换用Debian/Ubuntu等使用GNU tail的镜像，利用其对文件截断的自动处理能力。

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