KubePi 中查看失败 Pod 日志的解决方案

问题背景

在使用 KubePi 管理 Kubernetes 集群时，用户可能会遇到一个常见问题：当 Pod 启动失败时，无法通过 KubePi 界面完整查看 Pod 的日志输出。虽然 kubectl 命令行工具可以正常显示完整的日志内容，但 KubePi 的 Web 界面却只能显示部分日志，随后连接中断。

问题现象

具体表现为：

1. 对于正常运行的 Pod，KubePi 可以正常显示实时日志
2. 对于启动失败的 Pod，KubePi 只能显示部分日志（如只显示"start"），随后连接中断
3. 使用 kubectl logs 命令可以完整查看失败 Pod 的所有日志输出

问题分析

经过深入分析，这个问题与 KubePi 的 WebSocket 连接机制有关：

1. KubePi 通过 WebSocket 连接与 Kubernetes API 通信来获取 Pod 日志
2. 当 Pod 容器运行时，WebSocket 连接可以持续监听日志输出
3. 当 Pod 容器退出时，WebSocket 连接会中断
4. 在反向代理环境下（如使用 Nginx），如果没有正确配置 WebSocket 支持，会导致连接提前终止

解决方案

如果在 KubePi 前端使用了 Nginx 等反向代理，需要在 Nginx 配置中添加以下 WebSocket 支持配置：

location / {
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    # 其他代理配置...
}

这两行配置的作用是：

1. proxy_set_header Upgrade $http_upgrade - 将客户端的 Upgrade 头传递给后端
2. proxy_set_header Connection "upgrade" - 明确告知后端这是 WebSocket 升级连接

验证方法

部署一个简单的测试 Pod 来验证问题是否解决：

apiVersion: v1
kind: Pod
metadata:
  name: test-pod
spec:
  containers:
  - name: test-container
    image: busybox
    command: ["sh", "-c", "echo 'start'; sleep 1; echo '-----'; sleep 1; echo 'exit'; exit 1"]

正确配置后，KubePi 应该能够显示完整的日志输出：

start
-----
exit

总结

KubePi 作为 Kubernetes 的 Web 管理界面，依赖 WebSocket 来实现实时日志查看功能。在反向代理环境下，必须正确配置 WebSocket 支持，才能确保失败 Pod 的日志能够完整显示。这个问题与 Kubernetes 版本无关，主要取决于前端代理的配置是否正确。

对于系统管理员来说，了解 WebSocket 在反向代理环境中的特殊配置要求，是保证 KubePi 日志功能正常工作的关键。这一解决方案同样适用于其他基于 WebSocket 的 Kubernetes 管理工具。