{"id":20319044,"url":"https://github.com/tedder/helium_hotspot_exporter","last_synced_at":"2025-09-17T23:09:19.947Z","repository":{"id":40557433,"uuid":"369315474","full_name":"tedder/helium_hotspot_exporter","owner":"tedder","description":"Prometheus exporter for the Helium hotspots","archived":false,"fork":false,"pushed_at":"2022-05-02T20:16:54.000Z","size":17,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-11T18:12:32.412Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/tedder.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}},"created_at":"2021-05-20T19:22:36.000Z","updated_at":"2022-02-17T21:21:08.000Z","dependencies_parsed_at":"2022-08-09T23:00:50.194Z","dependency_job_id":null,"html_url":"https://github.com/tedder/helium_hotspot_exporter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tedder/helium_hotspot_exporter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tedder%2Fhelium_hotspot_exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tedder%2Fhelium_hotspot_exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tedder%2Fhelium_hotspot_exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tedder%2Fhelium_hotspot_exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tedder","download_url":"https://codeload.github.com/tedder/helium_hotspot_exporter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tedder%2Fhelium_hotspot_exporter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275680444,"owners_count":25508570,"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","status":"online","status_checked_at":"2025-09-17T02:00:09.119Z","response_time":84,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2024-11-14T18:42:54.672Z","updated_at":"2025-09-17T23:09:19.928Z","avatar_url":"https://github.com/tedder.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# helium\\_hotspot\\_exporter\nPrometheus exporter for [Helium hotspots](https://helium.com/). Using prometheus\\_client, this code exposes metrics from the helium API to a prometheus compatible server. \n\nThis is only the exporter, which still requires a **prometheus server** for data and **grafana** for the dashboard.\n\n**We need help making a dashboard**. For now, import by ID [14470](https://grafana.com/grafana/dashboards/14470) to see some of the values (though it isn't organized).\n\nNote [port 9829 is the 'reserved' port for this specific exporter](https://github.com/prometheus/prometheus/wiki/Default-port-allocations).\n\n\n## Run options\n\nThe list of hotspots you'd like to monitor can be specified several ways: by name, by address, or by account (owner) address. They all expect comma-separated values (or zero/one without a comma). Here are examples:\n```\nHOTSPOT_NAMES=\"angry-purple-tiger,bald cat lace\"\nHOTSPOT_ADDRESSES=aabbccdd112233XXYY...,bbccddee223344YYZZ...\nACCOUNT_ADDRESSES=Zzyzx0123...\n```\n\nNote hotspot names must be lowercased and hypenated before they hit the API. This code will normalize case and spaces. Names are also not guaranteed unique, the code will attempt to log an error if it isn't found or it isn't unique.\n\n\n## Running via Docker\nUsing the docker file, you can run this with Docker or docker-compose! Both of these will expose Prometheus on port 9829. The images are hosted on both [GHCR](https://github.com/users/tedder/packages/container/package/helium_hotspot_exporter) and [Dockerhub](https://hub.docker.com/r/tedder42/helium_hotspot_exporter).\n\n### Docker client\n```\ndocker run -p 9829:9829 -e HOTSPOT_NAMES=angry-purple-tiger --name hotspot_exporter ghcr.io/tedder/helium_hotspot_exporter:latest\n```\n\n### Docker-Compose\nUsing your existing docker-compose file, add the section for the exporter (below). When you're done, run `docker-compose up -d` as usual. That's it!\n```\nversion: \"3\"\nservices:\n  hotspot_exporter:\n    image: ghcr.io/tedder/helium_hotspot_exporter:latest\n    container_name: hotspot_exporter\n    ports:\n    - \"9829:9829\"\n    env:\n      HOTSPOT_NAMES: \"angry-purple-tiger\"\n      HOTSPOT_ADDRESSES: \"aabbccdd112233XXYY...,bbccddee223344YYZZ...\"\n      ACCOUNT_ADDRESSES: \"Zzyzx0123...\"\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftedder%2Fhelium_hotspot_exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftedder%2Fhelium_hotspot_exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftedder%2Fhelium_hotspot_exporter/lists"}