kubectl logs - Kubernetes Pod 日志查看命令

kubectl logs 是 Kubernetes 命令行工具中用于查看 Pod 和容器日志的核心命令，允许用户实时监控、筛选和分析应用程序的运行日志，是故障排查和系统监控的重要工具。

语法格式

kubectl logs [OPTIONS] POD_NAME [-c CONTAINER_NAME] [flags]

选项参数

选项	描述	示例
-f / --follow	实时跟踪日志输出（类似 tail -f）	kubectl logs -f my-pod
-c / --container	指定多容器 Pod 中的容器名称	kubectl logs my-pod -c nginx
--tail=N	仅显示最后 N 行日志（默认显示全部）	kubectl logs --tail=100 my-pod
--since=TIME	显示指定时间范围内的日志（如 5s、2m、1h）	kubectl logs --since=1h my-pod
--since-time=TIMESTAMP	显示指定时间点之后的日志（RFC3339 格式）	kubectl logs --since-time=2023-10-01T12:00:00Z
-p / --previous	查看已终止容器的日志（如崩溃重启前的日志）	kubectl logs -p my-pod
--timestamps	在每行日志前添加时间戳	kubectl logs --timestamps my-pod
--all-containers	查看 Pod 中所有容器的日志（多容器 Pod）	kubectl logs --all-containers=true my-pod
-l / --selector	根据标签选择器查看匹配 Pod 的日志	kubectl logs -l app=nginx
--limit-bytes	限制输出日志的最大字节数	kubectl logs --limit-bytes=1024 my-pod

经典应用场景

1. 基础日志查看

# 查看单个 Pod 的日志（Pod 只有一个容器时）
kubectl logs my-nginx-pod

# 查看指定命名空间中 Pod 的日志
kubectl logs my-nginx-pod -n production

# 查看多容器 Pod 中特定容器的日志
kubectl logs my-app-pod -c nginx-container

2. 实时日志监控与时间筛选

# 实时跟踪日志输出（用于监控应用运行状态）
kubectl logs -f my-app-pod

# 查看最近一小时的日志
kubectl logs my-app-pod --since=1h

# 查看最近20条日志并添加时间戳
kubectl logs my-app-pod --tail=20 --timestamps

# 查看指定时间点之后的日志
kubectl logs my-app-pod --since-time=2023-10-01T12:00:00Z

3. 故障排查场景

# 查看崩溃重启前的容器日志（用于诊断 CrashLoopBackOff）
kubectl logs my-pod --previous

# 通过标签选择器查看相关 Pod 的日志
kubectl logs -l app=nginx --tail=50

# 结合 grep 过滤错误日志
kubectl logs my-app-pod | grep -i "error"

# 查看多容器 Pod 的所有容器日志
kubectl logs --all-containers=true my-app-pod

4. 日志导出与批量处理

# 将日志导出到文件
kubectl logs my-app-pod > app-pod.log

# 批量导出多个 Pod 的日志（使用循环）
kubectl get pods -n production | grep "app-frontend" | awk '{print $1}' | while read pod; do
    kubectl logs -n production --since=30m $pod >> frontend-pods.log
done

高级工具与集成

1. 使用 Stern 进行多 Pod 日志聚合

# 安装 Stern（Linux/macOS）
brew install stern  # 或通过其他包管理器安装

# 实时查看所有匹配标签的 Pod 日志
stern "app=nginx" -n production --tail 100

# Stern 支持正则表达式和彩色输出，便于区分不同 Pod

2. 使用 Kubetail 工具

# Kubetail 是一个 Shell 脚本，可合并多个 Pod 的日志
kubetail my-app -n production

3. 与日志聚合系统集成

对于生产环境，建议结合 EFK（Elasticsearch、Fluentd、Kibana）或 Loki+Grafana 等日志聚合系统，实现日志的集中存储、查询和分析。

注意事项

1. 容器状态要求：kubectl logs 只能查看运行中或近期终止的容器的日志。对于已长时间删除的 Pod，无法获取日志。

2. 多容器 Pod：当 Pod 包含多个容器时，必须使用 -c 参数指定容器名，或使用 --all-containers 查看所有容器日志。

3. 日志驱动限制：日志的可用性和保存时间受 Docker 日志驱动配置影响，如果配置了日志轮转，可能无法获取完整历史日志。

4. 时区问题：使用 --since-time 时注意时间格式为 UTC（0 时区），与本地时间可能存在时差。

5. 资源消耗：长时间使用 -f 参数实时跟踪日志可能占用较多资源，生产环境中应谨慎使用。

6. 权限要求：执行日志查看命令需要具有对应命名空间和 Pod 的读取权限。

通过灵活组合这些参数和技巧，kubectl logs 可以成为 Kubernetes 应用监控和故障排查的强大工具。对于复杂的生产环境，建议结合日志聚合系统实现更完善的日志管理方案。