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

背景介绍

Eclipse Che作为云原生IDE平台，其服务端和DevWorkspace组件的运行状态监控对运维至关重要。在Kubernetes环境中，Prometheus是最常用的监控方案之一。本文将详细介绍如何在非OpenShift的Kubernetes环境中配置Eclipse Che的指标暴露与采集。

核心组件监控架构

1. 监控对象

• Che Server组件：提供IDE后端的核心服务
• DevWorkspace Controller：管理工作空间生命周期的关键组件
• 工作空间Pod：用户实际开发环境的运行实例

2. 指标暴露机制

各组件通过HTTP端点暴露Prometheus格式的指标数据：

• Che Server默认暴露在/metrics路径
• DevWorkspace Controller提供/metrics端点
• 工作空间Pod可通过Sidecar模式注入指标收集器

配置实施步骤

1. 服务账户令牌准备

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

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

2. 基础监控方案（无Operator）

指标端点发现

通过创建Service指向各监控目标：

apiVersion: v1
kind: Service
metadata:
  name: che-metrics
  labels:
    app: che
spec:
  ports:
  - name: metrics
    port: 8080
    targetPort: 8080
  selector:
    app: che

Prometheus配置示例

在prometheus.yml中添加静态抓取配置：

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

3. 高级方案（使用Prometheus Operator）

ServiceMonitor配置

创建ServiceMonitor CRD资源：

apiVersion: monitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
  name: che-monitor
spec:
  endpoints:
  - port: metrics
  selector:
    matchLabels:
      app: che

RBAC配置

确保Prometheus有权限访问目标命名空间：

apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  name: prometheus-k8s
rules:
- apiGroups: [""]
  resources: ["services", "pods"]
  verbs: ["get", "list", "watch"]

指标可视化方案

推荐Grafana仪表板

1. DevWorkspace监控看板：

   • 工作空间创建成功率
   • 控制器处理延迟
   • 资源配额使用率

2. Che Server监控看板：

   • API请求成功率
   • 用户会话数
   • 插件加载耗时

仪表板持久化方案

建议通过ConfigMap方式部署Grafana仪表板，确保重启后配置不丢失：

apiVersion: v1
kind: ConfigMap
metadata:
  name: grafana-dashboards
data:
  che-dashboard.json: |
    { ...dashboard JSON... }

常见问题排查

1. 指标端点无法访问：

   • 检查ServiceAccount令牌是否有效
   • 验证网络策略是否允许Prometheus访问目标Pod

2. 指标数据缺失：

   • 确认各组件已启用指标暴露功能
   • 检查Prometheus抓取间隔配置

3. 权限问题：

   • 确保ServiceMonitor所在命名空间有正确RBAC配置
   • 验证ClusterRoleBinding是否绑定到正确的ServiceAccount

最佳实践建议

1. 生产环境建议：

   • 使用Prometheus Operator简化管理
   • 为Che组件单独配置监控命名空间
   • 设置合理的告警规则

2. 性能考量：

   • 调整抓取间隔平衡实时性和资源消耗
   • 对历史数据配置适当的保留策略

3. 安全建议：

   • 限制/metrics端点的访问权限
   • 为监控通信配置TLS加密

通过以上方案，可以在标准Kubernetes环境中建立完整的Eclipse Che监控体系，实现对平台运行状态的全面掌控。实际部署时，建议根据集群规模和性能需求调整相关参数。