jangraefen / hcloud-pricing-exporter

A prometheus exporter for the current pricing and costs of your HCloud account
MIT License
56 stars 8 forks source link
hcloud hetzner hetzner-cloud prometheus prometheus-exporter prometheus-metrics

hcloud-pricing-exporter

Build Status PkgGoDev Go Report Card Docker Pulls Artifact HUB

A Prometheus exporter that connects to your HCloud account and collects data on your current expenses. The aim is to make cost of cloud infrastructure more transparent and manageable, especially for private projects.

Please note that no guarantees on correctness are made and any financial decisions should be always be based on the billing and cost functions provided by HCloud itself. Some hourly costs are estimations based on monthly costs, if the HCloud API does not provide an hourly expense.

Deployment

To run the exporter from the CLI you need to run the following commands:

# Just run it with the default settings
./hcloud-pricing-exporter -hcloud-token <TOKEN>

# Get the token from an ENV variable
export HCLOUD_TOKEN=<TOKEN>
./hcloud-pricing-exporter

# Run the exporter on a different port with another fetch interval
./hcloud-pricing-exporter -port 1234 -fetch-interval 45m

Alternatively, the exporter can be run by using the provided docker image:

docker run jangraefen/hcloud-pricing-exporter:latest -e HCLOUD_TOKEN=<TOKEN> -p 8080:8080

If you want to deploy the exporter to a Kubernetes environment, you can use the provided helm chart. Just perform the following commands:

helm repo add hcloud-pricing-exporter https://jangraefen.github.io/hcloud-pricing-exporter
helm repo update
helm upgrade --install hcloud-pricing-exporter hcloud-pricing-exporter/hcloud-pricing-exporter --version {VERSION}

Exported metrics

Each exported metric can also be enriched with additional labels, coming from the actual labels on the Hetzner resource. To expose additional labels, use the -additional-labels label1,label2,... command line parameter.