https://github.com/promhippie/dockerhub_exporter
Prometheus exporter for DockerHub
https://github.com/promhippie/dockerhub_exporter
dockerhub metrics prometheus prometheus-exporter
Last synced: about 1 month ago
JSON representation
Prometheus exporter for DockerHub
- Host: GitHub
- URL: https://github.com/promhippie/dockerhub_exporter
- Owner: promhippie
- License: apache-2.0
- Created: 2017-04-29T09:35:34.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-09-03T21:57:45.000Z (about 2 months ago)
- Last Synced: 2025-09-03T23:33:18.703Z (about 2 months ago)
- Topics: dockerhub, metrics, prometheus, prometheus-exporter
- Language: Go
- Homepage: https://promhippie.github.io/dockerhub_exporter/
- Size: 1.7 MB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Dco: DCO
Awesome Lists containing this project
README
# DockerHub Exporter
[](https://github.com/promhippie/prometheus-dockerhub-sd) [](https://github.com/promhippie/dockerhub_exporter/actions/workflows/general.yml) [](https://matrix.to/#/#webhippie:matrix.org) [](https://www.codacy.com/gh/promhippie/dockerhub_exporter/dashboard?utm_source=github.com&utm_medium=referral&utm_content=promhippie/dockerhub_exporter&utm_campaign=Badge_Grade) [](http://godoc.org/github.com/promhippie/dockerhub_exporter) [](http://goreportcard.com/report/github.com/promhippie/dockerhub_exporter)
An exporter for [Prometheus][prometheus] that collects metrics from
[DockerHub][docker].
## Install
You can download prebuilt binaries from our [GitHub releases][releases]. Besides
that we also prepared repositories for DEB and RPM packages which can be found
at [Baltorepo][baltorepo]. If you prefer to use containers you could use our
images published on [GHCR][ghcr], [Docker Hub][dockerhub] or [Quay][quayio]. If
you need further guidance how to install this take a look at our [docs][docs].
## Development
If you are not familiar with [Nix][nix] it is up to you to have a working
environment for Go (>= 1.24.0) as the setup won't we covered within this guide.
Please follow the official install instructions for [Go][golang]. Beside that
we are using [go-task][gotask] to define all commands to build this project.
```console
git clone https://github.com/promhippie/dockerhub_exporter.git
cd dockerhub_exporter
task generate build
./bin/dockerhub_exporter -h
```
If you got [Nix][nix] and [Direnv][direnv] configured you can simply execute
the following commands to get al dependencies including [go-task][gotask] and
the required runtimes installed. You are also able to directly use the process
manager of [devenv][devenv]:
```console
cat << EOF > .envrc
use flake . --impure --extra-experimental-features nix-command
EOF
direnv allow
```
To start developing on this project you have to execute only a few commands:
```console
task watch
```
The development server should be running on
[http://localhost:9505](http://localhost:9505). Generally it supports
hot reloading which means the services are automatically restarted/reloaded on
code changes.
If you got [Nix][nix] configured you can simply execute the [devenv][devenv]
command to start:
```console
devenv up
```
## Security
If you find a security issue please contact
[thomas@webhippie.de](mailto:thomas@webhippie.de) first.
## Contributing
Fork -> Patch -> Push -> Pull Request
## Authors
- [Thomas Boerger](https://github.com/tboerger)
## License
Apache-2.0
## Copyright
```console
Copyright (c) 2018 Thomas Boerger
```
[prometheus]: https://prometheus.io
[docker]: https://hub.docker.com
[releases]: https://github.com/promhippie/dockerhub_exporter/releases
[baltorepo]: https://webhippie.baltorepo.com/promhippie/
[ghcr]: https://github.com/promhippie/dockerhub_exporter/pkgs/container/dockerhub_exporter
[dockerhub]: https://hub.docker.com/r/promhippie/dockerhub-exporter/tags/
[quayio]: https://quay.io/repository/promhippie/dockerhub-exporter?tab=tags
[docs]: https://promhippie.github.io/dockerhub_exporter/#getting-started
[nix]: https://nixos.org/
[golang]: http://golang.org/doc/install.html
[gotask]: https://taskfile.dev/installation/
[direnv]: https://direnv.net/
[devenv]: https://devenv.sh/