容器与云原生 / 系统课时
查看容器日志
查看容器日志
容器日志是定位应用启动、请求处理和异常退出的第一手证据。本课将用 kubectl logs 查看单容器、多容器及重启前日志,并掌握实时跟踪和范围过滤方法。
学习目标
- 能查看 Pod 中指定容器的当前日志
- 能用行数、时间和实时跟踪参数缩小日志范围
- 能读取容器上一次实例的日志并判断重启原因
准备可观察的多容器 Pod
下面的示例创建一个持续输出日志的 app 容器,以及一个退出后被自动重启的 worker 容器。保存为 log-demo.yaml 后应用到集群。
apiVersion: v1
kind: Pod
metadata:
name: log-demo
spec:
restartPolicy: Always
containers:
- name: app
image: busybox:1.36
command:
- sh
- -c
- |
i=0
while true; do
echo "app request=$i"
i=$((i + 1))
sleep 5
done
- name: worker
image: busybox:1.36
command:
- sh
- -c
- |
echo "worker boot"
sleep 8
echo "worker failed"
exit 1执行创建命令:
kubectl apply -f log-demo.yaml预期输出:
pod/log-demo created等待约二十秒后,worker 会出现重启。实际重启次数会随等待时间变化。
查看当前容器日志
单容器 Pod 可以直接执行 kubectl logs <pod>;多容器 Pod 必须使用 -c 指定容器。下面只读取 app 最近三行日志,避免一次返回过多内容。
kubectl logs pod/log-demo -c app --tail=3预期输出:
app request=<ID>
app request=<ID>
app request=<ID>--tail 按行截取;--since=10m 只读取最近十分钟;--since-time=<TIME> 从指定 RFC 3339 时间开始。排查持续发生的问题时,可增加 -f 实时跟踪,按 Ctrl+C 停止。
kubectl logs pod/log-demo -c app --since=30s -f预期输出:
app request=<ID>
app request=<ID>实时跟踪会继续输出新日志,因此行数和持续时间取决于实际运行情况。
读取重启前日志
容器重启后,普通 kubectl logs 默认读取当前实例。要查看上一次已终止实例的输出,需要增加 --previous,这对 CrashLoopBackOff 排查尤其重要。
kubectl logs pod/log-demo -c worker --previous预期输出:
worker boot
worker failed如果容器从未重启,命令会提示找不到前一个已终止实例。此时先执行 kubectl get pod log-demo 查看 RESTARTS,再判断是否应使用 --previous。
常用过滤与边界
日志内容来自容器标准输出和标准错误,不会自动读取容器内任意日志文件。应用若只把日志写入文件,kubectl logs 可能为空,应优先让应用输出到标准流,或使用日志采集代理读取文件。
为便于定位,可组合使用以下参数:--timestamps 为每行增加时间戳,--prefix 标识 Pod 与容器来源,-l app=demo 按标签选择多个 Pod,--max-log-requests 限制并发读取数量。多副本场景还应注意日志顺序并不代表全局事件顺序。
清理示例
kubectl delete pod log-demo预期输出:
pod "log-demo" deleted