Zabbix监控Kubernetes集群的完整配置流程

最新推荐文章于 2025-07-28 12:08:50 发布
最新推荐文章于 2025-07-28 12:08:50 发布
阅读量1.1k 收藏 10
点赞数 18
CC 4.0 BY-SA版权
文章标签： zabbix kubernetes 容器
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qaknar826/article/details/146998505

Zabbix监控Kubernetes集群的完整配置流程

前言

随着容器化技术的普及，Kubernetes已成为企业容器编排的事实标准。如何有效监控Kubernetes集群的健康状态、资源使用情况以及应用性能，成为运维团队面临的重要课题。本文将详细介绍使用Zabbix监控Kubernetes集群的完整配置流程，涵盖从基础环境准备到高级配置的全套方案。

一、环境准备

在开始配置前，需要确保以下环境已就绪：

  1. 正常运行中的Kubernetes集群（建议版本1.18+，以支持最新监控指标）
  2. 已部署的Zabbix Server（建议版本6.0+，支持更完善的Kubernetes监控功能）
  3. 集群管理员权限（用于创建ServiceAccount和授权）
  4. 网络连通性：Zabbix Server能够访问Kubernetes API（需开放6443端口）
  5. 确保kube-state-metrics组件已部署（提供详细的集群状态指标）

二、Kubernetes端配置

1. 创建监控专用ServiceAccount

apiVersion: v1
kind: ServiceAccount
metadata:
  name: zabbix-monitor
  namespace: kube-system
  labels:
    app: zabbix-monitoring

2. 创建ClusterRole授权

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: zabbix-monitor-role
  labels:
    app: zabbix-monitoring
rules:
- apiGroups: [""]
  resources:
  - nodes
  - nodes/stats
  - nodes/proxy
  - services
  - endpoints
  - pods
  - namespaces
  - persistentvolumes
  - persistentvolumeclaims
  verbs: ["get", "list", "watch"]
- apiGroups: ["extensions", "apps"]
  resources:
  - deployments
  - daemonsets
  - replicasets
  - statefulsets
  verbs: ["get", "list", "watch"]
- apiGroups: ["batch"]
  resources:
  - jobs
  - cronjobs
  verbs: ["get", "list", "watch"]
- apiGroups: ["metrics.k8s.io"]
  resources:
  - pods
  - nodes
  verbs: ["get", "list"]

3. 绑定ClusterRoleBinding

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: zabbix-monitor-rolebinding
  labels:
    app: zabbix-monitoring
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: zabbix-monitor-role
subjects:
- kind: ServiceAccount
  name: zabbix-monitor
  namespace: kube-system

4. 获取访问令牌

# 获取ServiceAccount关联的Secret名称
SECRET_NAME=$(kubectl -n kube-system get sa zabbix-monitor -o jsonpath='{.secrets[0].name}')

# 提取并解码token
kubectl -n kube-system get secret $SECRET_NAME -o jsonpath='{.data.token}' | base64 --decode

将输出的token值安全保存，后续Zabbix配置会用到。

三、Zabbix Server端配置

1. 安装Zabbix Kubernetes监控模板

从Zabbix官方GitHub下载最新Kubernetes模板：

wget https://raw.githubusercontent.com/zabbix/community-templates/main/Kubernetes/template_app_kubernetes.xml

通过Zabbix Web界面导入模板：

  1. 进入"Configuration" → “Templates”
  2. 点击"Import"
  3. 选择下载的template_app_kubernetes.xml文件
  4. 确认导入

2. 创建Kubernetes主机

  1. 登录Zabbix Web界面
  2. 进入"Configuration" → “Hosts”
  3. 点击"Create host"
  4. 填写主机信息：
    • Host name: Kubernetes-Cluster
    • Visible name: Kubernetes Production Cluster
    • Groups: Linux servers/Kubernetes
    • Interface: HTTP（填写Kubernetes API地址）
  5. 在"Templates"标签页添加"Template App Kubernetes"
  6. 在"Macros"标签页添加以下宏：
    • {$KUBE.API.URL}: https://:6443
    • {$KUBE.API.TOKEN}:
    • {$KUBE.CLUSTER.NAME}: production-cluster
    • {$KUBE.NAMESPACE.FILTER}: “default|kube-system” # 监控指定命名空间
    • {$KUBE.NODE.FILTER}: “worker-.*” # 节点名称过滤

3. 配置HTTPS证书（如需要）

对于自签名证书集群：

  1. 获取Kubernetes CA证书并转换为PEM格式：

    kubectl get secret -n kube-system $(kubectl -n kube-system get sa zabbix-monitor -o jsonpath='{.secrets[0].name}') -o jsonpath='{.data.ca\.crt}' | base64 --decode > /etc/zabbix/k8s-ca.pem

  2. 配置Zabbix Server信任该证书：

    sudo mkdir -p /etc/zabbix/ssl
sudo cp /etc/zabbix/k8s-ca.pem /etc/zabbix/ssl/
sudo chown zabbix:zabbix /etc/zabbix/ssl/k8s-ca.pem

  3. 在Zabbix Server配置中启用证书验证：

    SSLCAFile=/etc/zabbix/ssl/k8s-ca.pem
SSLVerifyHost=1
SSLVerifyPeer=1

四、监控项详解

成功配置后，Zabbix将自动发现并监控以下Kubernetes资源：

1. 集群级别监控

  • 节点数量及状态（Ready/NotReady）
  • API服务器响应时间和可用性
  • etcd存储性能指标
  • 集群资源容量和使用率（CPU/内存/存储）
  • 持久卷状态和使用情况
  • 集群事件监控

2. 节点级别监控

  • CPU使用率（用户/系统/空闲）
  • 内存使用量（包括缓存和缓冲区）
  • 磁盘I/O（读写吞吐量和延迟）
  • 网络流量（入站/出站带宽）
  • 运行中的Pod数量和资源占用
  • 节点温度（如物理服务器）
  • kubelet运行状态

3. 工作负载监控

  • Deployment副本状态（期望/可用/不可用）
  • StatefulSet分区更新状态
  • DaemonSet节点覆盖率
  • Pod状态（Running/Pending/Failed）
  • 容器资源使用（CPU/内存/文件描述符）
  • 容器重启次数
  • Job/CronJob执行状态

五、告警配置建议

建议配置以下关键告警规则：

1. 集群级别告警

  • 集群节点NotReady状态持续5分钟
  • API服务器响应时间>500ms
  • etcd存储空间使用率>80%
  • 集群资源分配接近上限（CPU>85%, 内存>90%）

2. 节点级别告警

  • 节点CPU负载>90%持续5分钟
  • 可用内存<10%
  • 根分区使用率>90%
  • 网络丢包率>1%
  • kubelet心跳丢失>3分钟

3. 工作负载告警

  • Pod CrashLoopBackOff状态
  • Deployment副本不可用>10%
  • StatefulSet副本不可用
  • Pod资源请求超过限制80%
  • 容器OOMKilled事件

配置示例（Zabbix触发器表达式）：

{Template App Kubernetes:kubernetes.state.pod.status{namespace="production",status="Failed"}.min(5m)}>0

六、高级配置

1. 自定义指标采集

通过Prometheus exporter采集：
  1. 在应用Pod中添加annotation：
annotations:
  prometheus.io/scrape: "true"
  prometheus.io/port: "8080"
  prometheus.io/path: "/metrics"
  prometheus.io/scheme: "http"
  1. 在Zabbix中创建HTTP Agent监控项：
    • URL: http://:8080/metrics
    • 类型: Text
    • 预处理: Prometheus pattern
    • 键值: prometheus.metric[metric_name]
通过Zabbix Trapper直接上报：
zabbix_sender -z zabbix.server -k "custom.metric" -o 42

2. 使用Zabbix Agent2实现深度集成

  1. 在Kubernetes节点上安装Zabbix Agent2：
helm install zabbix-agent2 zabbix/zabbix-agent2 \
  --set server="zabbix.server" \
  --set plugins.kubernetes.enabled=true \
  --set plugins.kubernetes.endpoint=https://kubernetes.default.svc \
  --set plugins.kubernetes.tokenFile=/var/run/secrets/kubernetes.io/serviceaccount/token
  1. 配置Agent2插件参数（/etc/zabbix/zabbix_agent2.conf）：
Plugins.Kubernetes.Endpoint=https://kubernetes.default.svc
Plugins.Kubernetes.TokenFile=/var/run/secrets/kubernetes.io/serviceaccount/token
Plugins.Kubernetes.Metrics.Interval=30s
Plugins.Kubernetes.LabelSelector=env=production

3. 监控数据可视化优化

  1. 创建自定义Dashboard：

    • 集群资源概览（节点状态、资源使用热力图）
    • 工作负载分布图（按命名空间/节点）
    • 性能趋势分析（CPU/内存历史曲线）
    • 异常事件时间线

  2. 配置聚合图形：

    • 节点资源矩阵视图
    • Pod生命周期状态图
    • 存储卷容量预测

七、常见问题排查

1. 连接Kubernetes API失败

  • 症状：Zabbix获取不到任何监控数据
  • 排查步骤：
    1. 手动测试API连通性：
      curl -k -H "Authorization: Bearer <token>" ${KUBE.API.URL}/api/v1/nodes
    2. 检查token有效期：
      kubectl get secret -n kube-system <secret-name> -o jsonpath='{.data.token}' | base64 --decode | jwt decode -
    3. 验证RBAC授权：
      kubectl auth can-i --as=system:serviceaccount:kube-system:zabbix-monitor list nodes

2. 监控数据不全

  • 症状：部分指标缺失
  • 解决方案：
    1. 检查kube-state-metrics是否正常运行：
      kubectl -n kube-system get pods -l app.kubernetes.io/name=kube-state-metrics
    2. 增加ServiceAccount权限：
      - apiGroups: ["metrics.k8s.io"]
  resources: ["*"]
  verbs: ["get", "list"]
    3. 调整Zabbix采集间隔（避免API限流）

3. 性能问题

  • 症状：Zabbix Server负载高
  • 优化建议：
    1. 对大型集群（>50节点）：
      • 按业务域拆分监控主机
      • 使用Zabbix Proxy进行分布式监控
    2. 调整发现规则频率：
      • 节点发现：1小时
      • Pod发现：30分钟
    3. 启用主动式监控模式
    4. 优化PromQL查询复杂度

结语

通过本文详细的配置指南，我们建立了完整的Kubernetes监控体系，实现了从基础设施到应用工作负载的全栈可视化管理。这套方案具有以下优势：

  1. 全面性：覆盖集群所有关键组件和指标
  2. 实时性：秒级监控数据采集和告警
  3. 可扩展性：支持自定义指标和业务监控
  4. 稳定性：经过生产环境验证的配置方案

后续可进一步扩展的方向包括：

  • 集成日志监控（通过ELK或Grafana Loki）
  • 实现基于AI的异常检测
  • 构建自动化修复工作流
  • 开发自定义监控看板和报表

通过持续优化监控体系，可以有效提升Kubernetes集群的稳定性和运维效率，为业务系统提供坚实保障。
- - . - - - - .

MenzilBiz
关注
kubernetes集群搭建Zabbix监控平台的详细过程
srebro.cn | 运维小弟
12-23 3708
kubernetes集群搭建Zabbix监控平台的详细过程
小阿轩yx-案例：Zabbix监控kubernetes云原生环境
2401_83435725的博客
09-15 1276
小阿轩yx-案例：Zabbix监控kubernetes云原生环境
Zabbix 6.0 深度监控Kubernetes实战｜Node-Pod-Service全链路监控
最新发布
2401_84202965的博客
07-28 490
Prometheus+Zabbix融合监控：兼顾实时性与历史数据分
kubernetes集群部署Zabbix监控平台
niwoxiangyu的博客
09-08 1564
Zabbix是一个基于Web界面的分布式系统监控的企业级开源软件。可以监视各种系统与设备的参数，保障服务器及设备的安全运营。
手把手教你实现zabbix对Kubernetes的监控
ChloeClockc的博客
12-03 3723
Zabbix 6.0 LTS新增Kubernetes监控功能，可以在Kubernetes系统从多个维度采集指标。我们今天就来实现Zabbix6.0对K8S的监控。
Zabbix实现监控Kubernetes
格子的博客
02-07 6131
网上监控 `Kubernetes` 的工具大部分是 `Promethues`，基本很少有关于 `Zabbix` 实现监控`Kubernetes` 的文章。`Zabbix 6.0 LTS` 新增 `Kubernetes` 监控功能，可以从 `Kubernetes` 系统从多个维度采集指标。我们通过这篇文章实现对 `Kubernetes` 的监控。
Zabbix 通过 API 监控 Kubernetes
民工哥的博客
05-13 766
点击下方公众号「关注」和「星标」回复“1024”获取独家整理的学习资料！监控方式：python+zabbix _sender原理：python的request库，请求k8s的api地址，对...
Kubernetes部署Zabbix监控系统
IT
06-20 1944
此外，由于 Zabbix 可以调用任何 HTTP 端点，因此它可以监视没有专用 Prometheus 端点的应用程序，这与 Prometheus 不同。只有 Zabbix proxy 需要访问 Zabbix server，而代理可以将数据发送到安装在与每个代理相同的命名空间中的代理。而将Zabbix与Kubernetes结合，可以实现对Kubernetes集群的全面监控，从而提高集群的可观察性和管理效率。在大多数情况下，您将使用已安装的代理，而不是直接使用服务器或集群外部的代理。我们应该能够通过指向。
Zabbix监控K8s集群
weixin_63294004的博客
03-26 1471
后续也可以对接Grafana进行更直观的图形化展示。t=P1C7。
使用zabbix监控k8s
s9434的博客
11-28 1787
wget https://get.helm.sh/helm-v3.8.1-linux-amd64.tar.gz ##此处可以更改版本，如wget https://get.helm.sh/helm-v3.8.1-linux-amd64.tar.gz。进入之后会显示包，自己根据自己的k8s版本选择，我的k8s版本是1.17的，很老的版本，所以选的chart也比较老，是6.0目录下的1.0.0版本的。1.kube-state-metrics给定的cpu和内存太小，导致容器一直重启，OOMKILLED。
2024年【软件测试】探索和学习SDLC与软件测试的关系，顺利通过阿里软件测试岗面试
2401_84563734的博客
05-08 765
Testing is part of every stage in modern SDLC models. (整合：在现代SDLC模型的每个阶段，测试都是一个组成部分。
zabbix6.4配置监控k8s 1.28集群
zhangpfly的博客
09-03 2284
zabbix6.4配置监控k8s集群
k8s集群部署zabbix监控
lucky_ykcul的博客
10-21 4524
前面已经完成了k8s集群环境的搭建部署，也实现了创建pod，service等服务，本文开始介绍如何在k8s集群中部署应用。这里以zabbix监控为例。 部署MySQL zabbix监控需要使用MySQL来存储数据 1.创建MySQL的部署文件 [root@server1 zabbix]# vim mysql.yml ...
Zabbix监控K8S集群及普通节点安装配置文档
打杂的运维
07-01 881
本文档详细介绍了Zabbix监控K8S集群及普通节点的安装配置流程。主要内容包括：环境准备（服务器、K8S集群、网络要求）、Zabbix Server部署步骤（仓库安装、组件配置、数据库设置）、K8S监控的两种方案（Node Exporter或直接调用API）、普通节点的Agent配置方法，以及常见问题解决方案（如证书验证失败、资源超限等）。文档还提供了监控模板配置建议和可视化看板示例，并推荐启用HA功能保障高可用性。通过该方案可实现从基础设施到容器集群的完整监控体系。
Zabbix 通过 API 监控 k8s
qq_40907977的博客
08-03 2776
监控方式：python+zabbix _sender 原理：python的request库，请求k8s的api地址，对数据处理。 第一步：获取k8s的api地址 查看K8S的api地址的命令如下（ 最好在K 8s 集群的master上执行这条命令 ，因为如果在node节点上执行该命令有可能会获取旧的api地址） 第二步：K8S集群的Master主机生成一个token用来认证，请求数据api数据 生成令牌命令如下（在K 8S 的Master主机执行命令） kubectl -n kube-system des
[技术干货] Zabbix通过api监控k8s
乐维社区的博客
06-22 1397
监控方式：python+zabbix_sender 原理：python的request库，请求k8s的api地址，对数据处理。 第一步：获取k8s的api地址 查看K8S的api地址的命令如下（最好在K8s集群的master上执行这条命令，因为如果在node节点上执行该命令有可能会获取旧的api地址） 第二步：K8S集群的Master主机生成一个token用来认证，请求数据api数据 生成令牌命令如下（在K8S的Master主机执行命令） kubectl -n kube-system describe s
zabbix系列： K8S监控告警
NIO4444
03-16 1298
监控方法： 扩展 JS查找 https://www.zabbix.com/documentation/4.2/manual/appendix/items/jsonpath
Prometheus监控kubernetes集群有几种方法
03-25
A：在Kubernetes中，有多种...3. 使用第三方监控工具：除了Kubernetes原生的监控工具和Prometheus之外，还可以使用其他的第三方监控工具，如Sysdig、InfluxDB、Zabbix等，可以根据自己的需求来选择适合自己的监控工具。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值