{"id":20775554,"url":"https://github.com/fleaz/prometheus-storagebox-exporter","last_synced_at":"2025-04-30T15:49:01.116Z","repository":{"id":44647693,"uuid":"231831183","full_name":"fleaz/prometheus-storagebox-exporter","owner":"fleaz","description":"Prometheus exporter for Hetzner storage boxes","archived":false,"fork":false,"pushed_at":"2024-04-04T20:11:26.000Z","size":36,"stargazers_count":17,"open_issues_count":0,"forks_count":6,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-30T15:48:56.243Z","etag":null,"topics":["hacktoberfest","hetzner","hetzner-robot-api","prometheus","prometheus-exporter"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fleaz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-01-04T21:31:32.000Z","updated_at":"2025-01-23T08:38:38.000Z","dependencies_parsed_at":"2024-06-21T15:55:26.892Z","dependency_job_id":null,"html_url":"https://github.com/fleaz/prometheus-storagebox-exporter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fleaz%2Fprometheus-storagebox-exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fleaz%2Fprometheus-storagebox-exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fleaz%2Fprometheus-storagebox-exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fleaz%2Fprometheus-storagebox-exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fleaz","download_url":"https://codeload.github.com/fleaz/prometheus-storagebox-exporter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251734412,"owners_count":21635130,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","hetzner","hetzner-robot-api","prometheus","prometheus-exporter"],"created_at":"2024-11-17T12:37:37.018Z","updated_at":"2025-04-30T15:49:01.037Z","avatar_url":"https://github.com/fleaz.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# prometheus-storagebox-exporter\n\nThis tool talks to the [Hetzner\nAPI](https://robot.your-server.de/doc/webservice/de.html#storage-box) and\ngets a list of all [Storage\nBoxes](https://www.hetzner.de/storage/storage-box) in your account and exports their statistics as Prometheus metrics on port `\u003chost\u003e:9509/metrics`.\n\n## Authentication\nSadly the old Hetzner API only accepts BasicAuth as an authenticaton method for their API so this exporter needs your customer number and password for your Hetzner account.\nThese variables gets passed to the tool as environment variables: `HETZNER_USER` and `HETZNER_PASS`\n\n## Exported Metrics \n```\n# HELP storagebox_disk_quota Total diskspace in MB\n# TYPE storagebox_disk_quota gauge\nstoragebox_disk_quota{id=\"1234\",name=\"Backup\",product=\"BX10\",server=\"u12345.your-storagebox.de\"} 102400\n# HELP storagebox_disk_usage Total used diskspace in MB\n# TYPE storagebox_disk_usage gauge\nstoragebox_disk_usage{id=\"1234\",name=\"Backup\",product=\"BX10\",server=\"u12345.your-storagebox.de\"} 23256\n# HELP storagebox_disk_usage_data Used diskspace by files in MB\n# TYPE storagebox_disk_usage_data gauge\nstoragebox_disk_usage_data{id=\"1234\",name=\"Backup\",product=\"BX10\",server=\"u12345.your-storagebox.de\"} 23256\n# HELP storagebox_disk_usage_snapshots Used diskspace by snapshots in MB\n# TYPE storagebox_disk_usage_snapshots gauge\nstoragebox_disk_usage_snapshots{id=\"1234\",name=\"Backup\",product=\"BX10\",server=\"u12345.your-storagebox.de\"} 0\n```\n\n# Running as docker container\nThis exporter can be run as docker-image as well.\nEither build and run the image via the Dockerfile by running\n```sh\ndocker build --tag storagebox-exporter .\n```\n\nthen modify `.env` according to your user credentials and run the image:\n\n```\ndocker run -d --name storagebox-exporter storagebox-exporter --env-file .env\n```\n\nor use:\n\n## docker-compose\nAfter modifying .env to your needs, install and run the container by running:\n```\ndocker compose up -d   # or 'docker-compose up -d' on older systems\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffleaz%2Fprometheus-storagebox-exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffleaz%2Fprometheus-storagebox-exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffleaz%2Fprometheus-storagebox-exporter/lists"}