Sections in this category

ETL Backup

Manual ETL Data Backup

Your Prometheus retention window may be small (15 days by default) to reduce the amount of data stored, meaning if Kubecost’s ETL becomes lost or corrupted, it cannot be rebuilt from Prometheus for data older than the retention window. For this reason, you may wish to take backups of Kubecost’s ETL pipeline.

Backup via Bash Script

The simplest way to back up Kubecost’s ETL is to create a copy locally to then send to the file storage system of your choice. We provide a script to do that.

Restoring a Backup

Untar the results of the etl-backup script into the ETL directory pod.

kubectl cp -c cost-model <untarred-results-of-script> <kubecost-namespace>/<kubecost-podname>/var/configs/db/etl

There is also a bash script available to restore the backup here.

Automated Durable ETL Backups and Monitoring

We provide cloud storage backups for ETL backing storage. Backups are not the typical approach of “halt all reads/writes and dump the database.” Instead, the backup system is more of a transparent feature that will always ensure that local ETL data is backed up, and if local data is missing, it can be retrieved from backup storage. This feature protects users from accidental data loss by ensuring that previously backed up data can be restored at runtime.

Note: Durable backup storage functionality is part of Kubecost Enterprise

When the ETL pipeline collects data, it stores both daily and hourly (if configured) cost metrics on a configured storage. This defaults to a persistent volume based disk storage, but can be configured to use external durable storage on the following providers:

  • AWS S3
  • Azure Blob Storage
  • Google Cloud Storage

Create Storage Configuration Secret

This configuration secret follows the same layout documented for Thanos here:

You will need to create a file object-store.yaml using the chosen storage provider configuration layout documented below, and issue the following console command to create the secret from this file:

kubectl create secret generic <secret_name> -n kubecost --from-file=object-store.yaml

Note: It is important to use the file name object-store.yaml if using this method.

Existing Thanos Users

If you are using a cloud storage provider with Thanos, you can use the same bucket configuration secret with the --set kubecostModel.etlBucketConfigSecret=<secret_name> flag to enable the backup feature. This will backup all ETL data to the same bucket being used by Thanos.


The configuration schema for S3 is documented here: S3 Storage. For reference, here’s an example:

type: S3
  bucket: "my-bucket"
  endpoint: ""
  region: "us-west-2"
  access_key: "<AWS_ACCESS_KEY>"
  secret_key: "<AWS_SECRET_KEY>"
  insecure: false
  signature_version2: false
    "X-Amz-Acl": "bucket-owner-full-control"

Google Cloud Storage

The configuration schema for Google Cloud Storage is documented here: Google Cloud Storage Storage. For reference, here’s an example:

type: GCS
  bucket: "my-bucket"
  service_account: |-
      "type": "service_account",
      "project_id": "project",
      "private_key_id": "abcdefghijklmnopqrstuvwxyz12345678906666",
      "private_key": "-----BEGIN PRIVATE KEY-----\...\n-----END PRIVATE KEY-----\n",
      "client_email": "",
      "client_id": "123456789012345678901",
      "auth_uri": "",
      "token_uri": "",
      "auth_provider_x509_cert_url": "",
      "client_x509_cert_url": ""


The configuration schema for Azure is documented here: Azure Storage. For reference, here’s an example:

type: AZURE
  storage_account: "<STORAGE_ACCOUNT>"
  storage_account_key: "<STORAGE_ACCOUNT_KEY>"
  container: "my-bucket"
  endpoint: ""

Enable ETL Backup in Helm Values

When installing with helm, use the --set kubecostModel.etlBucketConfigSecret=<secret_name> flag and substitute the name of the secret you just created. The backup solution will work with kubecostModel.etlFileStore: true as well.


If you are using an existing disk storage option for your ETL data, enabling the durable backup feature will retroactively back up all previously stored data*. This feature is also fully compatible with the existing S3 backup feature.

* If you are using a memory store for your ETL data with a local disk backup (kubecostModel.etlFileStoreEnabled: false), the backup feature will simply replace the local backup. In order to take advantage of the retroactive backup feature, you will need to update to file store (kubecostModel.etlFileStoreEnabled: true). This option is now enabled by default in the helm chart.


Currently, this feature is still in development, but there is currently a status card available on the diagnostics page that will eventually show the status of the backup system:

Diagnostic ETL Backup Status

Edit this doc on GitHub