Prometheus Docker Hub Exporter

Exposes metrics of container pulls and stars from the Docker Hub API, to a Prometheus compatible endpoint.

Configuration

The image is setup to take two parameters from environment variables: BIND_PORT The port you wish to run the container on, defaults to 1234 IMAGES The images you wish to monitor, expected in the format "user/image1, user/image2". Can be across different dockerhub users.

Install and deploy

Run manually from Docker Hub:

docker run -d --restart=always -p 1234:1234 -e IMAGES="infinityworks/ranch-eye, infinityworks/prom-conf" infinityworks/docker-hub-exporter

Build a docker image:

docker build -t <image-name> .
docker run -d --restart=always -p 1234:1234 -e IMAGES="infinityworks/ranch-eye, infinityworks/prom-conf" <image-name>

Docker compose

docker-hub-exporter:
    tty: true
    stdin_open: true
    expose:
      - 1234:1234
    image: infinityworks/docker-hub-exporter

Metrics

Metrics will be made available on port 1234 by default

# HELP docker_hub_pull_count counter of docker_pulls from the public API
# TYPE docker_hub_pull_count counter
docker_hub_pull_count{image="prometheus",user="prom"} 5360660.0
docker_hub_pull_count{image="node-exporter",user="prom"} 9668841.0
# HELP docker_hub_star_count counter of docker_stars from the public API
# TYPE docker_hub_star_count counter
docker_hub_star_count{image="prometheus",user="prom"} 133.0
docker_hub_star_count{image="node-exporter",user="prom"} 16.0

Metadata