详细剖析Kubernetes安装时系统日志的查看与分析方法

大宇君_3789

大宇君_3789

2026-09-28

848人浏览

原创

先看 systemctl status kubelet 获取退出码和主进程信息,再用 journalctl -u kubelet --since "1 hour ago" -n 100 --no-pager 查最近日志;重点排查证书、cgroup驱动、容器运行时socket路径、selinux及配置文件一致性问题。

详细剖析kubernetes安装时系统日志的查看与分析方法

安装 Kubernetes 时出错,90% 的问题能直接从系统日志里定位;但盲目 journalctl -u kubelet 或翻 /var/log/kubelet.log 往往白费时间——关键不是“看哪里”,而是“按什么顺序看、带什么上下文看”。

查 kubelet 启动失败:先看 systemd 单元状态,再追 journalctl 输出

安装后 kubelet 无法启动(systemctl status kubelet 显示 failed 或 activating (start) 卡住),不能直接跳进日志海。必须分两步:

  • 运行 systemctl status kubelet,重点看最后一行的 “Process: XXX ExecStart=…” 和紧随其后的 “Main PID” 及退出码(如 code=exited, status=255)
  • 用 journalctl -u kubelet --since "1 hour ago" -n 100 查最近 100 行,加 --no-pager 避免分页干扰;若看到 failed to run Kubelet: unable to load client CA file 或 failed to validate cluster CIDR,说明配置文件(/var/lib/kubelet/config.yaml)或证书路径有硬伤
  • 常见陷阱:kubeadm init 后未执行 systemctl daemon-reload && systemctl restart kubelet,导致 kubelet 仍读旧配置;或 SELinux 处于 enforcing 模式却没配置策略,journalctl 里会出现 avc: denied 但被滚动刷走

查容器运行时不就绪:聚焦 cgroup 和 socket 路径错误

kubelet 日志中反复出现 failed to run Kubelet: failed to get docker info 或 failed to connect to containerd: failed to dial...,本质是运行时集成失败。这不是 kubelet 自身 bug,而是环境适配问题:

Kubernetes Security Posture Scorecard
Kubernetes Security Posture Scorecard

评估 Kubernetes 集群安全态势,覆盖 RBAC、工作负载安全、网络策略、基础设施即代码(IaC)、运行时监控和密钥管理等 30 项控制项……

下载
  • 确认运行时 socket 路径是否匹配:containerd 默认用 /run/containerd/containerd.sock,但某些发行版(如 CentOS Stream 9)可能用 /run/crio/crio.sock;检查 kubelet 启动参数里的 --container-runtime-endpoint 值(可通过 ps aux | grep kubelet 提取)
  • cgroup 驱动不一致会静默失败:kubelet 默认用 systemd,而 containerd 配置为 cgroupfs,此时 journalctl 里只有一句 failed to initialize top-level QoS containers,毫无指向性;必须核对 /etc/containerd/config.toml 中 [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc.options] 下的 SystemdCgroup = true
  • 若用 Docker,注意它在 2024 年后已不被 kubeadm 官方支持;即使强行启用,docker info 输出中若无 Cgroup Driver: systemd 字样,kubelet 必报错

查 kubeadm init 卡在 preflight 或 control-plane 环节:过滤 WARNING 和 [ERROR] 行

kubeadm init 卡住时,控制台只显示进度条,真正线索藏在 /var/log/kubelet.log 或 journalctl 的原始流里。别信 “waiting for the control plane to become ready” 这类提示:

  • 用 journalctl -u kubelet -f | grep -E "(WARNING|ERROR|\[.*\])" 实时过滤;高频错误包括:[ERROR FileAvailable--etc-kubernetes-manifests-kube-apiserver.yaml](manifest 目录权限不对)、[ERROR Port-10250](端口被占用)、[WARNING SystemVerification](内核参数 net.bridge.bridge-nf-call-iptables 未启用)
  • pre-flight 检查失败不会写入 kubelet 日志,而是在 kubeadm init 进程 stdout/stderr 中输出;若用脚本后台运行,务必加 2>&1 | tee install.log 捕获
  • init 后 etcd 不起来?查 journalctl -u etcd(不是 kubelet!),常见原因是 /var/lib/etcd 目录属主不是 etcd 用户,或磁盘 inode 耗尽(journalctl 里会报 write /var/lib/etcd/member/snap/db: no space left on device,但实际是 inodes 满)

查节点 NotReady:区分 kubelet 健康但 node condition 异常

安装完成后 kubectl get nodes 显示 NotReady,不代表 kubelet 挂了——它可能完全健康,只是没上报正确状态。此时 journalctl -u kubelet 里全是正常心跳日志,反而误导人:

  • 先运行 kubectl describe node <node-name></node-name>,看 Conditions 区域:若 Ready=False 但 KubeletReady=True,说明问题出在 CNI 插件(如 Calico、Cilium)未就绪,而非 kubelet 本身
  • 检查 CNI pod 是否 Running:kubectl get pods -n kube-system | grep -E "(calico|cilium|kube-flannel)";若 Pending,大概率是镜像拉不到(kubectl describe pod 看 Events)或 RBAC 权限缺失(journalctl -u kubelet 里会有 Forbidden 请求记录)
  • 一个易忽略点:kubeadm init 时指定的 --pod-network-cidr 必须和 CNI 插件配置严格一致;比如 Calico 要求 192.168.0.0/16,你填了 10.244.0.0/16,节点永远卡在 NetworkUnavailable=True

最复杂的不是命令怎么写,而是日志里哪一行该信、哪一行是噪音——比如 kubelet 启动时大量 NodeStatusUpdateFrequency 日志是正常轮询,而同一行里混着的 failed to list *v1.Pod: Unauthorized 才是致命线索。盯日志时,永远先锁定错误关键词,再回溯前 3 行上下文,而不是从头滚屏。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Golang云原生微服务Kubernetes_Golang怎么集成Kubernetes开发云原生服务
Golang云原生微服务Kubernetes_Golang怎么集成Kubernetes开发云原生服务

Golang云原生微服务Kubernetes (K8s) 是指 使用 Go 语言(Golang)编写的云原生微服务,并利用 Kubernetes 平台进行容器化部署、自动化管理、弹性伸缩和高效编排的一整套现代应用架构方案。

2025.12.22

116

5

Go云原生应用与Kubernetes服务部署实战
Go云原生应用与Kubernetes服务部署实战

本专题围绕 Go 语言在云原生环境中的应用展开,讲解容器化部署、Kubernetes 编排、服务发现、健康检查与弹性扩缩容机制。通过真实云端案例,帮助开发者构建可扩展的云原生微服务架构。

2026.06.29

168

19

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

140

15

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

2026.09.23

80

15

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

2026.09.23

60

15

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

2026.09.22

40

12

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

2026.09.22

60

13

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

2026.09.22

40

19

loomy官网入口地址合集
loomy官网入口地址合集

本专题汇总了 Loomy 桌面 AI 助理的官方入口地址合集及使用指南。提供 macOS 与 Windows 客户端下载 。Loomy 是讯飞推出的桌面级 AI 工作搭子,支持文件整理、数据分析、网页操作及通过飞书/钉钉远程操控电脑,助你高效完成本地办公任务 。

2026.09.22

40

19

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kubernetes官方教程手册
Kubernetes官方教程手册

共0课时 | 0人学习

Kubernetes官方中文文档
Kubernetes官方中文文档

共0课时 | 0人学习