Kubecost is an enterprise-grade Kubernetes cost monitoring and management platform distributed as a Helm chart. This repository contains the official Helm chart templates for deploying Kubecost across Kubernetes clusters. The project enables organizations to monitor, analyze, and optimize their Kubernetes spending through comprehensive cost visibility and allocation features.
The repository is classified across multiple cost management and monitoring domains including spend analysis, cloud cost visibility, cluster budgeting, usage reports, billing analysis, cost forecasting, and spending optimization. It serves as both a monitoring dashboard and infrastructure billing tool, providing financial reporting and pricing insights specific to Kubernetes environments.
Kubecost version 3.0 represents a significant architectural shift from the 2.x line. The most notable change involves the database backend, moving from DuckDB to ClickHouse, and the metrics source transitioning from Prometheus to direct collection. This upgrade path requires users on 2.x to first update to version 2.9 and wait two days before upgrading to 3.0. The chart supports Kubernetes versions 1.29 through 1.34 in the 3.0 release, with earlier versions supporting 1.22 through 1.34. When upgrading to 3.0, a complete data re-ingestion process begins immediately, which can take anywhere from 20 minutes to 2 days depending on dataset size and storage performance. During this period, the UI remains available but displays a progress indicator.
A major component change in 3.0 involves the agent architecture. The previous cost-model container has been replaced with a new finops-agent that offers substantial improvements including 10-minute metric granularity for cluster, node group, and container right-sizing, up to 50 percent reduction in memory usage, and enhanced diagnostics data. A 3.0 primary cluster maintains backward compatibility with 2.x agents and newer versions, though diagnostics compatibility varies depending on the version combinations deployed.
The repository shows active development and maintenance patterns. The repository's contributor base overlaps with major open-source projects including Microsoft's VSCode and TypeScript implementations, as well as the Rust language project, indicating involvement from experienced infrastructure and systems software developers.
Installation is straightforward through Helm, with options for stable releases, beta and release candidate versions via the devel flag, and nightly builds through a dedicated nightly-helm-chart repository. The project maintains comprehensive documentation through IBM Docs and provides direct support contact through the Kubecost team email. The primary language used in the repository is Mustache, reflecting the template-driven nature of Helm chart development. The default develop branch is noted as unstable and subject to change, with users advised to use specific release versions for production deployments.
