kube-opex-analytics Docker镜像文档

镜像概述和主要用途

kube-opex-analytics（字面意为"Kubernetes运营支出分析"）是一款Kubernetes资源使用计费与分析工具，用于帮助组织跟踪Kubernetes集群资源随时间（小时、日、月）的消耗情况。其核心用途是通过提供洞察性的使用分析指标和图表，助力工程与财务团队掌握关键指标，从而做出合理的成本优化决策，避免过度付费。

核心功能和特性

1. 按命名空间的使用计费与趋势分析

支持评估各命名空间在不同时间段（小时、日、月）的资源容量消耗情况，清晰呈现资源使用趋势。

2. 不可分配容量的计费

在节点和集群级别，跟踪并汇总不可分配容量的占比，并与可用容量（即实际应用工作负载使用的容量）进行对比展示。不可分配容量专用于Kubernetes运维（操作系统、kubelet等），与可用容量区分统计。

3. 集群使用计费与容量规划

提供集群级别的资源消耗全局视图，支持即时及历史容量消耗的统计与可视化，简化容量规划流程。

4. 使用/请求效率分析

基于小时汇总趋势，对比资源请求与实际使用情况，帮助评估Kubernetes工作负载的资源请求设置效率。

5. 成本分配与回收分析

自动处理并可视化按命名空间的日度和月度资源使用计费数据，支持成本回收场景。

6. 洞察性与可扩展的可视化

内置分析仪表板，并提供原生Prometheus导出器，可将分析指标暴露给Grafana等第三方可视化工具。

使用场景和适用范围

适用场景

• Kubernetes集群资源成本优化：通过跟踪资源使用趋势和效率，识别过度分配或未充分利用的资源，指导成本削减。
• 多团队资源分配跟踪：按命名空间统计资源消耗，适用于多团队共享集群场景，明确各团队资源占用情况。
• 容量规划与扩展决策：基于集群级历史使用数据，预测未来资源需求，辅助制定合理的集群扩容或缩容策略。
• 资源请求效率评估：分析工作负载资源请求与实际使用的差距，优化Pod资源请求配置，提升集群资源利用率。
• 成本回收与内部结算：按命名空间生成日/月度资源使用报告，支持内部成本回收或团队资源计费。

适用对象

• 工程团队：优化应用资源配置，提升部署效率。
• 财务团队：跟踪云资源支出，制定成本控制策略。
• DevOps/SRE团队：监控集群健康状态，进行容量规划。
• 平台团队：管理多团队共享集群的资源分配与计费。

使用方法

Docker部署

基础部署（docker run）

docker run -d \
  --name kube-opex-analytics \
  -p 8080:8080 \
  -v /path/to/local/data:/data \
  rchakode/kube-opex-analytics

参数说明：

• -p 8080:8080：映射容器8080端口到主机，用于访问Web UI和API。
• -v /path/to/local/data:/data：挂载本地目录持久化存储分析数据（建议配置，避免容器重启后数据丢失）。

Docker Compose配置示例

version: '3'
services:
  kube-opex-analytics:
    image: rchakode/kube-opex-analytics
    container_name: kube-opex-analytics
    ports:
      - "8080:8080"
    volumes:
      - ./data:/data  # 本地数据持久化
    environment:
      - KUBE_API_URL=[***]  # 若容器外访问K8s API需指定
      - DATA_RETENTION_DAYS=30  # 数据保留天数，默认30天
      - REFRESH_INTERVAL=3600  # 数据刷新间隔（秒），默认3600秒（1小时）
    restart: unless-stopped

访问与使用

Web UI访问

部署后，通过 http://<主机IP>:8080 访问内置分析仪表板，查看命名空间资源趋势、集群容量使用、成本分配等可视化图表。

Prometheus导出器

默认启用Prometheus导出器，指标暴露于 http://<主机IP>:8080/metrics，可配置Prometheus抓取该端点，并结合Grafana创建自定义仪表盘。

配置参数说明

环境变量配置

配置文件

支持通过挂载配置文件 /etc/kube-opex-analytics/config.yaml 进行高级配置，详细配置项可参考***配置文档。

支持与贡献

• 问题反馈：通过GitHub Issues提交bug报告或功能建议。
• 代码贡献：通过Pull Request提交代码补丁或新功能，贡献需遵循Apache 2.0许可证。
• 文档参考：更多设计原理与高级用法，请参阅***文档。

许可证：Apache License 2.0（代码与文档），第三方依赖库遵循各自许可证条款。