ghcr.io/opencost/opencost-ui:test-d95ebc9

OpenCost — 您喜爱的 Kubernetes 和云支出开源成本监控工具

OpenCost 为团队提供当前和历史 Kubernetes 及云支出与资源分配的可见性。这些模型在支持多个应用程序、团队、部门等的 Kubernetes 环境中提供成本透明度。它还提供跨多个云服务提供商的云成本可见性。

OpenCost 最初由 Kubecost 开发并开源。该项目结合了规范以及这些详细要求的 Golang 实现。Web UI 可在 opencost/opencost-ui 仓库中获取。

OpenCost UI 功能导览

要查看 OpenCost 的完整功能，您可以查看 OpenCost 特性。以下是已启用特性的摘要：

• 按 Kubernetes 集群、节点、命名空间、控制器类型、控制器、服务或 Pod 进行实时成本分配
• 对 AWS、Azure、GCP 上的所有云服务进行多云成本监控
• 通过与 AWS、Azure 和 GCP billing API 集成实现动态按需 Kubernetes 资产定价
• 支持具有自定义 CSV 定价的本地 Kubernetes 集群
• 集群内 Kubernetes 资源（如 CPU、GPU、内存和持久卷）的成本分配
• 通过 /metrics 端点轻松将定价数据导出到 Prometheus（了解更多）
• 云资源的碳成本
• MCP 支持
• 通过 OpenCost 插件支持 Datadog 等外部成本
• 免费开源发行版（Apache2 许可证）

快速开始

OpenCost 现在仅通过官方 Helm chart 进行安装和管理。

在任何 Kubernetes 1.20+ 集群上快速安装：

helm repo add opencost https://opencost.github.io/opencost-helm-chart
helm repo update
helm install opencost opencost/opencost

[!NOTE] 独立的 Kubernetes 清单文件已被移除。请使用 Helm 进行所有安装和升级。有关详细信息和配置，请参阅 Helm 安装文档。

[!NOTE] 针对分片 Prometheus 用户的说明：如果您运行分片（HA）模式的 Prometheus，请将 PROMETHEUS_SERVER_ENDPOINT 设置为全局查询端点（例如 Thanos Query、Cortex 或 Mimir）。指向单个 Prometheus pod 可能会导致导出结果不完整或间歇性问题。有关详细信息，请参阅 Prometheus 集成文档。

[!NOTE] 针对分片 Prometheus 用户的说明：如果您运行分片（HA）模式的 Prometheus，请将 PROMETHEUS_SERVER_ENDPOINT 设置为全局查询端点（例如 Thanos Query、Cortex 或 Mimir）。指向单个 Prometheus pod 可能会导致导出结果不完整或间歇性问题。有关详细信息，请参阅 Prometheus 集成文档。

PROMETHEUS_SERVER_ENDPOINT

使用方式

• 成本 API
• CLI / kubectl cost
• Prometheus 指标
• 用户界面

MCP服务器为AI代理提供以下工具：

get_allocation_costs

get_allocation_costs：通过筛选和聚合检索成本分配数据。

参数：

• window（必填）：时间窗口（例如："7d"、"1h"、"30m"）window
• aggregate（可选）：聚合属性（例如："namespace"、"pod"、"node"）aggregate
• step（可选）：分辨率步长step
• accumulate（可选）：是否随时间累积accumulate
• share_idle（可选）：是否分摊空闲成本share_idle
• include_idle（可选）：是否包含空闲资源include_idle

get_asset_costs

get_asset_costs：检索资产成本数据，包括节点、磁盘、负载均衡器等。

参数：

• window（必填）：时间窗口（例如："7d"、"1h"、"30m"）window

get_cloud_costs

get_cloud_costs：通过提供商、服务和区域筛选检索云成本数据。

参数：

• window（必填）：时间窗口（例如："7d"、"1h"、"30m"）window
• aggregate（可选）：聚合属性（例如："provider"、"service"、"region"）aggregate
• accumulate（可选）：时间累积（"day"、"week"、"month"）accumulate
• provider（可选）：按云提供商筛选（例如："aws"、"gcp"、"azure"）provider
• service（可选）：按服务筛选（例如："ec2"、"compute"、"s3"）service
• category（可选）：按类别筛选（例如："compute"、"storage"、"network"）category
• region（可选）：按区域筛选（例如："us-west-1"、"us-central1"）region
• accountID（可选）：按账户ID筛选accountID

支持的资产类型

• Node：包含CPU、RAM、GPU详情的计算实例
• Disk：包含使用情况和成本细分的存储卷
• Load***：包含IP和私有状态的负载均衡器实例
• Network：网络相关成本和使用情况
• Cloud：包含信用信息的云服务成本
• ClusterManagement：Kubernetes集群管理成本

示例用法

配置完成后，AI代理可以如下查询成本数据：

// 获取过去7天的成本分配
const allocation = await mcpClient.callTool('get_allocation_costs', {
window: '7d',
aggregate: 'namespace,node'
});

// 获取过去24小时的资产成本
const assets = await mcpClient.callTool('get_asset_costs', {
window: '1d'
});

// 获取us-west-1区域AWS EC2的云成本
const cloudCosts = await mcpClient.callTool('get_cloud_costs', {
window: '7d',
aggregate: 'service',
provider: 'aws',
service: 'ec2',
accumulate: 'day',
filter: 'regionID:"us-west-1"'
});

有关详细的设置说明和高级配置，请参阅Helm图表文档。

• 默认选择加入：MCP服务器默认禁用，以最小化***面，必须显式启用
• 完全用户控制：轻松启用或配置端口及设置
• 分配查询：通过过滤和聚合检索成本分配数据
• 资产查询：访问详细资产信息，包括节点、磁盘、负载均衡器等
• 云成本查询：通过提供商、服务和区域过滤查询云成本数据
• HTTP传输：使用HTTP与MCP客户端进行可靠通信
• 简单配置：使用标准环境变量轻松启用
• Helm集成：内置于官方Helm图表，适用于生产部署

快速开始

使用Tilt（开发环境）

# 克隆并启动带MCP服务器的OpenCost
# 您可能还需要克隆opencost-ui和opencost-helm-charts仓库
# 确保克隆的仓库与opencost位于同一父目录下

git clone https://github.com/opencost/opencost.git
cd opencost
tilt up

默认配置

UI和Prometheus均运行在9090端口。您可能需要端口转发到非默认端口以同时访问两者。

Tilt配置说明（云成本）：

OpenCost的Tilt配置值（tilt-values.yaml）包含额外环境变量，用于在开发环境中启用云成本数据摄入：

# tilt-values.yaml（节选）
opencost:
exporter:
extraEnv:
CLOUD_COST_ENABLED: "true"
CLOUD_COST_CONFIG_PATH: "/var/cloud-integration/cloud-integration.json"

• 将CLOUD_COST_ENABLED设置为"true"以开启云成本数据摄入。
• 将CLOUD_COST_CONFIG_PATH指向Tilt使用的已挂载云集成文件（例如：/var/cloud-integration/cloud-integration.json）。
• 开发期间根据需要调整tilt-values.yaml中的其他值。

使用Helm（生产环境）

# 添加OpenCost Helm仓库
helm repo add opencost https://opencost.github.io/opencost-helm-chart
helm repo update

# 部署启用MCP服务器的OpenCost（选择加入）
helm install opencost opencost/opencost --set opencost.mcp.enabled=true

# 通过端口转发访问MCP服务器（示例）
kubectl port-forward svc/opencost 8081:8081

Helm图表中MCP服务器默认禁用。如需自定义配置：

# 部署启用MCP服务器
helm install opencost opencost/opencost \
--set opencost.mcp.enabled=true

# 部署自定义MCP端口
helm install opencost opencost/opencost \
--set opencost.mcp.port=9091

# 部署带调试日志
helm install opencost opencost/opencost \
--set opencost.mcp.extraEnv.MCP_LOG_LEVEL=debug

配置摘要

MCP客户端配置

配置您的MCP客户端（如Cursor）以连接到OpenCost MCP服务器：

默认配置（端口8081）：

{
"mcpServers": {
"opencost": {
"type": "http",
"url": "http://localhost:8081"
}
}
}

自定义端口配置：

{
"mcpServers": {
"opencost": {
"type": "http",
"url": "http://localhost:9091"
}
}
}

Kubernetes部署场景：

{
"mcpServers": {
"opencost": {
"type": "http",
"url": "http://opencost.opencost.svc.cluster.local:8081"
}
}
}

外部访问场景（使用Load*/Ingress）：**

{
"mcpServers": {
"opencost": {
"type": "http",
"url": "http://your-opencost-domain.com:8081"
}
}
}

可用MCP工具

MCP服务器为AI代理提供以下工具：

get_allocation_costs

通过过滤和聚合检索成本分配数据。

参数：

• window（必填）：时间窗口（例如："7d"、"1h"、"30m"）
• aggregate（可选）：聚合属性（例如："namespace"、"pod"、"node"）
• step（可选）：分辨率步长
• accumulate（可选）：是否随时间累积
• share_idle（可选）：是否分摊空闲成本
• include_idle（可选）：是否包含空闲资源

get_asset_costs

检索资产成本数据，包括节点、磁盘、负载均衡器等。

参数：

• window（必填）：时间窗口（例如："7d"、"1h"、"30m"）

get_cloud_costs

通过提供商、服务和区域过滤检索云成本数据。

参数：

• window（必填）：时间窗口（例如："7d"、"1h"、"30m"）
• aggregate（可选）：聚合属性（例如："provider"、"service"、"region"）
• accumulate（可选）：时间累积方式（"day"、"week"、"month"）
• provider（可选）：按云提供商过滤（例如："aws"、"gcp"、"azure"）
• service（可选）：按服务过滤（例如："ec2"、"compute"、"s3"）
• category（可选）：按类别过滤（例如："compute"、"storage"、"network"）
• region（可选）：按区域过滤（例如："us-west-1"、"us-central1"）
• accountID（可选）：按账户ID过滤

支持的资产类型

• 节点：包含CPU、RAM、GPU详情的计算实例
• 磁盘：包含使用情况和成本明细的存储卷
• 负载均衡器：包含IP和私有状态的负载均衡器实例
• 网络：网络相关成本和使用情况
• 云：包含信用信息的云服务成本
• 集群管理：Kubernetes集群管理成本

示例用法

配置完成后，AI代理可以如下查询成本数据：

// 获取过去7天的成本分配
const allocation = await mcpClient.callTool('get_allocation_costs', {
window: '7d',
aggregate: 'namespace,node'
});

// 获取过去24小时的资产成本
const assets = await mcpClient.callTool('get_asset_costs', {
window: '1d'
});

// 获取us-west-1区域AWS EC2的云成本
const cloudCosts = await mcpClient.callTool('get_cloud_costs', {
window: '7d',
aggregate: 'service',
provider: 'aws',
service: 'ec2',
accumulate: 'day',
filter: 'regionID:"us-west-1"'
});

有关详细的设置说明和高级配置，请参阅https://github.com/opencost/opencost-helm-chart/blob/main/charts/opencost/README.md#mcp-server%E3%80%82

贡献

我们 :heart: 拉取请求！有关从源代码构建项目和贡献更改的信息，请参见CONTRIBUTING.md。

社区

常见问题

您可以查看OpenCost文档获取常见问题列表。