Eclipse Che在Kubernetes集群中实现监控指标采集的技术实践

背景概述

Eclipse Che作为云原生开发环境平台，其服务端和DevWorkspace组件的运行状态监控对运维至关重要。在Kubernetes环境中，通常需要借助Prometheus实现指标采集，但官方文档主要面向OpenShift环境，本文针对原生Kubernetes环境提供完整解决方案。

核心组件监控架构

1. 指标暴露机制：

   • Che Server通过/metrics端点暴露JVM和业务指标
   • DevWorkspace Operator提供控制器相关指标
   • 各组件均采用Prometheus标准格式

2. 数据采集层：

   • Prometheus Server作为采集中枢
   • 可选搭配Grafana实现可视化

Kubernetes环境下的配置要点

服务账户令牌处理

在Kubernetes 1.24+版本中，由于默认不再自动生成传统ServiceAccount令牌，需要手动创建Secret：

apiVersion: v1
kind: Secret
type: kubernetes.io/service-account-token
metadata:
  name: devworkspace-controller-serviceaccount-token
  annotations:
    kubernetes.io/service-account.name: devworkspace-controller-serviceaccount

指标采集配置

对于非Operator部署的Prometheus，需要配置scrape_configs：

scrape_configs:
  - job_name: 'che-metrics'
    kubernetes_sd_configs:
      - role: endpoints
    relabel_configs:
      - source_labels: [__meta_kubernetes_service_label_app]
        action: keep
        regex: che

典型监控指标分类

1. 系统资源类：

   • 容器CPU/内存使用率
   • Pod重启次数
   • 网络吞吐量

2. 业务指标类：

   • 工作空间创建成功率
   • 用户活跃会话数
   • API请求延迟

3. JVM运行时：

   • 堆内存使用情况
   • GC次数和时间
   • 线程池状态

生产环境建议

1. 指标采样频率建议设置为15-30秒
2. 为监控组件配置适当的资源限制
3. 考虑使用Prometheus的远程写入功能对接长期存储
4. 关键指标应配置告警规则

排错指南

当出现指标不可见时，建议检查：

1. 服务端点是否正常暴露/metrics
2. 网络策略是否允许Prometheus访问
3. 服务账户权限配置是否正确
4. Prometheus服务发现配置是否匹配

通过以上方案，可以在原生Kubernetes环境中建立完整的Eclipse Che监控体系，为平台稳定性提供有力保障。