Prometheus exporter for the Docker Hub
Clone or download
Rucknar Merge pull request #9 from Danielv123/master
Added grafana dashboard JSON
Latest commit 5ce9e25 Nov 13, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmd/exporter Fixed URL Jul 10, 2017
.gitignore Add .idea folder to gitignore May 30, 2017
Dockerfile Fixed URL Jul 10, 2017
LICENSE intial commit Sep 8, 2016 Updated and May 22, 2017 Update May 30, 2017
exporter.go Remove usage of channels for blocking and rely solely on WaitGroups May 30, 2017
grafana-dashboard.json Added grafana dashboard JSON Mar 17, 2018

Prometheus Docker Hub Exporter

Exposes metrics of container pulls and stars from the Docker Hub API, to a Prometheus compatible endpoint. The exporter is capable of pulling down stats for individual images, or for orgs or users from DockerHub. This is based on the un-documented V2 Docker Hub API.


The image is setup to take parameters from environment variables or flags:

The available environment variables are:

  • BIND_PORT The port you wish to run the container on, defaults to 9170
  • ORGS The docker hub organizations you wish to monitor, expected in the format "org1, org2" (Also works for users)
  • IMAGES The images you wish to monitor, expected in the format "user/image1, user/image2". Can be across different dockerhub users.

Below is a list of the available flags. You can also find this list by using the --help flag.

  • images Images you wish to monitor: expected format 'user/image1,user/image2'
  • listen-address Address on which to expose metrics and web interface. (default ":9170")
  • organisations Organisations/Users you wish to monitor: expected format 'org1,org2'
  • telemetry-path Path under which to expose metrics. (default "/metrics")

Install and deploy

Run manually from Docker Hub:

docker run -d --restart=always -p 9170:9170 infinityworks/docker-hub-exporter -listen-address=:9170 -images="infinityworks/ranch-eye,infinityworks/prom-conf" -organisations="super6awspoc"

Build a docker image:

docker build -t <image-name> .
docker run -d --restart=always -p 9170:9170 <image-name> -listen-address=:9170 -images="infinityworks/ranch-eye,infinityworks/prom-conf" -organisations="super6awspoc"

Known Issues

Currently there is a known issue with this build where if you provide a image or list of images belonging to an organisation that has also been passed into the application then Prometheus will error during metrics gathering reporting that the metric was already collected with the same name and labels.


Metrics will be made available on port 8080 by default An example of these metrics can be found in the markdown file in the root of this repository