The Kubecost Allocations dashboard allows you to quickly see allocated spend across all native Kubernetes concepts, e.g. namespace, k8s label, and service. It also allows for allocating cost to organizational concepts like team, product/project, department, or environment. This document explains the metrics presented and describes how you can control the data displayed in this view.
Kubecost provides a variety of options for configuring your allocations queries to view the information you need. Below is a table of the major configuration options, with in-depth explanations in this article for how they work.
Date Range window
Select the date range of the report by setting specific start and end dates, or by using one of the preset options.
Here you can aggregate cost by namespace, deployment, service, and other native Kubernetes concepts. While selecting Single Aggregation, you will only be able to select one concept at a time. While selecting Multi Aggregation, you will be able to filter for multiple concepts at the same time.
Service in this context refers to a Kubernetes object that exposes an interface to outside consumers.
When aggregating by namespace, the Allocations dashboard will only display namespaces that have or have had workloads running in them. If you don't see a namespace on this dashboard, you should confirm whether the namespace is running a workload.
Costs aggregations are also visible by other meaningful organizational concepts, e.g. Team, Department, and Product. These aggregations are based on Kubernetes labels, referenced at both the pod and namespace-level, with labels at the pod-level being favored over the namespace label when both are present. The Kubernetes label name used for these concepts can be configured in Settings or in values.yaml after setting
true. Workloads without the relevant label will be shown as
Kubernetes annotations can also be used for cost allocation purposes, but this requires enabling a Helm flag. Learn more about using annotations. To see the annotations, you must add them to the label groupings via Settings or in values.yaml. Annotations will not work as one-off Labels added into reports directly, they will only work when added to the label groups in Settings or within the values.yaml.
To find what pods are not part of the relevant label set, you can either apply an
__unallocated__label filter in this allocation view or explore variations of the following kubectl commands:
kubectl get pods -l 'app notin (prometheus, cost-analyzer, ...)' --all-namespaces
kubectl get pods --show-labels -n <TARGET_NAMESPACE>
The Edit icon has additional options for configuring your query such as how to display your data, adding filters, and configuring shared resources.
As an example, if your cluster is only 25% utilized, as measured by the max of resource usage and requests, applying idle costs would proportionately increase the cost of each pod/namespace/deployment by 4x. This feature can be enabled by default in Settings.
The idle costs dropdown allows you to choose how you wish your idle costs to be displayed:
- Hide: Hide idle costs completely.
- Separate: Idle costs appear as their own cost, visualized as a gray-colored bar in your display table.
- Share By Cluster: Idle costs are grouped by the cluster they belong to.
- Share By Node: Idle costs are grouped by the node they belong to.
View Allocation data in the following formats:
- 1.Cost: Total cost per aggregation over date range
- 2.Cost over time: Cost per aggregation broken down over days or hours depending on date range
- 3.Efficiency over time: Shows resource efficiency over given date range
- 4.Proportional cost: Cost per aggregate displayed as a percentage of total cost over date range
- 5.Cost Treemap: Hierarchically structured view of costs in current aggregation
You can select Edit > Chart > Cost over time from the dropdown to have your data displayed on a per-day basis. Hovering over any day's data will provide a breakdown of your spending.
Cost over time data
View either cumulative or run rate costs measured over the selected time window based on the resources allocated.
- Cumulative Cost: represents the actual/historical spend captured by the Kubecost agent over the selected time window
- Rate metrics: Monthly, daily, or hourly "run rate" cost, also used for projected cost figures, based on samples in the selected time window
Costs allocations are based on the following:
- 1.Resources allocated, i.e. max of resource requests and usage
- 2.The cost of each resource
- 3.The amount of time resources were provisioned
Step size refers to the size of each bar of data displayed on your dashboard. Options are Default, Daily, and Weekly. When retaining long periods of data through custom configurations (such as Prometheus), consider using larger step sizes to avoid display errors.
Filter resources by namespace, clusterID, and/or Kubernetes label to more closely investigate a rise in spend or key cost drivers at different aggregations such as deployments or pods. When a filter is applied, only resources with this matching value will be shown. These filters are also applied to external out-of-cluster (OOC) asset tags. Supported filters are as follows:
Comma-separated lists are supported to filter by multiple categories, e.g. namespace filter equals
kube-system,kubecost. Wild card filters are also supported, indicated by a * following the filter, e.g.
namespace=kube*to return any namespace beginning with
You can also implement more advanced forms of filtering to include or exclude values including prefixes or suffixes for any of the above categories in the table. Selecting the filtering dropdown (default Equals) will show you all available filtering options. These are reflective of Kubecost's v2 filtering language.
Select how shared costs set on the settings page will be shared among allocations. Pick from default shared resources, or select a custom shared resource. A custom shared resource can be selected in the Configure custom shared resources feature at the bottom of the Edit window.
The three horizontal dots icon (directly next to Save) will provide additional options for handling your report:
- Open Report: Allows you to open one of your saved reports without first navigating to the Reports page
- Alerts: Send one of four reports routinely: recurring, efficiency, budget, and spend change
- Download CSV: Download your current report as a CSV file
- Download PDF: Download your current report as a PDF file
Cost allocation metrics are available for both in-cluster and OOC resources:
Cost Efficiency table
The rightmost column in the Allocations metrics table allows you to perform additional actions on individual line items (functionality will vary based on how you aggregate):
- Inspect: Opens an advanced cost overview of the namespace in a new tab.
- Inspect Shared Costs: Opens an advanced cost overview of your shared costs in a new tab.