https://github.com/niklasrosenstein/hcloud-usage-exporter

Export HCloud aggregated usage as Prometheus metrics.
https://github.com/niklasrosenstein/hcloud-usage-exporter

Last synced: 4 days ago
JSON representation

Export HCloud aggregated usage as Prometheus metrics.

• Host: GitHub
• URL: https://github.com/niklasrosenstein/hcloud-usage-exporter
• Owner: NiklasRosenstein
• Created: 2024-04-11T21:45:03.000Z (7 months ago)
• Default Branch: develop
• Last Pushed: 2024-04-13T21:40:12.000Z (7 months ago)
• Last Synced: 2024-10-26T22:54:16.168Z (17 days ago)
• Language: Python
• Size: 32.2 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        


hcloud-usage-exporter


Export HCloud cost totals as Prometheus metrics. Uses Selenium to scrape data from the Hetzner Cloud

web interface.


## Usage

* The container image is available from `ghcr.io/niklasrosenstein/hcloud-usage-exporter`.

* The exporter listens on port `3000` and serves metrics at `/`.

* The exporter requires the following environment variables:

  * `HCLOUD_USERNAME`: The Hetzner Cloud username.

  * `HCLOUD_PASSWORD`: The Hetzner Cloud password.

  * `HCLOUD_TOTP_SECRET`: The Hetzner Cloud TOTP secret, if two-factor authentication is enabled.

* The default scrape interval is 5 minutes.

__Example__

```bash

$ docker run --rm -d \

    -p 3000:3000 \

    -v /dev/shm:/dev/shm \

    -e HCLOUD_USERNAME=... \

    -e HCLOUD_PASSWORD=... \

    -e HCLOUD_TOTP_SECRET=... \

    ghcr.io/niklasrosenstein/hcloud-usage-exporter

$ curl localhost:3000

...

```

## Metrics

* `hcloud_usage_exporter_project_cost_eur{project_name}`

* `hcloud_usage_exporter_state{hcloud_usage_exporter_state="pending|healthy|error}`

* ... todo

## Troubleshooting

### Chrome crashes

Considering granting the pod a larger `/dev/shm` volume, or mount the host's `/dev/shm` into the container.

### Service logs

You can find them under `/var/log/supervisor/hcloud-usage-exporter*.log`.

### Inspect page state on error

A history of the five last page loads are stored in `/var/lib/hcloud-usage-exporter/error-history`, allowing you

to inspect the screenshot and page source when an error occurs. The easiest way to inspect these files is to send them

to a service like [file.io](https://file.io).

```bash

$ cd /var/lib/hcloud-usage-exporter/error-history

$ curl -F file=@2024-04-13_19-25-39.png https://file.io

```