Kubectl Metrics

kubectl指标

查询OpenShift集群上的Prometheus/Thanos指标——作为AI助手的CLI和MCP服务器。

安装

安装最新版本（Linux/macOS）：

curl -sSL https://raw.githubusercontent.com/yaacov/kubectl-metrics/main/install.sh | bash

这将下载二进制文件，验证其校验和，并设置shell完成。安装到 ~/.local/bin 默认情况下。

或安装 克鲁 （kubectl插件管理器）：

kubectl krew install mtv-metrics

或者从源代码构建：

make build
cp kubectl-metrics ~/.local/bin/kubectl-metrics

安装后，kubectl会发现它是一个插件：

kubectl metrics --help

有关更多选项（手动下载、shell完成、卸载），请参阅 安装.


快速开始

# CLI usage (auto-discovers Prometheus from your kubeconfig)
kubectl metrics discover
kubectl metrics discover --keyword mtv
kubectl metrics query --query "up"
kubectl metrics query --query "sum(rate(http_requests_total[5m])) by (code)" --name http_rps
kubectl metrics query-range --query "rate(http_requests_total[5m])" --start "-1h"
kubectl metrics query-range \
  --query "sum(rate(container_cpu_usage_seconds_total[5m])) by (namespace)" \
  --query "sum(container_memory_working_set_bytes) by (namespace)" \
  --name cpu --name mem --start "-1h"
kubectl metrics preset --name mtv_migration_status

# MCP server (stdio, for Claude Desktop / Cursor IDE)
kubectl metrics mcp-server

# MCP server (HTTP, for OpenShift Lightspeed)
kubectl metrics mcp-server --http --port 8080

# MCP server from container image
podman run --rm -p 8080:8080 \
  -e MCP_KUBE_SERVER=https://api.mycluster.example.com:6443 \
  -e MCP_KUBE_TOKEN="$(oc whoami -t)" \
  quay.io/yaacov/kubectl-metrics-mcp-server:latest

AI助手设置

克劳德桌面：

claude mcp add kubectl-metrics kubectl metrics mcp-server

光标IDE：

设置→ MCP → 添加服务器→ Name: kubectl-metrics，命令： kubectl，Args： metrics mcp-server

认证

使用标准kubectl标志(--kubeconfig, --context, --token, --server).自动从集群的Thanos查询器路由中发现Prometheus/Thanos URL。

对于客户端证书认证（例如Kind/minikube），通过Kubernetes TokenRequest API自动请求服务帐户令牌。

TLS验证

标准 oc / kubectl 命令连接到Kubernetes API服务器，该服务器的CA位于您的kubeconfig中。Metrics命令连接到Thanos/Peotheus路由，该路由由OpenShift入口控制器使用不同的CA提供服务。您可能需要传递 -k (--insecure-skip-tls-verify)或 --certificate-authority 为了使指标发挥作用：

kubectl metrics discover -k
kubectl metrics discover --certificate-authority /path/to/ingress-ca.crt

看 认证 了解详情。

在OpenShift上部署

make deploy              # Deployment + Service
make deploy-route        # External Route with TLS
make deploy-olsconfig    # Register with OpenShift Lightspeed

类似工具

还有其他几个工具可以从命令行查询Prometheus。 宣传工具 （普罗米修斯官方CLI）和 promql-cli 提供独立的PromQL查询， 普罗米修斯mcp服务器 通过MCP将普罗米修斯暴露给人工智能助手，以及 kubectl 舞会 是一个用于集群内查询的轻量级kubectl插件。

kubectl metrics将所有三个角度——kubectl原生CLI、OpenShift/Thanos自动发现和预设查询，以及内置的MCP服务器——组合在一个二进制文件中。 看 类似工具 以进行详细比较。

文档

看 docs/ 详细指南目录：

入门

• 安装 --安装、Krew、外壳完成
• CLI使用情况 --命令、标志、预设、输出格式
• PromQL参考 --查询语言备忘单

查询指南

• 查询食谱 --存储、网络、Pod和迁移的配方
• VM和迁移指南 --每迁移监控、每磁盘I/O、KubeVirt VM指标
• 指标参考 --度量名称和标签表

MCP和AI集成

• MCP服务器 --stdio和HTTP模式，AI助手设置
• 容器化 --从容器映像运行MCP服务器

运营

• 认证 --kubeconfig、客户端证书、TokenRequest
• 部署 --部署在OpenShift上，Lightspeed集成

比较

• 类似工具 --与其他工具的功能比较

发展

make help          # Show all targets
make build         # Build binary
make test          # Run tests
make fmt           # Format code
make lint          # Run linters (requires: make install-tools)
make vendor        # Populate vendor/
make image-build-amd64   # Build container image

许可证

Apache许可证2.0