You need to enable JavaScript to run this app. 如何通过Kubernetes Python API获取就绪探针状态及失败详情
优惠活动
大模型
产品
解决方案
定价
更多

如何通过Kubernetes Python API获取就绪探针状态及失败详情

问题核心原因

你在kubectl describe pod输出里看到的带HTTP 404这类细节的探针失败信息,并不存储在Pod对象的状态字段里。
Pod的status.conditions只会返回布尔值形式的就绪状态结果,比如标记容器是否就绪、Pod是否调度完成,不会记录具体的探针失败原因、HTTP状态码、累计触发次数这类细节。这类带详细错误的信息本质是集群内的Warning级别事件,由节点上的kubelet在探针检查失败时生成,和目标Pod做关联绑定,这就是为什么普通查询Pod的接口拿不到详细信息的原因。

具体实现方法
  • 明确事件的匹配规则
    你需要的探针失败事件有固定的绑定特征:
  • 事件所在命名空间和目标Pod的命名空间一致
  • 事件关联的对象是目标Pod(即事件的involvedObject.kind为Pod,involvedObject.name为目标Pod名称)
  • 事件级别为Warning、Reason为Unhealthy,消息内容包含探针失败的具体描述
  • 调用事件查询API获取详细数据
    不要通过Pod对象的接口找详细信息,直接使用Python客户端CoreV1Api下的命名空间事件查询接口拉取关联事件,示例代码如下:
from kubernetes import client, config

# 加载集群访问配置,可根据环境切换为in_cluster_config
config.load_kube_config()
core_v1 = client.CoreV1Api()

# 目标查询参数
target_ns = "mynamespace"
target_pod = "mypodname"

# 拉取目标Pod关联的所有事件
related_events = core_v1.list_namespaced_event(
    namespace=target_ns,
    field_selector=f"involvedObject.kind=Pod,involvedObject.name={target_pod}"
)

# 筛选出探针失败类的警告事件
for event in related_events.items:
    if event.reason == "Unhealthy" and "probe failed" in event.message.lower():
        # 这里可以拿到和describe输出完全一致的所有字段
        print(f"事件类型:{event.type}")
        print(f"触发原因:{event.reason}")
        print(f"累计重复次数:{event.count}")
        print(f"最近触发时间:{event.last_timestamp}")
        print(f"首次触发时间:{event.first_timestamp}")
        print(f"错误详情:{event.message}")
        # 示例输出的message字段就会包含 "Readiness probe failed: HTTP probe failed with statuscode: 404" 这类完整错误
  • 批量查询的优化方案
    如果需要从已经通过list_pod_for_all_namespaces拿到的Pod列表出发批量获取探针信息,不需要逐Pod重复调用接口:可以直接调用list_event_for_all_namespaces接口,用field_selector="type=Warning,reason=Unhealthy"一次性拉取全集群所有和探针失败相关的事件,再按事件关联的Pod命名空间、名称做分组匹配,大幅减少接口调用次数。
注意事项
  • 集群内的事件默认有留存周期(通常为1小时),如果要查询数天前的历史探针失败记录,需要提前部署长期留存的事件收集组件,否则过期事件会被自动清理
  • 事件对象的字段和kubectl describe pod输出的列是一一对应的:count对应输出里括号内的重复触发次数,first_timestamp/last_timestamp对应时间统计范围,message对应错误详情报文,source对应生成事件的kubelet节点信息

内容的提问来源于stack exchange,提问作者feffe

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.03 06:54:07