README.md

Kubecost Helm chart

This is the official Helm chart for Kubecost, an enterprise-grade application to monitor and manage Kubernetes spend. Please see the website for more details on what Kubecost can do for you and the official documentation here, or contact team@kubecost.com for assistance.

Version Support

Kubecost strives to support as many versions of Kubernetes as possible. Below is the version support matrix which has been tested. Versions outside of the stated range may still work but are untested.

Chart Version	Kubernetes Min	Kubernetes Max
1.107	1.20	1.28
1.108	1.20	1.28
2.1	1.20	1.29
2.2	1.21	1.29
2.3	1.21	1.30
2.4	1.22	1.31

Installation

To install via Helm, run the following command.

helm upgrade --install kubecost -n kubecost --create-namespace \
  --repo https://kubecost.github.io/cost-analyzer/ cost-analyzer \
  --set kubecostToken="aGVsbUBrdWJlY29zdC5jb20=xm343yadf98"

Alternatively, add the Helm repository first and scan for updates.

helm repo add kubecost https://kubecost.github.io/cost-analyzer/
helm repo update

Next, install the chart.

helm install kubecost kubecost/cost-analyzer -n kubecost --create-namespace \
  --set kubecostToken="aGVsbUBrdWJlY29zdC5jb20=xm343yadf98"

While Helm is the recommended install path for Kubecost, especially in production, Kubecost can alternatively be deployed with a single-file manifest using the following command. Keep in mind when choosing this method, Kubecost will be installed from a development branch and may include unreleased changes. We recommend using the manifest from a release branch, such as v1.108.

kubectl apply -f https://raw.githubusercontent.com/kubecost/cost-analyzer-helm-chart/develop/kubecost.yaml

Common Parameters

The following table lists commonly used configuration parameters for the Kubecost Helm chart and their default values. Please see the values file for the complete set of definable values.

Parameter	Description	Default
global.prometheus.enabled	If false, use an existing Prometheus install. More info.	true
prometheus.server.persistentVolume.enabled	If true, Prometheus server will create a Persistent Volume Claim.	true
prometheus.server.persistentVolume.size	Prometheus server data Persistent Volume size. Default set to retain ~6000 samples per second for 15 days.	32Gi
prometheus.server.persistentVolume.storageClass	Define storage class for Prometheus persistent volume	-
prometheus.server.retention	Determines when to remove old data.	97h
prometheus.server.resources	Prometheus server resource requests and limits.	{}
prometheus.nodeExporter.resources	Node exporter resource requests and limits.	{}
prometheus.nodeExporter.enabled prometheus.serviceAccounts.nodeExporter.create	If false, do not create NodeExporter daemonset.	true
prometheus.alertmanager.persistentVolume.enabled	If true, Alertmanager will create a Persistent Volume Claim.	false
prometheus.pushgateway.persistentVolume.enabled	If true, Prometheus Pushgateway will create a Persistent Volume Claim.	false
persistentVolume.enabled	If true, Kubecost will create a Persistent Volume Claim for product config data.	true
persistentVolume.size	Define PVC size for cost-analyzer	32.0Gi
persistentVolume.dbSize	Define PVC size for cost-analyzer's flat file database	32.0Gi
persistentVolume.storageClass	Define storage class for cost-analyzer's persistent volume	-
ingress.enabled	If true, Ingress will be created	false
ingress.annotations	Ingress annotations	{}
ingress.className	Ingress class name	{}
ingress.paths	Ingress paths	["/"]
ingress.hosts	Ingress hostnames	[cost-analyzer.local]
ingress.tls	Ingress TLS configuration (YAML)	[]
networkCosts.enabled	If true, collect network allocation metrics More info	false
networkCosts.podMonitor.enabled	If true, a PodMonitor for the network-cost daemonset is created	false
serviceMonitor.enabled	Set this to true to create ServiceMonitor for Prometheus operator	false
serviceMonitor.additionalLabels	Additional labels that can be used so ServiceMonitor will be discovered by Prometheus	{}
prometheusRule.enabled	Set this to true to create PrometheusRule for Prometheus operator	false
prometheusRule.additionalLabels	Additional labels that can be used so PrometheusRule will be discovered by Prometheus	{}
grafana.resources	Grafana resource requests and limits.	{}
grafana.sidecar.dashboards.enabled	Set this to false to disable creation of Dashboards in Grafana	true
grafana.sidecar.datasources.defaultDatasourceEnabled	Set this to false to disable creation of Prometheus datasource in Grafana	true
serviceAccount.create	Set this to false if you want to create the service account kubecost-cost-analyzer on your own	true
tolerations	node taints to tolerate	[]
affinity	pod affinity	{}
extraVolumes	A list of volumes to be added to the pod	[]
extraVolumeMounts	A list of volume mounts to be added to the pod	[]

Adjusting Log Output

The log output can be customized during deployment by using the LOG_LEVEL and/or LOG_FORMAT environment variables.

Adjusting Log Level

Adjusting the log level increases or decreases the level of verbosity written to the logs. To set the log level to trace, the following flag can be added to the helm command.

--set 'kubecostModel.extraEnv[0].name=LOG_LEVEL,kubecostModel.extraEnv[0].value=trace'

Adjusting Log Format

Adjusting the log format changes the format in which the logs are output making it easier for log aggregators to parse and display logged messages. The LOG_FORMAT environment variable accepts the values JSON, for a structured output, and pretty for a nice, human-readable output.

Value	Output
JSON	{"level":"info","time":"2006-01-02T15:04:05.999999999Z07:00","message":"Starting cost-model (git commit \"1.91.0-rc.0\")"}
pretty	2006-01-02T15:04:05.999999999Z07:00 INF Starting cost-model (git commit "1.91.0-rc.0")