astronomerinc/ap-kube-state
astronomerinc
为Astronomer平台公开Kubernetes状态指标的Docker镜像
下载次数: 0状态：社区镜像维护者：astronomerinc仓库类型：镜像最近更新：15 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
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运行命令示例
bashdocker 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
环境变量配置
| 环境变量 | 描述 | 默认值 | 可选值 |
|---|---|---|---|
KUBE_CONFIG_PATH | Kubernetes集群配置文件路径 | /root/.kube/config | 自定义路径 |
METRICS_PORT | 指标HTTP服务监听端口 | 9102 | 1024-65535 |
SCRAPE_INTERVAL | 指标采集时间间隔 | 30s | 如10s、1m |
METRICS_NAMESPACE | 指标命名空间前缀 | astronomer_k8s | 自定义字符串 |
LOG_LEVEL | 日志输出级别 | info | debug、info、warn、error |
指标访问方式
启动容器后，可通过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平台版本匹配，避免指标兼容性问题
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 ap-kube-state 镜像标签
docker pull docker.xuanyuan.run/astronomerinc/ap-kube-state:<标签>
DockerHub 原生拉取命令
docker pull astronomerinc/ap-kube-state:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"