Kubernetes 应用调试：如何确定 Pod 失败原因-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00961/article/details/148549422

Kubernetes 应用调试：如何确定 Pod 失败原因

website Kubernetes website and documentation repo: 项目地址: https://gitcode.com/gh_mirrors/webs/website

前言

在 Kubernetes 集群中运行应用时，Pod 可能会因为各种原因失败。作为开发者或运维人员，我们需要快速准确地定位问题原因。本文将详细介绍如何通过容器的终止消息（Termination Message）机制来诊断 Pod 失败的原因，并分享一些实用技巧。

终止消息机制简介

终止消息是 Kubernetes 提供的一种诊断机制，允许容器在退出前将关键信息写入特定位置。这些信息对于调试和监控至关重要，通常包含：

容器退出的原因
最后的错误状态
重要的诊断信息

与常规日志不同，终止消息是专门为记录致命错误而设计的结构化信息，可以被监控系统和仪表板直接读取和展示。

基础使用示例

让我们通过一个实际例子来理解终止消息的工作原理。

示例 Pod 配置

apiVersion: v1
kind: Pod
metadata:
  name: termination-demo
spec:
  containers:
  - name: termination-demo-container
    image: debian
    command: ["/bin/sh"]
    args: ["-c", "sleep 10 && echo 'Sleep expired' > /dev/termination-log"]

这个配置定义了一个 Pod，其中的容器会：

休眠 10 秒
将"Sleep expired"写入终止消息文件
然后正常退出

操作步骤

创建 Pod：
```
kubectl apply -f termination.yaml
```
检查 Pod 状态：
```
kubectl get pod termination-demo
```

查看详细终止信息：

kubectl get pod termination-demo -o yaml

在输出结果中，你可以在status.containerStatuses.lastState.terminated.message字段看到我们写入的"Sleep expired"消息。

高级查询技巧

对于更复杂的场景，我们可以使用 Go 模板来精确提取我们需要的信息。

单容器 Pod 的消息提取

kubectl get pod termination-demo -o go-template="{{range .status.containerStatuses}}{{.lastState.terminated.message}}{{end}}"

多容器 Pod 的消息提取

kubectl get pod multi-container-pod -o go-template='{{range .status.containerStatuses}}{{printf "%s:\n%s\n\n" .name .lastState.terminated.message}}{{end}}'

这种方法特别有用当你的 Pod 包含多个容器时，可以清楚地看到哪个容器出了问题。

自定义终止消息配置

Kubernetes 提供了灵活的配置选项来自定义终止消息的行为。

自定义消息文件路径

默认情况下，Kubernetes 会查找/dev/termination-log文件。你可以通过terminationMessagePath字段修改这个路径：

apiVersion: v1
kind: Pod
metadata:
  name: custom-path-demo
spec:
  containers:
  - name: custom-path-container
    image: debian
    terminationMessagePath: "/tmp/my-custom-log"

后备日志策略

当终止消息文件为空时，可以配置 Kubernetes 使用容器日志的最后部分作为终止消息：

apiVersion: v1
kind: Pod
metadata:
  name: fallback-policy-demo
spec:
  containers:
  - name: fallback-container
    image: debian
    terminationMessagePolicy: FallbackToLogsOnError

注意这个策略只在容器以错误状态退出时生效。