Astronomer Platform Kubernetes State Metrics 镜像文档

镜像概述

本镜像专为Astronomer平台设计，核心功能是暴露Kubernetes集群的状态指标，支持对Astronomer平台运行状态的监控、分析与故障排查。通过标准化的指标输出，可无缝集成到监控系统中，为平台运维提供数据支持。

核心功能与特性

核心功能

• 采集并暴露Kubernetes集群状态指标，包括但不限于：
  • 集群资源使用情况（CPU、内存、存储）
  • 节点、Pod、Deployment等资源对象的健康状态
  • 控制器（如StatefulSet、DaemonSet）的运行状态
  • 容器生命周期事件与资源限制

特性

• 平台兼容性：与Astronomer平台各版本深度适配，确保指标与平台组件协同一致
• 指标标准化：遵循Prometheus指标规范，支持主流监控系统（Prometheus、Grafana等）直接抓取
• 低资源占用：轻量化设计，对Kubernetes集群性能影响极小
• 配置灵活：支持通过环境变量或配置文件自定义指标采集范围与频率

使用场景与适用范围

适用场景

• Astronomer平台运行状态实时监控
• 集群资源瓶颈分析与优化
• 平台部署异常自动告警触发
• 历史性能数据统计与趋势分析

适用范围

• 运行Astronomer平台的Kubernetes集群环境（Kubernetes 1.19+）
• 需要对Astronomer平台进行精细化监控的DevOps团队
• 负责Astronomer平台运维的平台管理员

使用方法与配置说明

前置条件

• 已部署Kubernetes集群（版本1.19+）
• 集群内已运行Astronomer平台
• 具备集群管理员权限（用于获取指标采集所需的API访问权限）

Docker运行命令示例

bash
docker run -d \
  --name astronomer-k8s-metrics \
  -v /path/to/kubeconfig:/etc/kube/config \  # 挂载Kubernetes配置文件
  -p 9102:9102 \  # 暴露指标监听端口
  -e KUBE_CONFIG_PATH=/etc/kube/config \  # 指定Kubernetes配置文件路径
  -e METRICS_PORT=9102 \  # 设置指标暴露端口
  -e SCRAPE_INTERVAL=30s \  # 设置指标采集间隔
  astronomer/k8s-state-metrics:latest

环境变量配置

指标访问方式

启动容器后，可通过http://<容器IP>:<METRICS_PORT>/metrics访问指标数据，例如：

curl http://localhost:9102/metrics

集成建议

• 监控系统：推荐与Prometheus+Grafana集成，通过Prometheus抓取指标，Grafana配置可视化面板
• 告警配置：基于关键指标（如astronomer_k8s_pod_unavailable、astronomer_k8s_node_high_cpu_usage）设置告警规则
• 权限控制：建议为容器配置最小权限的Kubernetes ServiceAccount，仅授予指标采集所需的API访问权限

注意事项

• 确保Kubernetes集群API Server可被容器访问（通过KUBE_CONFIG_PATH或集群内Service访问）
• 高负载集群建议适当增大SCRAPE_INTERVAL以减少API Server压力
• 镜像版本需与Astronomer平台版本匹配，避免指标兼容性问题